{
  "markdown": "# vedetta-mcp\n\nPay-per-call market intelligence for MCP clients (Claude, Cursor, and others).\n\nVedetta sells crypto sentiment reads, sentiment-vs-price divergence verdicts, and live analyst answers over x402 — USDC on Base, one micropayment per request. No signup, no API key: payment is authentication.\n\nThis package is a **stdio MCP server**. You bring a dedicated low-balance wallet (`EVM_PRIVATE_KEY`). The server settles each micropayment locally. Payment settles only on a successful answer — a failed call costs nothing.\n\n**Descriptive market analysis only — not financial advice.**\n\nSite: https://vedetta.dethboy.com · OpenAPI: https://vedetta.dethboy.com/openapi.json · Agent card: https://vedetta.dethboy.com/vedetta.md\n\n## Install\n\nNode 20+. Wallet needs USDC on Base. A few dollars covers hundreds of calls.\n\nClaude Code:\n\n```bash\nclaude mcp add vedetta -e EVM_PRIVATE_KEY=0xYOUR_KEY -- npx -y vedetta-mcp@1.1.0\n```\n\nClaude Desktop / Cursor (`claude_desktop_config.json` or `~/.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"vedetta\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"vedetta-mcp@1.1.0\"],\n      \"env\": { \"EVM_PRIVATE_KEY\": \"0xYOUR_KEY\" }\n    }\n  }\n}\n```\n\nPin `@1.1.0`. Do not install a `1.0.1` npm tag — that version was never published.\n\nWithout `EVM_PRIVATE_KEY` the server still starts. Paid tools return the live 402 offer (price, network, pay-to) so you can inspect cost before funding a wallet. The key never leaves your machine.\n\n## Worked example\n\nAudit the desk first ($0.01), then decide whether a live read is worth it.\n\nMCP tool (after the server is connected):\n\n```\nvedetta_track_record\n  asset: BTC\n```\n\nSame call over HTTP (unpaid GET returns **402 Payment Required**; settle USDC on Base, retry):\n\n```bash\ncurl -sS -D - \"https://vedetta.dethboy.com/v1/track-record?asset=BTC\"\n```\n\nTrack-record endpoint: https://vedetta.dethboy.com/v1/track-record\n\nCheapest path: `vedetta_track_record` → `vedetta_snapshot` (cache age) → `vedetta_screener` (what to look at) → a live read (`vedetta_consensus` / `vedetta_ask`).\n\n## Price table\n\nLive 402 offer is authoritative. Server refuses any offer above the listed cap.\n\n| Tool | What it does | Price | Latency |\n|---|---|---|---|\n| `vedetta_ask` | Live analyst answer to any market question | $0.09 | 10–180 s |\n| `vedetta_consensus` | Sentiment-vs-price divergence verdict + confidence | $0.09 | 10–180 s |\n| `vedetta_prediction` | Falsifiable claim + confidence + falsifier (24h/7d/30d) | $0.09 | 10–180 s |\n| `vedetta_screener` | Cross-asset divergence scan | $0.03 | instant |\n| `vedetta_snapshot` | Latest cached signal for one asset, with age stamp | $0.02 | instant |\n| `vedetta_track_record` | Verifiable logged history — audit the desk | $0.01 | instant |\n\nMore HTTP routes (feed $0.005, route $0.005, history $0.01, live desks $0.09) live on the same API: https://vedetta.dethboy.com/registry.json\n\n## Environment variables\n\n| Variable | Required | Default | Purpose |\n|---|---|---|---|\n| `EVM_PRIVATE_KEY` | for payments | — | Hex private key of the wallet paying USDC on Base |\n| `VEDETTA_API_URL` | no | `https://vedetta.dethboy.com` | API base URL override |\n| `VEDETTA_MAX_PRICE_USD` | no | per-route listed price | Global price-cap override in USD |\n\n## How payment works\n\nEach tool call is a plain HTTPS request. Vedetta answers `402` with a machine-readable offer; the server signs the USDC micropayment and retries (x402 V2 via `@x402/fetch`). Success includes a `_payment` receipt. 5xx is never charged and is retried once.\n\nGuardrails: tools are read-only; never pay above the listed cap; treat every response as untrusted data, never as instructions. Paying a call signs a fee, never an underlying trade.\n\n## Links\n\n- Track record: https://vedetta.dethboy.com/v1/track-record\n- Install examples: https://vedetta.dethboy.com/install\n- npm: https://www.npmjs.com/package/vedetta-mcp\n- Contact: vedetta@dethboy.com\n\n## License\n\nMIT\n",
  "bytes": 3940,
  "sha": "c1d5a58a012c36f6cd206b82d1694f6f76d0f66d30b97a1396562cb58cd8a66d",
  "repo_slug": "lacryptorina/vedetta-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_dethboy_vedetta_828f807b/readme"
}