@scienter/mcp (hosted API)

Two MCP packages exist and they are not interchangeable. This page is @scienter/mcp, the package that talks to the hosted API at scienter.xyz with an sc_ key. @scienter/mcp-server is the self-hosted server that talks to your own running Scienter instance with its own key file. A key for one does nothing on the other.

What it is

Eight read-only questions about a blockchain address, answered over HTTPS by the Scienter API, exposed to any MCP client. No Python, no repository checkout, no local service, one runtime dependency. Every answer arrives with its state attached, and the tools render a non-answer more loudly than an answer, so a model cannot quietly substitute a prior for a check that never ran.

Connect the hosted server (no install)

The same eight tools are served at https://scienter.xyz/mcp (streamable HTTP). You paste a key; nothing is installed. Get a free key (50 lookups) at scienter.xyz/mcp, or a plan key at scienter.xyz/settings/api. Claude Code

claude mcp add --transport http scienter https://scienter.xyz/mcp --header "Authorization: Bearer sc_YOUR_KEY"

Cursor (.cursor/mcp.json)

{ "mcpServers": { "scienter": { "url": "https://scienter.xyz/mcp", "headers": { "Authorization": "Bearer sc_YOUR_KEY" } } } }

Claude Desktop (claude_desktop_config.json, through the mcp-remote bridge, which needs Node)

{ "mcpServers": { "scienter": { "command": "npx", "args": ["-y", "mcp-remote", "https://scienter.xyz/mcp", "--header", "Authorization:Bearer sc_YOUR_KEY"] } } }

Claude.ai and ChatGPT connectors need OAuth sign-in, which is not built yet.

Limits

Key	Per minute	Per day	Notes
Free starter key	10	50 lookups in total	One per inbox; lapses after about 35 days.
Scienter for AI agents ($29/month)	20	300	API and MCP only; no web product.
Analyst ($500/month)	60	1,000	The full web product as well.
Desk, Enterprise	300 / 3,000	No daily cap

A request carries at most three tool calls, run one after another. A limit reached is an HTTP 429 with Retry-After; nothing is checked and nothing is charged.

Install

The package is built and tested but not yet on the npm registry, so there is no install line to paste today. This page carries the client config the day it is published; scienter.xyz/mcp shows the publication status.

Activate a plan at scienter.xyz/pricing and create a key at scienter.xyz/settings/api. Keys are prefixed sc_, shown once, and expire after 90 days.
Until the package is published, the same eight answers are one request away over the hosted API, with the same key:

curl -H "Authorization: Bearer sc_YOUR_KEY" \
  https://scienter.xyz/api/v1/wallet/0x28C6c06298d514Db089934071355E5743bf21d60/ofac

Once published, the server is added to claude_desktop_config.json for Claude Desktop, .mcp.json for Claude Code, and .cursor/mcp.json for Cursor, with SCIENTER_API_KEY in its env block.

The eight tools

Tool	Answers
`wallet_score`	Chain facts, the published exchange label, the engine’s entity cluster, itemised findings with citations. Never a number: there is no calibrated wallet-risk model. `findings_checked` says whether an empty list was earned.
`ofac_check`	Direct match against the published OFAC SDN list, and the engine’s two-hop proximity walk over real transfer history. Two claims, reported separately; a proximity match is a fact about the graph, never a designation.
`bridge_trace`	Transfers that touched a bridge contract on the seven-protocol registry, with destination chain, amount and hash. An empty list is a bounded negative about the registry, not about the funds.
`cex_attribution`	Whether the address is a labelled exchange wallet, which cluster members are, and the address’s own deposits to labelled exchange wallets, with provenance.
`receipts_lookup`	The published forensic reconstructions covering an address or a query, with a URL a human can open.
`leaderboard_query`	The flagged-wallet wall for the last 24 hours. An empty wall says which empty it is: a quiet day, a table no scorer has ever written, or an unconfirmed read.
`solana_deployer`	What the wallet that deployed a Solana token did before: settled launches, how many died, whether every one did. Three outcomes, and `no record` is the answer for most of the chain — a statement about coverage, never a clean record. A negative screen, never a reason to buy.
`solana_token`	Who created a Solana token, and what that wallet’s earlier launches did. Takes the mint, which is what a caller actually holds, and resolves it to the deployer.

What it will never do

Render an unreachable upstream as an empty result.
Say “not sanctioned”. A searched miss is a finding about one list on one date.
Restate “two hops from a listed address” as “sanctioned”, or “no registry bridge touched” as “never bridged”.
Fall back to a cache, a default, or a prior. A failure produces an error a human can act on and nothing that resembles data.

Errors you may see

Message starts with	Meaning	Fix
`No Scienter API key is configured`	`SCIENTER_API_KEY` is unset in the server’s environment.	Add it to the `env` block and restart the client.
`The Scienter API rejected this key with HTTP 402`	Unknown, expired, revoked, or on a plan without API access. The API’s own reason is quoted.	Create a fresh key at scienter.xyz/settings/api.
`The Scienter API rate limit was hit (HTTP 429)`	The key’s per-minute limit or daily quota is spent. The minute resets in under 60 seconds, the day at midnight UTC.	Wait, or move to a larger plan.
`Could not reach the Scienter API`	Network, or `SCIENTER_API_URL` points somewhere wrong.	Check both. Nothing was checked.

Scienter analyses public blockchain records. A finding states what those records show and how confident we are; it is evidence, not proof of anyone’s identity, intent or wrongdoing, and an attribution we cite is the cited source’s. An empty result means not analysed, never safe. Nothing here is legal, tax or investment advice, or a recommendation to transact with any address or asset — see Disclaimers for the full text.

​What it is

​Connect the hosted server (no install)

​Limits

​Install

​The eight tools

​What it will never do

​Errors you may see

What it is

Connect the hosted server (no install)

Limits

Install

The eight tools

What it will never do

Errors you may see