DexPaprika MCP Server

Instructions

Implementation Reference

• src/index.js:141-144 (handler)

  The handler function that implements the core logic of the getPoolDetails tool. It fetches detailed pool information from the DexPaprika API using the provided network and poolAddress, with an optional inversed flag, and formats the response using the shared formatMcpResponse helper.
  async ({ network, poolAddress, inversed }) => { const data = await fetchFromAPI(`/networks/${network}/pools/${poolAddress}?inversed=${inversed}`); return formatMcpResponse(data); }
• src/index.js:136-140 (schema)

  Zod schema defining the input parameters for the getPoolDetails tool: network (required string), poolAddress (required string), and inversed (optional boolean, defaults to false).
  { network: z.string().describe('Network ID from getNetworks (e.g., "ethereum", "solana")'), poolAddress: z.string().describe('Pool address or identifier'), inversed: z.boolean().optional().default(false).describe('Whether to invert the price ratio') },
• src/index.js:133-145 (registration)

  Registration of the getPoolDetails tool with the MCP server using server.tool(), including the tool name, description, input schema, and handler function.
  server.tool( 'getPoolDetails', 'Get detailed information about a specific pool. Requires network ID from getNetworks and a pool address.', { network: z.string().describe('Network ID from getNetworks (e.g., "ethereum", "solana")'), poolAddress: z.string().describe('Pool address or identifier'), inversed: z.boolean().optional().default(false).describe('Whether to invert the price ratio') }, async ({ network, poolAddress, inversed }) => { const data = await fetchFromAPI(`/networks/${network}/pools/${poolAddress}?inversed=${inversed}`); return formatMcpResponse(data); } );
• src/index.js:10-34 (helper)

  Shared helper function used by getPoolDetails (and other tools) to make API requests to DexPaprika, handling specific error codes like 410 (deprecated endpoint) and 429 (rate limit).
  async function fetchFromAPI(endpoint) { try { const response = await fetch(`${API_BASE_URL}${endpoint}`); if (!response.ok) { if (response.status === 410) { throw new Error( 'This endpoint has been permanently removed. Please use network-specific endpoints instead. ' + 'For example, use /networks/{network}/pools instead of /pools. ' + 'Get available networks first using the getNetworks function.' ); } if (response.status === 429) { throw new Error( 'Rate limit exceeded. You have reached the maximum number of requests allowed for the free tier. ' + 'To increase your rate limits and access additional features, please consider upgrading to a paid plan at https://docs.dexpaprika.com/' ); } throw new Error(`API request failed with status ${response.status}`); } return await response.json(); } catch (error) { console.error(`Error fetching from API: ${error.message}`); throw error; } }
• src/index.js:37-46 (helper)

  Shared helper function used by getPoolDetails (and other tools) to format API responses into the MCP expected format (text content with JSON stringified data).
  function formatMcpResponse(data) { return { content: [ { type: "text", text: JSON.stringify(data) } ] }; }