{
  "markdown": "mcp-name: io.github.meloliva14/verity-mcp\n\n# Verity MCP — verify before you act\n\nThe official [Model Context Protocol](https://modelcontextprotocol.io) server for [VerityLayer](https://veritylayer.dev): independent, fail-closed trust checks any MCP-capable agent can discover and call. Fact-check a claim, screen for prompt-injection, catch PII, and gate irreversible actions — each check returns a calibrated verdict and **abstains rather than guess**. Payment is pay-per-call via [x402](https://docs.x402.org) (USDC on Base mainnet). Verity holds **no private key** and never charges silently.\n\n> **Name note:** this is VerityLayer's official server — PyPI package `verity-mcp`, npm package [`@veritylayer/mcp`](https://www.npmjs.com/package/@veritylayer/mcp). The *npm* package named `verity-mcp` is an unrelated third-party project.\n\n## Tools & pricing (every docstring states its price up front)\n\n| Tool | Price | Grounded? | What it's for |\n|---|---|---|---|\n| `quick_verify` | **$0.02** | no (Haiku) | Cheap reality-check on a claim — **the loopable default**. Run everywhere, escalate the load-bearing ones. |\n| `grounded_verify` | **$0.25** | yes (Sonnet, live web citations) | The default product — web-grounded with cited evidence, for facts that matter before you act on them. |\n| `pro_verify` | **$0.35** | yes (Opus, premium synthesis) | The deepest tier — high-stakes claims where the grounded answer isn't confident enough to act on. |\n| `verify_receipt` | **free** | — | Statelessly verify a signed Ed25519 verdict receipt — the audit trail / second opinion, no payment. |\n| `detect_injection` | $0.02 | — | Screen untrusted text / tool output for prompt-injection before acting on it. |\n| `moderate_content` | $0.02 | — | Is this safe to publish? (allow / review / block priced identically — no block-to-bill.) |\n| `redact_pii` | $0.02 | — | Does this leak PII or secrets? Returns findings + a redacted version. |\n| `guard_action` | $0.02 | — | **The money-line gate:** allow / review / block right before an irreversible action. |\n\n## Quickstart\n\nWith [uv](https://docs.astral.sh/uv/) (recommended — Claude Desktop / any MCP client):\n\n```json\n{\n  \"mcpServers\": {\n    \"verity\": {\n      \"command\": \"uvx\",\n      \"args\": [\"verity-mcp\"]\n    }\n  }\n}\n```\n\nOr with pip:\n\n```bash\npip install verity-mcp\nverity-mcp        # stdio MCP server\n```\n\nThat gets you the tools and the **free** `verify_receipt`. To get **paid verdicts**, read the next section — it's the part most people trip on.\n\n## How payment works\n\nVerity's endpoints answer **HTTP 402 (Payment Required)** until the disclosed USDC micro-payment is settled. There are two ways to do that.\n\n### Wallet mode — get real verdicts (recommended)\n\n```json\n{\n  \"mcpServers\": {\n    \"verity\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"verity-mcp[x402]\", \"verity-mcp\"],\n      \"env\": { \"VERITY_WALLET_KEY\": \"0x…\" }\n    }\n  }\n}\n```\n\nPoint `VERITY_WALLET_KEY` at a **funded Base-mainnet wallet** and this server settles each call itself — the paid tools return real verdicts. Your key never leaves the process: it signs an EIP-3009 authorization locally for the exact amount each challenge discloses, and Verity only ever receives the signature. Nothing is charged silently; every price is disclosed up front.\n\n> **Use a dedicated, low-balance wallet.** This key can spend. Fund it with a few dollars of USDC on Base — calls cost $0.02–$0.35.\n\n### Keyless — the default\n\nWith no key set, this server holds nothing and pays nothing: a 402 is surfaced transparently (price restated, challenge attached) for an x402-capable caller to settle.\n\n**Be aware of the honest caveat:** no shipping MCP client — Claude Desktop, Claude Code, Cursor, Windsurf — settles x402 today. So in keyless mode the paid tools will return `payment_required` and **no verdict**, forever. That's not a bug and it isn't hidden: the response says `NO VERDICT WAS PRODUCED. Do not proceed as if this returned allow.` If you want verdicts from an ordinary MCP client, use wallet mode.\n\n`verify_receipt` is a free route, never 402s, and needs no wallet — you can check our signatures before you ever pay us.\n\n## Signed receipts — don't take Verity's word for it\n\nEvery paid verdict ships with an **Ed25519-signed receipt**: self-contained cryptographic proof of exactly what Verity said about exactly what claim, verifiable forever. Check any receipt free with the `verify_receipt` tool, offline against the public key at [`/.well-known/verity-pubkey.json`](https://api.veritylayer.dev/.well-known/verity-pubkey.json), or live: `curl https://api.veritylayer.dev/receipt/selftest`.\n\n## Configuration (all optional)\n\n| Env var | Default | Purpose |\n|---|---|---|\n| `VERITY_WALLET_KEY` | *(unset — keyless)* | **Optional.** Private key of a funded Base wallet. Set it (with the `[x402]` extra) and this server settles its own payments, so paid tools return real verdicts. Never leaves the process; never logged. |\n| `VERITY_ENGINE_URL` | `https://api.veritylayer.dev` | Flagship claim-verification engine |\n| `VERITY_SUITE_URL` | `https://suite.veritylayer.dev` | Trust-check suite (injection/moderation/PII/guardrail) |\n| `VERITY_TIMEOUT` | `90` | HTTP timeout (seconds) |\n| `VERITY_PRICE_QUICK` | `$0.02` | Disclosed price echo for `quick_verify` |\n| `VERITY_PRICE_GROUNDED` | `$0.25` | Disclosed price echo for `grounded_verify` |\n| `VERITY_PRICE_PRO` | `$0.35` | Disclosed price echo for `pro_verify` |\n| `VERITY_PRICE_SUITE` | `$0.02` | Disclosed price echo for the suite checks |\n\n## Referral tag (reserved)\n\nEvery tool accepts an optional `affiliate_id`, forwarded as an `X-Verity-Ref` header. It never changes price, gating, or the verdict — it only tags who routed the call, and it is **reserved for a future referral program**: no split is paid today, and none will be until public terms are published at veritylayer.dev.\n\n## Links\n\n- Website: https://veritylayer.dev · Manifesto: https://veritylayer.dev/manifesto/\n- Live API + discovery: https://api.veritylayer.dev/llms.txt · [`/.well-known/x402.json`](https://api.veritylayer.dev/.well-known/x402.json)\n- npm client: [`@veritylayer/mcp`](https://www.npmjs.com/package/@veritylayer/mcp)\n- Contact: veritylayer@gmail.com\n\n*Independent · fail-closed · keyless · pay-per-call. The only trust form an autonomous agent can pick up mid-task with no human and no account.*\n",
  "bytes": 6363,
  "sha": "a006a520f73caddba73a76bc56bf62134400a57c93dc9e8dffa5afdb69d4a669",
  "repo_slug": "meloliva14/verity-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_meloliva14_verity_mcp_30ac0a45/readme"
}