get_cosmos_account

Instructions

Implementation Reference

• src/handlers/cosmos-handlers.ts:422-438 (handler)

  MCP tool handler implementation for 'get_cosmos_account': extracts parameters, calls cosmosService.getAccount, and returns formatted JSON response.

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

• src/handlers/cosmos-handlers.ts:65-87 (schema)

  Tool schema definition: name, description, input schema requiring blockchain and address, optional network.

  {
    name: 'get_cosmos_account',
    description: 'Get Cosmos account information (sequence, account number)',
    inputSchema: {
      type: 'object',
      properties: {
        blockchain: {
          type: 'string',
          description: 'Blockchain name',
        },
        address: {
          type: 'string',
          description: 'Cosmos address',
        },
        network: {
          type: 'string',
          enum: ['mainnet', 'testnet'],
          description: 'Network type (defaults to mainnet)',
        },
      },
      required: ['blockchain', 'address'],
    },
  },

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

  Registration of all tools including cosmos tools via registerCosmosHandlers; tools list used for ListToolsRequestHandler.

  // Register all tools from handlers
  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/services/cosmos-service.ts:122-138 (helper)

  Helper method in CosmosService that constructs REST API URL and fetches account info from /cosmos/auth/v1beta1/accounts/{address}.

  async getAccount(
    blockchain: string,
    address: string,
    network: 'mainnet' | 'testnet' = 'mainnet'
  ): Promise<EndpointResponse> {
    try {
      const baseUrl = this.getRestUrl(blockchain, network);
      const url = `${baseUrl}/cosmos/auth/v1beta1/accounts/${address}`;
  
      return this.fetchRest(url);
    } catch (error) {
      return {
        success: false,
        error: error instanceof Error ? error.message : 'Failed to get Cosmos account',
      };
    }
  }

• src/index.ts:114-127 (registration)

  Tool execution dispatch in CallToolRequestHandler: routes 'get_cosmos_account' to handleCosmosTool.

  let result =
    (await handleBlockchainTool(name, args, blockchainService)) ||
    (await handleDomainTool(name, args, domainResolver)) ||
    (await handleTransactionTool(name, args, advancedBlockchain)) ||
    (await handleTokenTool(name, args, advancedBlockchain)) ||
    (await handleMultichainTool(name, args, advancedBlockchain)) ||
    (await handleContractTool(name, args, advancedBlockchain)) ||
    (await handleUtilityTool(name, args, advancedBlockchain)) ||
    (await handleEndpointTool(name, args, endpointManager)) ||
    (await handleSolanaTool(name, args, solanaService)) ||
    (await handleCosmosTool(name, args, cosmosService)) ||
    (await handleSuiTool(name, args, suiService)) ||
    (await handleDocsTool(name, args, docsManager));