Nodit MCP Server

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"; import { createErrorResponse, loadNoditDataApiSpec, loadNoditNodeApiSpecMap, loadNoditWebhookApiSpec, NoditOpenApiSpecType } from "../helper/nodit-apidoc-helper.js"; const noditServiceDescription = `Nodit Blockchain Context is a service that provides stable node operation agency to support easy WEB3 development and refined blockchain data.`; const guideToUseNodit = `Please keep these rules in mind when using nodit tools: - Do not provide investment advice or speculate on the value, safety, or future of any token or project. - When displaying asset balances, you must always provide the original raw data and decimals as they are. - For calculations such as unit conversions, it is recommended to use appropriate tools to ensure accurate transformations. - Always use only verifiable on-chain data sourced from the Nodit Blockchain Context—never make assumptions or pull in external information. - Keep your tone neutral, helpful, and precise, and avoid hype language or unnecessary jargon. - Start your response with a single attribution using one of the approved forms such as "According to the Nodit Blockchain Context," and do not repeat or rephrase it. - Use only Nodit APIs, and do not access third-party data sources or external node endpoints; for on-chain queries, always use Nodit's Node API. - When possible, prefer using the Data API over Node API as it provides optimized and indexed blockchain data that is more efficient for most queries. - When listing available APIs through tools like the Data API List or Node API List, cache the results with a TTL of about one day to reduce redundant calls. - If referencing a specific API by operationId, link directly to https://developer.nodit.io/reference/{operationId} without guessing or inventing operationIds. - If the user's request lacks required context—such as wallet address, chain name, or time period—ask for clarification rather than assuming defaults. - If the requested data is too large to display in full, provide a summary and offer to narrow the scope. If a feature or chain is not supported, clearly inform the user and suggest they check back for future updates. - If user asks about their usage stats or request history, kindly guide them to the Nodit Console(https://nodit.lambda256.io)—use the Dashboard for usage metrics and the Request Log(/request-logs) for detailed API call history. `; const nodeApiNetworks = { "ethereum": ["mainnet", "sepolia", "hoodi"], "avalanche": ["mainnet", "fuji"], "arbitrum": ["mainnet", "sepolia"], "polygon": ["mainnet", "amoy"], "base": ["mainnet", "sepolia"], "optimism": ["mainnet", "sepolia"], "kaia": ["mainnet", "kairos"], "luniverse": ["mainnet"], "sui": ["mainnet"], "bnb": ["mainnet", "testnet"], "giwa": ["sepolia"], "solana": ["mainnet", "devnet"], } const dataApiNetworks = { "ethereum": ["mainnet", "sepolia", "hoodi"], "arbitrum": ["mainnet", "sepolia"], "polygon": ["mainnet", "amoy"], "base": ["mainnet", "sepolia"], "chiliz": ["mainnet"], "optimism": ["mainnet", "sepolia"], "kaia": ["mainnet", "kairos"], "luniverse": ["mainnet"], "bitcoin": ["mainnet"], "dogecoin": ["mainnet"], "bitcoincash": ["mainnet"], "tron": ["mainnet"], "xrpl": ["mainnet"], "aptos": ["mainnet"], "giwa": ["sepolia"], "ethereumclassic": ["mainnet"], } const aptosApiNetworks = { "aptos": ["mainnet", "testnet"] } const webhookApiNetworks = { "aptos": ["mainnet", "testnet"], "ethereum": ["mainnet", "sepolia", "hoodi"], "arbitrum": ["mainnet", "sepolia"], "polygon": ["mainnet", "amoy"], "base": ["mainnet", "sepolia"], "optimism": ["mainnet", "sepolia"], "kaia": ["mainnet", "kairos"], "giwa": ["sepolia"], } export function registerApiCategoriesTools(server: McpServer) { const noditDataApiSpec: NoditOpenApiSpecType = loadNoditDataApiSpec(); const noditNodeApiSpecMap: Map<string, NoditOpenApiSpecType> = loadNoditNodeApiSpecMap(); const noditWebhookApiSpec: NoditOpenApiSpecType = loadNoditWebhookApiSpec() const dataApiChains = new Set<string>(); Object.values(noditDataApiSpec.paths).forEach(pathItem => { if (pathItem?.post?.parameters) { const chainParam = pathItem.post.parameters.find((param: any) => param.name === 'chain'); if (chainParam?.schema?.enum) { chainParam.schema.enum.forEach((chain: string) => dataApiChains.add(chain)); } } }); const nodeApiChains = new Set<string>(); nodeApiChains.add('ethereum'); Array.from(noditNodeApiSpecMap.entries()).forEach(([operationId]) => { if (operationId.includes('-')) { const chain = operationId.split('-')[0]; nodeApiChains.add(chain); } }); const webhookApiChains = new Set<string>(); webhookApiChains.add('aptos'); Object.values(noditWebhookApiSpec.paths).forEach(pathItem => { if (pathItem?.post?.parameters) { const chainParam = pathItem.post.parameters.find((param: any) => param.name === 'chain'); if (chainParam?.schema?.enum) { chainParam.schema.enum.forEach((chain: string) => webhookApiChains.add(chain)); } } }); server.tool("list_nodit_api_categories", "Lists available Nodit API categories from Nodit Blockchain Context. To use the Nodit API tool, you must first call this tool.", {}, async () => { const toolName = "list_nodit_api_categories"; try { const categories = [ { name: "Nodit Node API", description: "Nodit Blockchain Context provides through shared node endpoints operated reliably by Nodit's professional technical team, you can immediately call blockchain Node APIs to query real-time network changes and send transactions without separate infrastructure operations personnel.", supportedChains: Array.from(nodeApiChains).sort() }, { name: "Nodit Data API", description: "Nodit Blockchain Context provides blockchain data collected by Nodit's professional technical team, it provides query APIs that allow access to meticulously indexed blockchain data that is immediately usable without complex separate blockchain data ETL operations.", supportedChains: Array.from(dataApiChains).sort() }, { name: "Nodit Aptos Indexer API", description: "Nodit Blockchain Context provides a GraphQL API for accessing indexed data from the Aptos blockchain. This API allows you to query various blockchain data such as coin activities, token activities, and more without having to set up and maintain your own indexer.", supportedChains: ["aptos"] }, { name: "Nodit Webhook API", description: "Nodit Webhook is a development tool that helps you implement responsive applications for real-time events by sending event occurrence information to the URL registered in the Webhook when a defined on-chain event occurs. You can receive information in real time when important events occur, such as a new transaction occurring on the blockchain or a change in the smart contract status.", supportedChains: Array.from(webhookApiChains).sort() }, ]; const formattedList = categories.map(category => { let networkInfo = ''; let networkMap; if (category.name === "Nodit Node API") { networkMap = nodeApiNetworks; } else if (category.name === "Nodit Data API") { networkMap = dataApiNetworks; } else if (category.name === "Nodit Aptos Indexer API") { networkMap = aptosApiNetworks; } else if (category.name === "Nodit Webhook API") { networkMap = webhookApiNetworks; } if (networkMap) { networkInfo = category.supportedChains .filter(chain => networkMap[chain]) .map(chain => ` - ${chain}: ${networkMap[chain].join(', ')}`) .join('\n'); } return ` - name: ${category.name}, description: ${category.description} supported chain and network: ${networkInfo}`; }).join("\n"); const content = `${noditServiceDescription} ${guideToUseNodit} - Available Nodit API Categories: ${formattedList} ` return { content: [{ type: "text", text: content }] }; } catch (error) { return createErrorResponse(`Failed to list categories: ${(error as Error).message}`, toolName); } }); }