key_nft_read

dapp/app/lib/mcp/tools/keynft-read/index.ts consolidates the historical reader tools into one RPC surface. The action field selects which helper under actions/* executes.

Supported Actions

Handler Skeleton

// dapp/app/lib/mcp/tools/keynft-read/index.ts
const tool: Tool<Params> = {
  name: 'key_nft_read',
  description: 'Consolidated Key NFT read functions...',
  inputSchema: InputSchema,
  async handler(input: Params) {
    switch (input.action) {
      case 'get_key_nft_collection_info': return handleCollectionInfo();
      case 'get_key_nft_total_supply': return handleTotalSupply();
      case 'get_key_nft_balance': return handleBalance(input);
      case 'get_key_nft_tokens_of_owner': return handleOwnerTokens(input);
      case 'get_key_nft_token_of_owner': return handleOwnerSingle(input);
      case 'get_key_nft_token_metadata': return handleTokenMetadata(input);
      case 'get_key_nft_holders': return handleHolders(input);
      case 'get_key_nft_summary_for_owner': return handleOwnerSummary(input);
      default: fail('Unknown action for key_nft_read');
    }
  },
};

Each action pushes both text and JSON shapes so screens and LLM prompts can stay synchronized (e.g., the metadata action returns token colors, while the owner-summary includes palette plus count).

Presenter Coverage

dapp/components/chatBot/ToolActivity/catalog/presenters/keynft_read.presenter.ts is one of the largest presenters because it mirrors the action list. Highlights:

• Pending copy switches on action (e.g., Listing Owner Tokens…, Fetching Token Metadata…).
• Success copy formats counts, token IDs, palettes, and network names (using public.env.ts to label RitoNet).
• Error copy detects wallet/auth failures and prompts the user to reconnect when necessary.

Playground Demo

Submit message to see the tool use process simulated.

Tips