elfa_keyword_mentions
Read-only
Track multiple keyword mentions across crypto sources to analyze market sentiment and trending tokens within specified timeframes and chains.
Instructions
Multi-keyword mentions. Params: keywords (array|string), start, end, chain, limit, cursor, sources.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keywords | No | ||
| start | No | ||
| end | No | ||
| chain | No | ||
| limit | No | ||
| cursor | No | ||
| sources | No |
Implementation Reference
- mcp-server.js:212-222 (handler)MCP tool handler for 'elfa_keyword_mentions'. Parses arguments into query parameters and delegates to the generic 'elfa_query' tool handler to fetch from '/v2/data/keyword-mentions'.
"elfa_keyword_mentions": async (args, meta) => { const query = {}; if (args && args.keywords !== undefined) query.keywords = Array.isArray(args.keywords) ? args.keywords.join(",") : String(args.keywords); if (args && args.start !== undefined) query.start = args.start; if (args && args.end !== undefined) query.end = args.end; if (args && args.chain !== undefined) query.chain = args.chain; if (args && args.limit !== undefined) query.limit = args.limit; if (args && args.cursor !== undefined) query.cursor = args.cursor; if (args && args.sources !== undefined) query.sources = args.sources; return toolHandlers["elfa_query"]({ path: "/v2/data/keyword-mentions", method: "GET", query }, meta); }, - mcp-server.js:318-325 (schema)Tool schema definition for 'elfa_keyword_mentions', including input schema, description, and annotations. Used in tools/list response.
{ name:"elfa_keyword_mentions", description:"Multi-keyword mentions. Params: keywords (array|string), start, end, chain, limit, cursor, sources.", inputSchema:{ type:"object", properties:{ keywords:{type:"array", items:{type:"string"}}, start:{type:"string"}, end:{type:"string"}, chain:{type:"string"}, limit:{type:"number"}, cursor:{type:"string"}, sources:{type:"string"} }}, annotations:{ title:"ELFA: Keyword Mentions", readOnlyHint:true, openWorldHint:true } }, - services/elfa.js:65-88 (helper)Helper function 'elfaKeywordMentions' that wraps the ELFA API call to '/v2/data/keyword-mentions' using safeGet. Used in index.js debug endpoint, similar logic to MCP handler.
export const elfaKeywordMentions = async (opts) => { const { keywords, accountName, timeWindow = '7d', limit = 20, searchType = 'or', cursor = null, reposts = false } = opts; const params = { limit, searchType, reposts }; if (keywords) params.keywords = keywords; if (accountName) params.accountName = accountName; if ('from' in opts && 'to' in opts && opts.from != null && opts.to != null) { params.from = opts.from; params.to = opts.to; } else { params.timeWindow = timeWindow; } if (cursor) params.cursor = cursor; return safeGet('/v2/data/keyword-mentions', params); };