DexScreener MCP Server

Instructions

Implementation Reference

• src/services/dexscreener.ts:109-114 (handler)

  The core handler function in DexScreenerService that fetches token orders from the DexScreener API endpoint /orders/v1/{chainId}/{tokenAddress} with rate limiting.

  async getTokenOrders({ chainId, tokenAddress }: OrderParams): Promise<TokenOrder[]> {
    return this.fetch<TokenOrder[]>(
      `/orders/v1/${chainId}/${tokenAddress}`,
      tokenRateLimiter
    );
  }

• src/index.ts:121-137 (schema)

  Input schema and description for the get_token_orders tool as declared in the MCP server capabilities.

  get_token_orders: {
    description: 'Check orders paid for a specific token',
    inputSchema: {
      type: 'object',
      properties: {
        chainId: {
          type: 'string',
          description: 'Chain ID (e.g., "solana")',
        },
        tokenAddress: {
          type: 'string',
          description: 'Token address',
        },
      },
      required: ['chainId', 'tokenAddress'],
    },
  },

• src/index.ts:319-323 (registration)

  Registration and dispatching logic in the MCP callTool request handler that routes get_token_orders calls to the DexScreenerService method.

  case 'get_token_orders': {
    const args = request.params.arguments as { chainId: string; tokenAddress: string };
    result = await this.dexService.getTokenOrders(args);
    break;
  }