MCP server for the E3D.ai API — blockchain analytics and AI agent platform
Server has 23 tools with consistent naming (verb_noun pattern) and reasonable descriptions (avg ~150 chars). All tools have Zod schemas with type constraints and enums where appropriate. However, parameter descriptions are sparse or missing for many tools (e.g., 'dataSource' lacks explanation of what ID 1 means beyond 'mainnet'). Output schemas are not documented, LLMs cannot predict response structure. Error handling is minimal (generic E3D API errors with no recovery guidance). Two write tools (claim_token, update_token_claim) lack confirmation patterns despite irreversible consequences. No tool annotations (readOnlyHint/destructiveHint) despite clear read/write distinction.
Claim a token in the E3D registry. Requires: token address, proof method (owner_call or deployer), bearer token (sessionToken from entitlements/verify), and feeTxHash (tx hash of a confirmed claim-fee payment). Optionally set website, description, contact, and socials.
Get counterparty analysis for a wallet address — wallets it most frequently interacts with.
Get identity and metadata for an Ethereum address (token or wallet). Returns labels, tags, entity name, and known associations.
Get artifacts (on-chain stories, theses, signals) generated by an E3D agent for a token.
Get E3D burn history for an agent: when E3D was spent, how much, and what for (analysis, signal checks, etc.).
Get E3D agent's top-scored token candidates — tokens with converging on-chain signals across multiple story types. Joined with thesis when one exists. Fields include convergence_score, signal_count, story_types, direction_hint, signal_summary, thesis_conviction, entry/invalidation signals, price targets, fraud_risk, liquidity_quality.
Output schemas not documented. LLMs cannot predict response structure (fields, types, nesting). Responses are raw JSON dumps without field descriptions.
Parameter descriptions incomplete or missing. 'dataSource' appears in 10+ tools with no explanation of valid values or what ID 1 means. 'search' parameter lacks format guidance (substring? regex? exact match?).
Write tools (claim_token, update_token_claim) lack confirmation/dry-run pattern. Claiming a token is irreversible but no confirmation step exists. Agents could accidentally claim wrong tokens.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
Get detailed info for a specific E3D agent: token address, status, E3D balance, activation time, last activity, and metadata.
Get funding info for an E3D agent: E3D balance, funding history, and burn rate.
Get the next actions an E3D agent is planning for a token: upcoming analysis, signal checks, or thesis updates.
List E3D AI agents. Each ERC-20 token can have an activated AI agent. Returns agent status (running/dormant/hibernating/failed), E3D balance, and metadata.
Get the claim status and metadata for a token in the E3D registry. Returns: claimed (bool), owner, website, description, contact, socials, and claim metadata.
List all claimed tokens in the E3D registry. Returns token addresses, owners, and claim metadata.
Get structured investment theses generated by the E3D agent. Each thesis includes: direction (long/short), conviction score, thesis text, entry/invalidation signals, price targets (target_1/2/3), invalidation_price, fraud_risk, liquidity_quality, slippage estimate, and time horizon. Filter by status: active, confirmed, or all.
Get the most frequent counterparty wallets for a token — who is trading with whom.
Get detailed token profile: supply, holders, contract info, social links, price history, and E3D-computed risk/quality scores.
Get rich token info JSON including on-chain data, price history, holders, contract metadata, social links, and E3D-computed scores for a token.
Fetch ERC-20 token prices with multi-range history. Sort by 30m, 1h, 24h, 7d, or 30d price change to find gainers/losers. Returns price, market cap, volume, and change % across all time ranges.
Query the E3D token database. Returns token metadata: name, symbol, address, market cap, liquidity, and fraud risk score. Use for discovery or symbol lookup.
Fetch recent Ethereum transactions indexed by E3D. Optionally filter by token address, wallet address, or text search.
Get all token claims made by a wallet. Requires a bearer token (sessionToken from entitlements/verify or long-lived e3d_claim_... apiKey from a successful claim).
Search E3D on-chain stories by keyword, token symbol, or address. Stories are LLM-generated narratives derived from transaction graph patterns.
Search transactions by address or token. Returns transaction details: from, to, value, token, timestamp, and E3D-computed labels.
Update metadata for a claimed token: website, description, contact, and socials. Requires a bearer token (sessionToken or long-lived e3d_claim_... apiKey).
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). 21 read-only tools and 2 write tools are unmarked. LLMs cannot distinguish safe from risky operations without explicit hints.
Error handling is generic. apiRequest() throws 'E3D API {status}: {json}' with no recovery guidance. LLMs cannot determine if errors are retryable, user-fixable, or fatal.