Grove's MCP Server for Pocket Network

Instructions

Implementation Reference

• src/handlers/solana-handlers.ts:214-235 (registration)

  Tool definition and registration in the tools array returned by registerSolanaHandlers, including name, description, and input schema.

    name: 'get_solana_signatures',
    description: 'Get transaction signatures for a Solana address (transaction history)',
    inputSchema: {
      type: 'object',
      properties: {
        address: {
          type: 'string',
          description: 'Solana address',
        },
        limit: {
          type: 'number',
          description: 'Maximum number of signatures to return (default: 10)',
        },
        network: {
          type: 'string',
          enum: ['mainnet', 'testnet'],
          description: 'Network type (defaults to mainnet)',
        },
      },
      required: ['address'],
    },
  },

• src/handlers/solana-handlers.ts:374-390 (handler)

  MCP tool handler implementation in handleSolanaTool switch statement: parses input arguments, calls SolanaService.getSignaturesForAddress, and formats response.

  case 'get_solana_signatures': {
    const address = args?.address as string;
    const limit = (args?.limit as number) || 10;
    const network = (args?.network as 'mainnet' | 'testnet') || 'mainnet';
  
    const result = await solanaService.getSignaturesForAddress(address, limit, network);
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(result, null, 2),
        },
      ],
      isError: !result.success,
    };
  }

• src/services/solana-service.ts:371-395 (helper)

  Core helper method in SolanaService that executes the RPC call to getSignaturesForAddress on the appropriate Solana RPC endpoint.

  async getSignaturesForAddress(
    address: string,
    limit: number = 10,
    network: 'mainnet' | 'testnet' = 'mainnet'
  ): Promise<EndpointResponse> {
    const service = this.blockchainService.getServiceByBlockchain('solana', network);
  
    if (!service) {
      return {
        success: false,
        error: `Solana service not found for ${network}`,
      };
    }
  
    return this.blockchainService.callRPCMethod(
      service.id,
      'getSignaturesForAddress',
      [
        address,
        {
          limit,
        },
      ]
    );
  }