SODAX Builders MCP

Instructions

Implementation Reference

• src/tools/sodaxApi.ts:92-116 (handler)

  The MCP tool handler for sodax_get_supported_chains. This async function calls getSupportedChains() service and formats the response as JSON or Markdown based on the format parameter.

  server.tool(
    "sodax_get_supported_chains",
    "List all blockchain networks supported by SODAX for cross-chain swaps and DeFi operations",
    {
      format: z.nativeEnum(ResponseFormat).optional().default(ResponseFormat.MARKDOWN)
        .describe("Response format: 'json' for raw data or 'markdown' for formatted text")
    },
    READ_ONLY,
    async ({ format }) => {
      try {
        const chains = await getSupportedChains();
        return {
          content: [{
            type: "text",
            text: formatResponse(chains, format)
          }]
        };
      } catch (error) {
        return {
          content: [{ type: "text", text: `Error: ${error instanceof Error ? error.message : "Unknown error"}` }],
          isError: true
        };
      }
    }
  );

• src/services/sodaxApi.ts:57-72 (handler)

  The core service function that fetches supported chains from the SODAX API endpoint /config/spoke/chains, with caching support.

  export async function getSupportedChains(): Promise<Chain[]> {
    const cacheKey = "chains";
    const cached = getCached<Chain[]>(cacheKey);
    if (cached) return cached;
  
    try {
      const response = await apiClient.get("/config/spoke/chains");
      // API returns array directly
      const chains = Array.isArray(response.data) ? response.data : (response.data?.data || []);
      setCache(cacheKey, chains);
      return chains;
    } catch (error) {
      console.error("Error fetching chains:", error);
      throw new Error("Failed to fetch supported chains from SODAX API");
    }
  }

• src/tools/sodaxApi.ts:92-98 (schema)

  Zod schema definition for the tool's input parameters - optional format field that accepts 'json' or 'markdown' (defaults to markdown).

  server.tool(
    "sodax_get_supported_chains",
    "List all blockchain networks supported by SODAX for cross-chain swaps and DeFi operations",
    {
      format: z.nativeEnum(ResponseFormat).optional().default(ResponseFormat.MARKDOWN)
        .describe("Response format: 'json' for raw data or 'markdown' for formatted text")
    },

• src/types.ts:13-26 (schema)

  TypeScript interface Chain that defines the structure of blockchain network data returned by the API (id, name, chainId, nativeCurrency, etc.).

  export interface Chain {
    id: string;
    name: string;
    chainId: number;
    nativeCurrency: {
      name: string;
      symbol: string;
      decimals: number;
    };
    rpcUrl?: string;
    explorerUrl?: string;
    iconUrl?: string;
    isTestnet?: boolean;
  }

• src/index.ts:42-42 (registration)

  Registration call where registerSodaxApiTools(server) is invoked to register all SODAX API tools including sodax_get_supported_chains with the MCP server.

  registerSodaxApiTools(server);