MantraChain MCP Server

Instructions

Implementation Reference

• src/tools/network.ts:95-147 (handler)

  Handler function that executes the 'query-network' tool logic: initializes the Mantra client, builds the gRPC Gateway API URL with path/query parameters, performs an HTTP fetch request, and returns the JSON response.
  async ({ networkName, path, method, pathParams, queryParams, body }) => { try { await mantraClient.initialize(networkName); // Build the URL with path parameters let url = networks[networkName].apiEndpoint; // Remove trailing slash from base URL if present if (url.endsWith('/')) { url = url.slice(0, -1); } // Add path (substitute path parameters if provided) if (pathParams) { let substitutedPath = path; Object.entries(pathParams).forEach(([key, value]) => { substitutedPath = substitutedPath.replace(`{${key}}`, encodeURIComponent(String(value))); }); url += substitutedPath; } else { url += path; } // Add query parameters if (queryParams && Object.keys(queryParams).length > 0) { const params = new URLSearchParams(); Object.entries(queryParams).forEach(([key, value]) => { params.append(key, String(value)); }); url += `?${params.toString()}`; } // Execute request const response = await fetch(url, { method, headers: { 'Content-Type': 'application/json', 'Accept': 'application/json', }, body: body ? JSON.stringify(body) : undefined, }); const data = await response.json(); return { content: [ {type: "text", text: JSON.stringify(data)} ], }; } catch (error) { throw new Error(`Failed to execute network query: ${error instanceof Error ? error.message : String(error)}`); } }
• src/tools/network.ts:85-94 (schema)

  Zod input schema defining parameters for the 'query-network' tool: networkName, path, method, pathParams, queryParams, body.
  { networkName: z.string().refine(val => Object.keys(networks).includes(val), { message: "Must be a valid network name" }).describe("Name of the network to use - must first check what networks are available by accessing the networks resource `networks://all` before you pass this arguments. Defaults to `mantra-dukong-1` testnet."), path: z.string().describe("API endpoint path from the OpenAPI spec, e.g., '/cosmos/bank/v1beta1/balances/{address}'"), method: z.enum(["GET", "POST", "PUT", "DELETE"]).describe("HTTP method to use for the request"), pathParams: z.record(z.string()).optional().describe("Path parameters to substitute in the URL path"), queryParams: z.record(z.string()).optional().describe("Query parameters to add to the request"), body: z.any().optional().describe("Request body for POST/PUT requests"), },
• src/tools/network.ts:82-148 (registration)

  Registration of the 'query-network' MCP tool using server.tool(), including description, input schema, and handler function.
  server.tool( "query-network", "Execute a generic network gRPC Gateway query against chain APIs when you cannot find the required information from other tools. You MUST first check the available query/service by reading the openapi specification from the resource `openapi://{networkName}` to understand available query/service, methods, required parameters and body structure.", { networkName: z.string().refine(val => Object.keys(networks).includes(val), { message: "Must be a valid network name" }).describe("Name of the network to use - must first check what networks are available by accessing the networks resource `networks://all` before you pass this arguments. Defaults to `mantra-dukong-1` testnet."), path: z.string().describe("API endpoint path from the OpenAPI spec, e.g., '/cosmos/bank/v1beta1/balances/{address}'"), method: z.enum(["GET", "POST", "PUT", "DELETE"]).describe("HTTP method to use for the request"), pathParams: z.record(z.string()).optional().describe("Path parameters to substitute in the URL path"), queryParams: z.record(z.string()).optional().describe("Query parameters to add to the request"), body: z.any().optional().describe("Request body for POST/PUT requests"), }, async ({ networkName, path, method, pathParams, queryParams, body }) => { try { await mantraClient.initialize(networkName); // Build the URL with path parameters let url = networks[networkName].apiEndpoint; // Remove trailing slash from base URL if present if (url.endsWith('/')) { url = url.slice(0, -1); } // Add path (substitute path parameters if provided) if (pathParams) { let substitutedPath = path; Object.entries(pathParams).forEach(([key, value]) => { substitutedPath = substitutedPath.replace(`{${key}}`, encodeURIComponent(String(value))); }); url += substitutedPath; } else { url += path; } // Add query parameters if (queryParams && Object.keys(queryParams).length > 0) { const params = new URLSearchParams(); Object.entries(queryParams).forEach(([key, value]) => { params.append(key, String(value)); }); url += `?${params.toString()}`; } // Execute request const response = await fetch(url, { method, headers: { 'Content-Type': 'application/json', 'Accept': 'application/json', }, body: body ? JSON.stringify(body) : undefined, }); const data = await response.json(); return { content: [ {type: "text", text: JSON.stringify(data)} ], }; } catch (error) { throw new Error(`Failed to execute network query: ${error instanceof Error ? error.message : String(error)}`); } } );