DexPaprika MCP Server

Instructions

Implementation Reference

• src/index.js:133-145 (registration)

  Registration of the 'getPoolDetails' tool using server.tool(), including description, input schema, and inline 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:141-144 (handler)

  The handler function that executes the tool logic: fetches pool details from the DexPaprika API endpoint and formats the response for MCP.
  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 input parameters for the getPoolDetails tool: network, poolAddress, and optional inversed flag.
  { 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:10-34 (helper)

  Shared helper function fetchFromAPI used by getPoolDetails (and other tools) to make API requests to DexPaprika with error handling.
  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 to format API data into MCP response format, used by getPoolDetails (and other tools).
  function formatMcpResponse(data) { return { content: [ { type: "text", text: JSON.stringify(data) } ] }; }