Social text is untrusted
Mentions, news and narratives return third-party posts that anyone can write. Every response is marked untrusted, but review any chain where an agent reads that content and can then reach auto_query_write.
MCP Server
The MCP server exposes the v2 API as tools for chat clients that cannot run commands. No integration code required. If your agent already has a shell, the Agent Skill is the better surface — it costs no context until it is used.
Install
Get a key from dev.elfa.ai, then pick a client.
Claude Code
claude mcp add elfa --env ELFA_API_KEY=your-key -- npx -y @elfa-ai/mcp
Claude Desktop — download the .mcpb from the latest release and open it.
Everything else — npx -y @elfa-ai/mcp with ELFA_API_KEY in the environment. VS Code uses servers where Cursor uses mcpServers.
| Variable | Required | Purpose |
|---|---|---|
ELFA_API_KEY | Yes | Authenticates every request. |
ELFA_TIMEOUT | No | Defaults to 120000. |
ELFA_RETRIES | No | Defaults to 0. |
ELFA_MCP_MAX_RESPONSE_CHARS | No | Response size ceiling. Defaults to 60000. |
ELFA_EXTRA_HEADERS | No | JSON object of extra headers sent upstream, for proxies and non-production environments. |
Retries are off on purpose
The interpretation endpoints are LLM-backed, can take over a minute, and charge credits per attempt. A silent retry bills you again for a call you never saw.
Tools
Clients prefix tool names with the server name, so these appear as elfa_mentions and so on.
| Tool | Credits | What it does |
|---|---|---|
api_status | Free | Key tier, credit usage, remaining requests. |
mentions | 1 | Mentions from X and Telegram. Top, search or news. |
trending | 1 | Trending tokens, or contract addresses. |
narratives | 5 | Narrative analysis with source links. |
account_stats | 1 | Smart follower and engagement stats. Legacy: it still works, but will be removed on 28 October 2026. |
market_chat | Varies | Written market analysis. |
auto_build auto_validate auto_query | 1 / Free / Free | Build EQL, cost it or check a symbol, poll it. |
auto_query_write auto_draft | 5 / Free | Activate and park Auto plans. |
Streaming endpoints are not tools — a tool call returns a single result. Poll auto_query, or use an SDK for SSE.
Auto
An armed query keeps evaluating and fires without asking again, so it is three deliberate steps: auto_build to draft, auto_validate to cost it, auto_query_write to arm it. Show the user the cost and the action before the third.
Next Step
Read Auto for what the condition engine can watch, or Market Intelligence for what each data tool returns. Source and issues live in elfa-ai/mcp.