Seitrace Insights MCP Server

import { McpToolDefinition } from '../../../types.js'; // Short, LLM-friendly description of this resource export const RESOURCE_DESCRIPTION = 'Query smart contract state via Multicall3, search verified contracts, or download smart contract ABI from Seitrace (pacific-1, atlantic-2, arctic-1).'; /** * Smart Contract endpoint definition * Controller/action key format: <ControllerName>-<ActionNameCamel> * We use ContractController-downloadAbi so the resource tool name becomes `smart_contract_contract`. */ export const endpointDefinitionMap: Map<string, McpToolDefinition> = new Map([ [ 'Controller-downloadAbi', { name: 'Controller-downloadAbi', description: 'Download ABI for a smart contract by its address from Seitrace networks. Returns only the ABI field instead of the full contract metadata to reduce response size. Supports Pacific-1, Atlantic-2, and Arctic-1 chains. Does not support snippet generation.', inputSchema: { type: 'object', properties: { contract_address: { type: 'string', description: 'EVM contract address (0x-prefixed hex string)', pattern: '^0x[a-fA-F0-9]{40}$', }, chain: { type: 'string', description: 'Seitrace network chain identifier', enum: ['pacific-1', 'atlantic-2', 'arctic-1'], default: 'pacific-1', }, }, required: ['contract_address'], additionalProperties: false, }, method: 'get', pathTemplate: '/api/v2/smart-contracts/{contract_address}', // Path parameter for contract address executionParameters: [ { name: 'contract_address', in: 'path', required: true, schema: { type: 'string' }, }, ], requestBodyContentType: undefined, securityRequirements: [], executor: 'api', resolver: 'smartContract', snippetGenerator: null, // Explicitly disable snippet generation as requested }, ], [ 'Controller-searchVerifiedContracts', { name: 'Controller-searchVerifiedContracts', description: 'Search for verified smart contracts by query string from Seitrace networks (returns 5 most matching contracts). Returns contract name, address hash, and programming language. Supports pacific-1, atlantic-2, and arctic-1 chains. Does not support snippet generation.', inputSchema: { type: 'object', properties: { q: { type: 'string', description: 'Search query string to find verified contracts', minLength: 1, }, chain: { type: 'string', description: 'Seitrace network chain identifier', enum: ['pacific-1', 'atlantic-2', 'arctic-1'], default: 'pacific-1', }, }, required: ['q'], additionalProperties: false, }, method: 'get', pathTemplate: '/api/v2/smart-contracts', // Query parameters for search executionParameters: [ { name: 'q', in: 'query', required: true, schema: { type: 'string' }, }, ], requestBodyContentType: undefined, securityRequirements: [], executor: 'api', resolver: 'searchContracts', snippetGenerator: null, // Explicitly disable snippet generation as requested }, ], [ 'Controller-queryContractState', { name: 'Controller-queryContractState', description: 'Query smart contract state using Multicall3.aggregate3 via EVM RPC. Takes ABI, contract address, method call payload, and chain ID. Uses ethers.js to execute batch contract calls with individual failure handling and decode responses. Supports snippet generation.', inputSchema: { type: 'object', properties: { abi: { type: 'array', description: 'Contract ABI as JSON array', items: { type: 'object', }, }, contract_address: { type: 'string', description: 'EVM contract address (0x-prefixed hex string)', pattern: '^0x[a-fA-F0-9]{40}$', }, payload: { type: 'array', description: 'Array of method call payloads for batch execution', items: { type: 'object', properties: { methodName: { type: 'string', description: 'Contract method name to call', }, arguments: { type: 'array', description: 'Array of arguments for the method call', items: {}, }, }, required: ['methodName'], additionalProperties: false, }, minItems: 1, }, chain_id: { type: 'string', description: 'Seitrace network chain identifier', enum: ['pacific-1', 'atlantic-2', 'arctic-1'], default: 'pacific-1', }, }, required: ['abi', 'contract_address', 'payload', 'chain_id'], additionalProperties: false, }, method: 'post', pathTemplate: '/multicall', executionParameters: [], requestBodyContentType: 'application/json', securityRequirements: [], executor: 'ethers', resolver: undefined, snippetGenerator: 'ethers', // Use ethers snippet generator for contract interactions }, ], ]);