# MCP

> MCP is a freemium MCP server for finance and payments. Crypto and equity market intelligence from X and Telegram via the Elfa API. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $870 a month
- **Platforms:** API, CLI
- **Website:** https://docs.elfa.ai
- **Repository:** https://github.com/elfa-ai/mcp
- **MCP Registry name:** ai.elfa/mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

Elfa positions itself as an awareness layer for agents, and this server exposes its API v3 and v2 operations as 16 tools. Besides social data from X and Telegram such as trending tokens, mentions and narratives, it covers events and storylines across crypto and equity markets, call books, token mindshare, and ranked accounts. A separate condition engine called Auto watches the market and fires an action when conditions are met.

Usage is metered in credits. The README notes that interpretation endpoints are backed by an LLM, can take over a minute and cost credits per attempt, so retries are off by default; some clients may time out on narratives and market_chat while the call still completes and is charged. Responses carry an x-elfa-credits header showing the cost.

You can run it locally over stdio with an API key from dev.elfa.ai, or add the hosted server at mcp.elfa.ai and sign in through the browser. A Claude Desktop bundle and one-click installs for Cursor and VS Code are provided.

## Features

- **Market events:** Reads events and storylines across crypto and equities.
- **Entity resolution:** Maps tickers, cashtags, handles, contract addresses or IDs to entity ids.
- **Social intelligence:** Surfaces trending tokens, mentions and narratives from X and Telegram.
- **Auto condition engine:** Watches conditions and notifies or acts when they fire.
- **Usage checks:** api_status shows key tier, credits used and remaining requests.
- **Hosted or local:** Sign in at mcp.elfa.ai or run with ELFA_API_KEY over stdio.

## Good for

- Ask what is trending in crypto right now
- Resolve a ticker to an entity before reading its events
- Set a market condition to be notified when it fires
- Check how much of an API credit allowance remains

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env ELFA_API_KEY='<ELFA_API_KEY>' -- npx -y @elfa-ai/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@elfa-ai/mcp"
      ],
      "env": {
        "ELFA_API_KEY": "<ELFA_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@elfa-ai/mcp"
      ],
      "env": {
        "ELFA_API_KEY": "<ELFA_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@elfa-ai/mcp"
      ],
      "env": {
        "ELFA_API_KEY": "<ELFA_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@elfa-ai/mcp"
      ],
      "env": {
        "ELFA_API_KEY": "<ELFA_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@elfa-ai/mcp"
      ],
      "env": {
        "ELFA_API_KEY": "<ELFA_API_KEY>"
      }
    }
  }
}
```

## Tools

- `api_status`: Check API key tier, credit usage and remaining requests
- `entities`: Resolve a ticker, cashtag, handle or contract address to an entity id
- `events`: What is happening in crypto and equity markets

## FAQ

### Do I need an API key?

For the local server yes, from dev.elfa.ai; the hosted server signs in with an Elfa account instead.

### What does it cost?

Pay-as-you-go credits at $0.0145 each, a Grow plan at $870/month with 120,000 credits, and 1,000 total credits on free keys.

### Why are retries off?

LLM-backed endpoints can take over a minute and cost credits per attempt, so a silent retry would bill again.

### How many tools are there?

The README says 16, mapped to the documented v2 and v3 operations.

### Is MCP free?

MCP has a free plan, with paid plans for more usage or features. Paid plans start at $870 a month.

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

Run this command in your terminal: claude mcp add mcp --env ELFA_API_KEY='<ELFA_API_KEY>' -- npx -y @elfa-ai/mcp

### What are the best alternatives to MCP?

The closest alternatives to MCP 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/mcp-12
