# mcp

An MCP server for the Elfa API: crypto and equity events, positions and rankings, social data from X and Telegram, plus the Auto condition engine. Useful when your agent needs market facts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: elfa-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/elfa-ai/mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/elfa-ai-mcp

## What it does

The server exposes 16 tools mapped to the documented `/v2` and `/v3` operations. `events`, `market` and `calls` cover what is moving, where attention sits and which positions accounts are taking. `mentions`, `trending` and `narratives` pull social data from X and Telegram. Auto is the other half: `auto_build` turns a plain-language monitoring request into an EQL query, `auto_validate` checks the syntax and estimates cost, and `auto_query_write` activates it so it fires on its own once your conditions hold.

Two ways to run it. Hosted: add `https://mcp.elfa.ai/mcp` as a remote MCP server and approve the sign-in in your browser with a `dev.elfa.ai` account, no key to copy. Local: grab an API key from `dev.elfa.ai` and let `npx` fetch the package on demand. In Claude the command is `claude mcp add elfa --env ELFA_API_KEY=your-key -- npx -y @elfa-ai/mcp`.

Default timeout is `120000` ms and retries are off. That is deliberate. The interpretation endpoints are LLM-backed, can run past a minute, and bill credits per attempt, so a silent retry would charge you twice for a call you never saw. Only raise `ELFA_RETRIES` when you are hitting the cheap measurement endpoints. Note that some MCP clients impose their own timeout near 60 seconds; `narratives` and `market_chat` can run past it, and the request still finishes and still costs you even if the client gave up first.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ELFA_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp -e ELFA_API_KEY=<ELFA_API_KEY> -- npx -y @elfa-ai/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add elfa-ai-mcp --env ELFA_API_KEY=<ELFA_API_KEY> -- npx -y @elfa-ai/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "elfa-ai-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@elfa-ai/mcp"
            ],
            "env": {
                "ELFA_API_KEY": "<ELFA_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "elfa-ai-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@elfa-ai/mcp"
            ],
            "env": {
                "ELFA_API_KEY": "<ELFA_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ELFA_API_KEY=<ELFA_API_KEY> elfa-ai-mcp npx -y @elfa-ai/mcp
```
Replace <…> with your own values

## When to use it
- see what is gaining attention in crypto right now
- check which positions X accounts are opening
- pull market narratives with source links
- set up market monitoring from a plain-language condition
- check credit usage and how far back history goes

## Example prompts
- What's trending in crypto right now?
- Show me open longs and shorts on this asset
- Summarize market narratives from the last few days

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44583
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5458
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2814
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2188
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12109
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2760
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1348
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md