Skip to content
MCP server

MCP

Crypto and equity market intelligence from X and Telegram via the Elfa API

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally
Version
4.11.0
Listing updated
3 days ago

About MCP

MCP is a freemium MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • ELFA_API_KEYElfa API key from https://dev.elfa.aiRequired

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Freemium, from $870 a month

Free keys get 1,000 credits in total; pay-as-you-go at $0.0145 per credit; Grow $870/mo; Enterprise custom

Prices change. Check docs.elfa.ai before you buy.

MCP 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 to MCP

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments