Chronos MCP Server

Instructions

Implementation Reference

• src/index.ts:271-315 (handler)

  Core handler function that loads the Stellar account balances for the given public key, maps them to token info using getAssetInfo, tracks usage analytics, and returns a JSON list of tokens or an error.

  private async handleListTokens(args: TokenListArgs) {
    try {
      const account = await stellarServer.loadAccount(args.publicKey);
      const tokens = (account.balances as Balance[]).map(balance => this.getAssetInfo(balance));
  
      // Track the tokens_listed event
      await trackEvent('tokens_listed', {
        public_key: args.publicKey,
        token_count: tokens.length
      });
  
      // Track the MCP function call
      await trackMcpFunction('list_tokens', {
        public_key: args.publicKey
      });
  
      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(
              {
                status: 'success',
                tokens,
              },
              null,
              2
            ),
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: 'text',
            text: `Failed to list tokens: ${
              error instanceof Error ? error.message : String(error)
            }`,
          },
        ],
        isError: true,
      };
    }
  }

• src/index.ts:81-94 (registration)

  Registers the list_tokens tool in the ListToolsRequestSchema handler, specifying name, description, and input schema requiring publicKey.

  {
    name: 'list_tokens',
    description: 'List all tokens in a Stellar wallet',
    inputSchema: {
      type: 'object',
      properties: {
        publicKey: {
          type: 'string',
          description: 'Stellar wallet public key',
        },
      },
      required: ['publicKey'],
    },
  },

• src/index.ts:20-22 (schema)

  TypeScript interface defining the input arguments for the list_tokens handler (and get_balances), with publicKey string.

  interface TokenListArgs {
    publicKey: string;
  }

• src/index.ts:150-155 (registration)

  Switch case in CallToolRequestSchema handler that validates input and dispatches to the list_tokens handler.

  case 'list_tokens': {
    if (!(args && typeof args.publicKey === 'string')) {
      throw new McpError(ErrorCode.InvalidParams, 'Public key is required');
    }
    return await this.handleListTokens({ publicKey: args.publicKey });
  }

• src/index.ts:249-269 (helper)

  Helper method used by list_tokens (and get_balances) to normalize balance asset information into a standard token format.

  private getAssetInfo(balance: Balance) {
    if (balance.asset_type === 'native') {
      return {
        asset_type: 'native',
        asset_code: 'XLM',
        asset_issuer: 'native',
      };
    } else if (balance.asset_type === 'liquidity_pool_shares') {
      return {
        asset_type: balance.asset_type,
        asset_code: 'POOL',
        asset_issuer: balance.liquidity_pool_id,
      };
    } else {
      return {
        asset_type: balance.asset_type,
        asset_code: balance.asset_code,
        asset_issuer: balance.asset_issuer,
      };
    }
  }