Grove Public Endpoints MCP Server

Instructions

Implementation Reference

• src/handlers/endpoint-handlers.ts:128-142 (handler)

  The execution handler for the list_endpoints tool. It handles the tool call by optionally filtering endpoints by category using the endpointManager service and returns the list as formatted JSON.

  case 'list_endpoints': {
    const category = args?.category as string | undefined;
    const endpoints = category
      ? endpointManager.getEndpointsByCategory(category)
      : endpointManager.getAllEndpoints();
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(endpoints, null, 2),
        },
      ],
    };
  }

• src/handlers/endpoint-handlers.ts:15-27 (registration)

  The tool registration definition for list_endpoints, returned by registerEndpointHandlers. Includes the tool name, description, and input schema for category filter.

  {
    name: 'list_endpoints',
    description: "List all available Pocket Network endpoints, optionally filtered by category",
    inputSchema: {
      type: 'object',
      properties: {
        category: {
          type: 'string',
          description: 'Optional category to filter endpoints',
        },
      },
    },
  },

• src/handlers/endpoint-handlers.ts:18-26 (schema)

  Input schema for the list_endpoints tool, defining an optional 'category' string parameter.

  inputSchema: {
    type: 'object',
    properties: {
      category: {
        type: 'string',
        description: 'Optional category to filter endpoints',
      },
    },
  },

• src/index.ts:88-101 (registration)

  Collection of all tool registrations including registerEndpointHandlers, used for the listTools MCP handler.

  const tools: Tool[] = [
    ...registerBlockchainHandlers(server, blockchainService),
    ...registerDomainHandlers(server, domainResolver),
    ...registerTransactionHandlers(server, advancedBlockchain),
    ...registerTokenHandlers(server, advancedBlockchain),
    ...registerMultichainHandlers(server, advancedBlockchain),
    ...registerContractHandlers(server, advancedBlockchain),
    ...registerUtilityHandlers(server, advancedBlockchain),
    ...registerEndpointHandlers(server, endpointManager),
    ...registerSolanaHandlers(server, solanaService),
    ...registerCosmosHandlers(server, cosmosService),
    ...registerSuiHandlers(server, suiService),
    ...registerDocsHandlers(server, docsManager),
  ];

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

  Dispatch to handleEndpointTool in the main tool execution handler, which routes list_endpoints to its case.

  (await handleEndpointTool(name, args, endpointManager)) ||