Nodit MCP Server

Instructions

Implementation Reference

• src/tools/data-apis.ts:11-47 (handler)

  The inline async handler function for the 'list_nodit_data_apis' tool. It processes the Nodit Data API OpenAPI spec to extract and list available POST operations with their operationId, description, path, and supported chains, formatting them into a text response.
  server.tool("list_nodit_data_apis", "Lists available Nodit Data API operations.", {}, async () => { const toolName = "list_nodit_data_apis"; try { const apiList = Object.entries(noditDataApiSpec.paths) .filter(([, pathItem]) => pathItem?.post?.operationId) .map(([pathKey, pathItem]) => { let supportedChains: string[] = []; if (pathItem?.post?.parameters) { const chainParam = pathItem.post.parameters.find((param: any) => param.name === 'chain'); if (chainParam?.schema?.enum) { supportedChains = chainParam.schema.enum; } } return { operationId: pathItem!.post!.operationId!, description: normalizeDescription(pathItem!.post!.description), path: pathKey, supportedChains: supportedChains }; }); const formattedList = apiList .map(api => ` - operationId: ${api.operationId}, supported chains: [${api.supportedChains.join(',')}], description: ${api.description}`) .join("\n"); const content = `Nodit Blockchain Context data api has endpoints with patterns like https://web3.nodit.io/v1/{chain}/{network}/getBlockByHashOrNumber. For example, Ethereum mainnet uses an endpoint like https://web3.nodit.io/v1/ethereum/mainnet/getBlockByHashOrNumber. The API list is as follows. You can use the get_nodit_api_spec tool to get more detailed API specifications. - baseUrl: ${noditDataApiSpec.servers[0].url} - Available Nodit API Operations: ${formattedList} ` return { content: [{ type: "text", text: content }] }; } catch (error) { return createErrorResponse(`Failed to list APIs: ${(error as Error).message}`, toolName); } });
• src/tools/data-apis.ts:9-48 (registration)

  The registerDataApiTools function registers the 'list_nodit_data_apis' tool on the MCP server using server.tool, including the handler inline.
  export function registerDataApiTools(server: McpServer) { const noditDataApiSpec: NoditOpenApiSpecType = loadNoditDataApiSpec(); server.tool("list_nodit_data_apis", "Lists available Nodit Data API operations.", {}, async () => { const toolName = "list_nodit_data_apis"; try { const apiList = Object.entries(noditDataApiSpec.paths) .filter(([, pathItem]) => pathItem?.post?.operationId) .map(([pathKey, pathItem]) => { let supportedChains: string[] = []; if (pathItem?.post?.parameters) { const chainParam = pathItem.post.parameters.find((param: any) => param.name === 'chain'); if (chainParam?.schema?.enum) { supportedChains = chainParam.schema.enum; } } return { operationId: pathItem!.post!.operationId!, description: normalizeDescription(pathItem!.post!.description), path: pathKey, supportedChains: supportedChains }; }); const formattedList = apiList .map(api => ` - operationId: ${api.operationId}, supported chains: [${api.supportedChains.join(',')}], description: ${api.description}`) .join("\n"); const content = `Nodit Blockchain Context data api has endpoints with patterns like https://web3.nodit.io/v1/{chain}/{network}/getBlockByHashOrNumber. For example, Ethereum mainnet uses an endpoint like https://web3.nodit.io/v1/ethereum/mainnet/getBlockByHashOrNumber. The API list is as follows. You can use the get_nodit_api_spec tool to get more detailed API specifications. - baseUrl: ${noditDataApiSpec.servers[0].url} - Available Nodit API Operations: ${formattedList} ` return { content: [{ type: "text", text: content }] }; } catch (error) { return createErrorResponse(`Failed to list APIs: ${(error as Error).message}`, toolName); } }); }
• src/tools/index.ts:13-13 (registration)

  Top-level registration call in registerAllTools that invokes registerDataApiTools to register the tool.
  registerDataApiTools(server);
• src/helper/nodit-apidoc-helper.ts:59-62 (helper)

  Helper function that loads the Nodit Data API OpenAPI specification YAML file, used by the tool handler to access the API paths and details.
  export function loadNoditDataApiSpec(): NoditOpenApiSpecType { const specPath = path.resolve(__dirname, '../spec/reference/web3-data-api.yaml'); return loadOpenapiSpecFile(specPath) as NoditOpenApiSpecType; }
• src/helper/nodit-apidoc-helper.ts:240-249 (helper)

  Helper function to clean and normalize operation descriptions by removing blockquote lines, used in the tool to format descriptions.
  export function normalizeDescription(description: string | undefined): string { if (!description) { return "No description available." } const lines = description.split('\n'); const filteredLines = lines.filter(line => !line.trimStart().startsWith('>')); return filteredLines.join('\n').trim(); }