# Vedetta

> Vedetta is a freemium MCP server for finance and payments. Pay-per-call crypto, stock and macro sentiment reads with price divergence verdicts. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://vedetta.dethboy.com
- **Repository:** https://github.com/lacryptorina/vedetta-mcp
- **MCP Registry name:** com.dethboy/vedetta
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

Vedetta turns narrative commentary, social sentiment and prediction-market odds into structured signals: a bullish-percent score from 0 to 100, a stance, a divergence flag and a short narrative with sources. It then compares those reads with live price data to flag cases where the market and the story disagree, across crypto assets, US stocks and macro instruments. The vendor describes the output as descriptive research, not financial advice.

Payment is the authentication. Paid calls use the x402 protocol: an unpaid request gets a 402 offer, and the local server settles it in USDC on Base using a wallet key you supply through EVM_PRIVATE_KEY. The README advises a dedicated low-balance wallet, and says payment settles only on a successful answer. Without a key the server still starts, free tools work, and paid tools return the offer so you can see the cost first.

Prices are cached feeds and snapshots at $0.01, a screener at $0.03, and live analyst reads at a flat $0.09 that can take 10 to 180 seconds. The track record, routing and Korra tools are free.

## Features

- **Divergence verdicts:** Compares sentiment against live prices to flag disagreement.
- **Free track record:** A verifiable log of past calls costs nothing to read.
- **Price caps:** The server refuses offers above the listed per-route cap.
- **Live analyst reads:** Fresh answers to free-form questions for a flat $0.09.
- **Free by default:** Works without a wallet; paid tools show their 402 offer.

## Good for

- Check a cached sentiment snapshot for BTC before deciding on a paid read
- Scan across assets for sentiment and price divergence
- Audit past predictions against the logged track record
- Route a research task to the right Vedetta endpoint

## Install

### Claude Code (Terminal)

```sh
claude mcp add vedetta --env EVM_PRIVATE_KEY='<EVM_PRIVATE_KEY>' -- npx -y vedetta-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "vedetta": {
      "command": "npx",
      "args": [
        "-y",
        "vedetta-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "vedetta": {
      "command": "npx",
      "args": [
        "-y",
        "vedetta-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "vedetta": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "vedetta-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "vedetta": {
      "command": "npx",
      "args": [
        "-y",
        "vedetta-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "vedetta": {
      "command": "npx",
      "args": [
        "-y",
        "vedetta-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `vedetta_feed`: Desk post stream ($0.01).
- `vedetta_route`: Task to endpoint router (free).
- `vedetta_korra-calls`: Korra open and resolved calls (free).
- `vedetta_korra-news`: Korra scored news (free).
- `vedetta_korra-lean`: Korra lean gauges (free).
- `vedetta_snapshot`: Cached signal with staleness ($0.01).
- `vedetta_track-record`: Verifiable call log (free).
- `vedetta_history`: Signal time series ($0.01).
- `vedetta_screener`: Cross-asset divergence scan ($0.03).
- `vedetta_ask`: Live analyst answer ($0.09).
- `vedetta_consensus`: Sentiment-versus-price verdict ($0.09).
- `vedetta_prediction`: Falsifiable claim with its falsifier ($0.09).

## FAQ

### Do I need an account or API key?

No. Paid routes use x402 micropayments in USDC on Base; free tools need no wallet.

### What happens if a paid call fails?

The README says payment settles only on a successful answer, so a failed call costs nothing.

### Is this financial advice?

No. The vendor states it is descriptive market analysis only.

### What does a live read cost?

$0.09 flat, with latency of 10 to 180 seconds.

### Is Vedetta free?

Vedetta has a free plan, with paid plans for more usage or features.

### How do I add Vedetta to Claude Code?

Run this command in your terminal: claude mcp add vedetta --env EVM_PRIVATE_KEY='<EVM_PRIVATE_KEY>' -- npx -y vedetta-mcp

### What are the best alternatives to Vedetta?

The closest alternatives to Vedetta are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/vedetta
