Grove's MCP Server for Pocket Network

Instructions

Implementation Reference

• src/services/advanced-blockchain-service.ts:149-208 (handler)

  Core handler function that implements getTokenMetadata by making parallel eth_call RPC requests to the token contract for name, symbol, decimals, and total supply.

  async getTokenMetadata(
    blockchain: string,
    tokenAddress: string,
    network: 'mainnet' | 'testnet' = 'mainnet'
  ): Promise<EndpointResponse> {
    const service = this.blockchainService.getServiceByBlockchain(blockchain, network);
  
    if (!service) {
      return {
        success: false,
        error: `Blockchain service not found: ${blockchain} (${network})`,
      };
    }
  
    try {
      // Call all methods in parallel
      const [decimalsResult, symbolResult, nameResult, totalSupplyResult] = await Promise.all([
        this.blockchainService.callRPCMethod(
          service.id,
          'eth_call',
          [{ to: tokenAddress, data: AdvancedBlockchainService.ERC20_DECIMALS }, 'latest']
        ),
        this.blockchainService.callRPCMethod(
          service.id,
          'eth_call',
          [{ to: tokenAddress, data: AdvancedBlockchainService.ERC20_SYMBOL }, 'latest']
        ),
        this.blockchainService.callRPCMethod(
          service.id,
          'eth_call',
          [{ to: tokenAddress, data: AdvancedBlockchainService.ERC20_NAME }, 'latest']
        ),
        this.blockchainService.callRPCMethod(
          service.id,
          'eth_call',
          [{ to: tokenAddress, data: AdvancedBlockchainService.ERC20_TOTAL_SUPPLY }, 'latest']
        ),
      ]);
  
      return {
        success: true,
        data: {
          address: tokenAddress,
          decimals: decimalsResult.success ? parseInt(decimalsResult.data, 16) : null,
          symbol: symbolResult.success ? this.decodeString(symbolResult.data) : null,
          name: nameResult.success ? this.decodeString(nameResult.data) : null,
          totalSupply: totalSupplyResult.success ? BigInt(totalSupplyResult.data).toString() : null,
        },
        metadata: {
          timestamp: new Date().toISOString(),
          endpoint: service.rpcUrl,
        },
      };
    } catch (error) {
      return {
        success: false,
        error: error instanceof Error ? error.message : 'Failed to fetch token metadata',
      };
    }
  }

• src/handlers/token-handlers.ts:106-122 (handler)

  MCP dispatch handler case for 'get_token_metadata' tool that extracts parameters and calls the advanced blockchain service.

  case 'get_token_metadata': {
    const blockchain = args?.blockchain as string;
    const tokenAddress = args?.tokenAddress as string;
    const network = (args?.network as 'mainnet' | 'testnet') || 'mainnet';
  
    const result = await advancedBlockchain.getTokenMetadata(blockchain, tokenAddress, network);
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2),
        },
      ],
      isError: !result.success,
    };
  }

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

  Registration of token tools including get_token_metadata via registerTokenHandlers call during server initialization.

  ...registerTokenHandlers(server, advancedBlockchain),

• src/handlers/token-handlers.ts:42-64 (schema)

  Tool schema definition including input schema for blockchain, tokenAddress, and optional network.

  {
    name: 'get_token_metadata',
    description: 'Get token metadata (name, symbol, decimals, total supply)',
    inputSchema: {
      type: 'object',
      properties: {
        blockchain: {
          type: 'string',
          description: 'Blockchain name',
        },
        tokenAddress: {
          type: 'string',
          description: 'Token contract address',
        },
        network: {
          type: 'string',
          enum: ['mainnet', 'testnet'],
          description: 'Network type (defaults to mainnet)',
        },
      },
      required: ['blockchain', 'tokenAddress'],
    },
  },