vedetta-mcp
# [vedetta-mcp](https://vedetta.dethboy.com)
[](https://smithery.ai/servers/lacryptorina/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.
**Live wire prices (authoritative — unpaid 402 / free GET, 2026-11-18):** FREE tools (`200 OK`, IP rate-limited): `route`, `track-record`, `korra-calls`, `korra-news`, `korra-lean`. Paid funnel `feed` / `snapshot` / `history` at **$0.01** (`maxAmountRequired=10000`); screener **$0.03** (`30000`); live desk **$0.09** (`90000`). 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 **23** 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):
```bash
npx -y vedetta-mcp@latest
```
Claude Code:
```bash
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`):
```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**):
```bash
curl -sS "https://vedetta.dethboy.com/v1/route?task=btc+sentiment"
curl -sS "https://vedetta.dethboy.com/v1/track-record?asset=BTC"
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.01 → `vedetta_history` ($0.01) / `vedetta_screener` ($0.03) → live `vedetta_consensus` / `vedetta_ask` ($0.09).
## Price table
Live unpaid **402** `maxAmountRequired` is authoritative for paid routes (atomic USDC, 6 decimals). Server refuses any offer above the listed cap. Free tools never pay.
| Tool | What it does | Price | Latency |
|---|---|---|---|
| `vedetta_route` | Task → endpoint router | **FREE** | instant |
| `vedetta_track-record` | Verifiable call log | **FREE** | instant |
| `vedetta_korra-calls` | Korra open/resolved calls (open_calls redacted) | **FREE** | instant |
| `vedetta_korra-news` | Korra scored news | **FREE** | instant |
| `vedetta_korra-lean` | Korra lean gauges (non-FEAR_GREED teaser) | **FREE** | instant |
| `vedetta_feed` | Desk post stream | $0.01 | instant |
| `vedetta_snapshot` | Cached signal + staleness | $0.01 | instant |
| `vedetta_history` | Signal time-series | $0.01 | instant |
| `vedetta_screener` | Cross-asset divergence scan | $0.03 | instant |
| `vedetta_ask` | Live analyst answer | $0.09 | 10–180 s |
| `vedetta_consensus` | Sentiment-vs-price verdict | $0.09 | 10–180 s |
| `vedetta_prediction` | Falsifiable claim + falsifier | $0.09 | 10–180 s |
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
## Publish (registry)
Dry-run (default — never publishes):
```bash
npm run publish:registry
# or: bash scripts/publish_mcp_registry.sh
```
Live publish (Josef only):
```bash
bash scripts/publish_mcp_registry.sh --execute
```
## Environment variables
| Variable | Required | Default | Purpose |
|---|---|---|---|
| `EVM_PRIVATE_KEY` | no | — | Hex private key for Base USDC x402 on **paid** tools |
| `VEDETTA_API_URL` | no | `https://vedetta.dethboy.com` | API base override |
| `VEDETTA_MAX_PRICE_USD` | no | per-route cap | Global price-cap override in USD |
## License
MIT
TDQS
Scored across 23 tools
The descriptions aggressively disambiguate with explicit negative cross-references (e.g. consensus vs equity vs macro, snapshot vs history vs screener, narrative vs social vs pulse), so an agent has strong guidance for most choices. Still, the set contains many near-siblings built on the same sentiment×price signal (consensus/equity/macro, house-view, snapshot, screener) and cached-vs-live pairs that differ only by price/freshness, so misfires remain plausible.
All 23 tools share a stable `vedetta_` prefix plus a lowercase kebab-case suffix (news-read, house-view, track-record, korra-lean), which is predictable and readable. The suffixes are noun/descriptive rather than verb_noun, and the korra-* group introduces a second grouping convention, but nothing is chaotic.
23 tools is at the heavy end and includes several near-duplicates distinguished mainly by caching tier and price ($0.01 snapshot/history/feed vs $0.09 live desks). Each has a rationale, but the surface feels like a catalog of endpoints rather than a tightly scoped toolset.
Coverage is broad: crypto, equities, macro, news, social, narrative, catalysts, prediction markets, history, audit trail, plus free routing and partner proxies — a full research lifecycle. The main gaps are discovery/utility operations: no tool to list supported assets/themes/endpoints or check pricing/quota, and no watchlist or alerting.