API-getActivityById
Retrieve specific activity data by ID using the RSS3 MCP Server, enabling queries across decentralized chains, social media, and the RSS3 network.
Instructions
Retrieve Activity by ID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- index.js:150-223 (handler)This is the execution handler for CallToolRequestSchema, which handles calls to all dynamically generated API tools, including "API-getActivityById". It matches the tool name to an OpenAPI operation using openApiLookup and executes it via the client's executeOperation method, returning the JSON response.server.setRequestHandler(CallToolRequestSchema, async (request) => { // console.error("call tool", request.params); const { name, arguments: params } = request.params; console.error("name", name); if (name === "API-get-input-schema") { for (const mcpToolWithClient of mcpToolWithClients) { for (const [toolName, def] of Object.entries( mcpToolWithClient.mcpTools.tools, )) { for (const method of def.methods) { const toolNameWithMethod = `${toolName}-${method.name}`; const truncatedToolName = toolNameWithMethod.slice(0, 64); if (truncatedToolName === params.toolName) { return { content: [ { type: "text", text: JSON.stringify(method.inputSchema) }, ], }; } } } } throw new Error(`Method ${params.toolName} not found`); } // find operation const mcpToolWithClient = mcpToolWithClients.find( (t) => t.mcpTools.openApiLookup[name], ); if (!mcpToolWithClient) { throw new Error(`Method ${name} not found`); } const operation = mcpToolWithClient.mcpTools.openApiLookup[name]; // execute try { const response = await mcpToolWithClient.client.executeOperation( operation, params, ); return { content: [ { type: "text", // currently this is the only type that seems to be used by mcp server text: JSON.stringify(response.data), // TODO: pass through the http status code text? }, ], }; } catch (error) { console.error("Error in tool call", error); if (error instanceof HttpClientError) { console.error( "HttpClientError encountered, returning structured error", error, ); const data = error.data?.response?.data ?? error.data ?? {}; return { content: [ { type: "text", text: JSON.stringify({ status: "error", // TODO: get this from http status code? ...(typeof data === "object" ? data : { data: data }), }), }, ], }; } throw error; } });
- index.js:100-147 (registration)This handler for ListToolsRequestSchema dynamically generates the list of available tools by iterating over OpenAPI-derived MCP tools, constructing tool names as `${toolName}-${method.name}` (truncated), which includes "API-getActivityById" if present in the spec.server.setRequestHandler(ListToolsRequestSchema, async () => { console.error("list tools"); /** * @typedef {import("@modelcontextprotocol/sdk/types.js").Tool} Tool * @type {Tool[]} */ const tools = []; for (const mcpToolWithClient of mcpToolWithClients) { for (const [toolName, def] of Object.entries( mcpToolWithClient.mcpTools.tools, )) { for (const method of def.methods) { console.error("method", method); const toolNameWithMethod = `${toolName}-${method.name}`; const truncatedToolName = toolNameWithMethod.slice(0, 64); const trimmedDescription = method.description.split("Error")[0].trim(); tools.push({ name: truncatedToolName, description: trimmedDescription, inputSchema: { type: "object", properties: {}, }, }); } } } tools.unshift({ name: "API-get-input-schema", description: "Get the input schema for a given API. We should always use this tool to get the input schema for a given API before calling the API.", inputSchema: { type: "object", properties: { toolName: { type: "string", description: "The name of the tool to get the input schema for", }, }, }, }); console.error("tools", tools); return { tools }; });
- index.js:156-175 (schema)Specialized handler within the main tool caller that retrieves and returns the input schema for any listed API tool, such as "API-getActivityById", by matching the toolName and returning method.inputSchema as JSON.if (name === "API-get-input-schema") { for (const mcpToolWithClient of mcpToolWithClients) { for (const [toolName, def] of Object.entries( mcpToolWithClient.mcpTools.tools, )) { for (const method of def.methods) { const toolNameWithMethod = `${toolName}-${method.name}`; const truncatedToolName = toolNameWithMethod.slice(0, 64); if (truncatedToolName === params.toolName) { return { content: [ { type: "text", text: JSON.stringify(method.inputSchema) }, ], }; } } } } throw new Error(`Method ${params.toolName} not found`); }
- index.js:71-84 (helper)Creates MCP tool definitions and associated HTTP clients from OpenAPI specifications fetched from RSS3 endpoints. This provides the openApiLookup and tools.tools used for resolving and executing "API-getActivityById".const converterWithClients = openApiSpecs.map((o) => { const converter = new OpenAPIToMCPConverter(o.spec); return { converter, client: o.client, }; }); const mcpToolWithClients = converterWithClients.map((cwc) => { const mcpTools = cwc.converter.convertToMCPTools(); return { mcpTools, client: cwc.client, }; });