Vedetta MCP Server

vedetta-mcp

Pay-per-call market intelligence for MCP clients (Claude, Cursor, Gemini CLI, Cline, and others).

Vedetta sells crypto sentiment reads, sentiment-vs-price divergence verdicts, and live analyst answers over x402 — USDC on Base, one micropayment per paid request. No signup, no API key on paid routes: payment is authentication.

Product shape (gateway 2.14.0): FREE tools (200 OK, IP rate-limited): route, korra-calls, korra-news, korra-lean. Paid funnel feed/snapshot/track-record at $0.07; history $0.01, screener $0.03, live desk $0.09. Hosted /mcp (if used) stays Bearer-token gated.

This package is a stdio MCP server. You bring a dedicated low-balance wallet (EVM_PRIVATE_KEY) for paid tools. The server settles each micropayment locally. Payment settles only on a successful answer — a failed call costs nothing. Free tools never require a wallet. Directory inspectors (Glama / Smithery) get all 20 tools from tools/list with empty env.

Descriptive market analysis only — not financial advice.

Site: https://vedetta.dethboy.com · OpenAPI: https://vedetta.dethboy.com/openapi.json · Agent card: https://vedetta.dethboy.com/vedetta.md

Install

Node 20+. Wallet needs USDC on Base only for paid tools. A few dollars covers hundreds of calls.

One-liner (no wallet — free funnel works; paid tools return the 402 offer):

npx -y vedetta-mcp@latest

Claude Code:

claude mcp add vedetta -e EVM_PRIVATE_KEY=0xYOUR_KEY -- npx -y vedetta-mcp@latest

Claude Desktop / Cursor (claude_desktop_config.json or ~/.cursor/mcp.json):

{
  "mcpServers": {
    "vedetta": {
      "command": "npx",
      "args": ["-y", "vedetta-mcp@latest"],
      "env": { "EVM_PRIVATE_KEY": "0xYOUR_KEY" }
    }
  }
}

Gemini CLI: clone/install this repo as an extension (gemini-extension.json). Cline Marketplace: see llms-install.md. Cursor plugin: .cursor-plugin/plugin.json + mcp.json.

Without EVM_PRIVATE_KEY the server still starts — free tools work; paid tools return the live 402 offer so you can inspect cost before funding a wallet. The key never leaves your machine.

Worked example

Start free: audit + cache check, then decide whether a paid live read is worth it.

vedetta_track-record
  asset: BTC

vedetta_snapshot
  asset: BTC

Same over HTTP (free funnel returns 200):

curl -sS "https://vedetta.dethboy.com/v1/route?task=btc+sentiment"
curl -sS "https://vedetta.dethboy.com/v1/korra/calls?asset=BTC"
curl -sS "https://vedetta.dethboy.com/v1/korra/news?asset=BTC"
curl -sS "https://vedetta.dethboy.com/v1/korra/lean?asset=BTC"

Cheapest paid path: funnel vedetta_snapshot/$0.07 → vedetta_history ($0.01) / vedetta_screener ($0.03) → live vedetta_consensus / vedetta_ask ($0.09).

Price table

Live 402 offer is authoritative for paid routes. Server refuses any offer above the listed cap. Free tools never pay.

Other live desks (equity, macro, pulse, theme, trend, news-read, house-view, event, odds, social, narrative) are $0.09. Full catalog: https://vedetta.dethboy.com/registry.json

Environment variables

License

MIT