Grove Public Endpoints MCP Server

Instructions

Implementation Reference

• src/handlers/contract-handlers.ts:15-41 (registration)

  Registers the 'call_contract_view' MCP tool with name, description, and input schema definition

  {
    name: 'call_contract_view',
    description: 'Call a read-only contract function',
    inputSchema: {
      type: 'object',
      properties: {
        blockchain: {
          type: 'string',
          description: 'Blockchain name',
        },
        contractAddress: {
          type: 'string',
          description: 'Contract address',
        },
        data: {
          type: 'string',
          description: 'Encoded function call data',
        },
        network: {
          type: 'string',
          enum: ['mainnet', 'testnet'],
          description: 'Network type (defaults to mainnet)',
        },
      },
      required: ['blockchain', 'contractAddress', 'data'],
    },
  },

• src/handlers/contract-handlers.ts:59-81 (handler)

  Handler logic for 'call_contract_view' tool: extracts arguments, calls AdvancedBlockchainService.callContractView, formats and returns the result as MCP response

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

• src/services/advanced-blockchain-service.ts:486-512 (helper)

  Core implementation: performs 'eth_call' RPC call to the contract address with the provided calldata on the specified blockchain and network

  async callContractView(
    blockchain: string,
    contractAddress: string,
    data: 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})`,
      };
    }
  
    return this.blockchainService.callRPCMethod(
      service.id,
      'eth_call',
      [
        {
          to: contractAddress,
          data: data,
        },
        'latest',
      ]
    );
  }