W3 Ledger MCP Server

Instructions

Implementation Reference

• src/tools.ts:417-420 (handler)

  The handler for 'claim_sponsor_card' executes a POST request to the '/claim-sponsor-card' API endpoint using the RolledgeClient.

  case 'claim_sponsor_card': {
      const res = await client.post('/claim-sponsor-card', args);
      return toResult(res.data, !res.ok);
  }

• src/tools.ts:272-319 (schema)

  The MCP tool definition and input schema for 'claim_sponsor_card', specifying required fields like player_publickey and cardInfo.

  {
      name: 'claim_sponsor_card',
      description:
          'Claim a sponsor card and credit the claimer\'s DAH balance. ' +
          'Only cards with status ISSUED can be claimed.',
      inputSchema: {
          type: 'object',
          properties: {
              player_publickey: {
                  type: 'string',
                  description: 'Public key of the person claiming the card.',
              },
              cardInfo: {
                  type: 'object',
                  description:
                      'Sponsor card to claim (must include verification fields).',
                  properties: {
                      card_id: { type: 'string', description: 'Unique sponsor card ID.' },
                      card_public_key: {
                          type: 'string',
                          description: 'Card\'s public key for verification.',
                      },
                      digital_signature: {
                          type: 'string',
                          description: 'Card\'s digital signature.',
                      },
                      message: { type: 'string', description: 'Sponsor message.' },
                      cardValue: { type: 'number', description: 'Card value.' },
                      sponsor_name: { type: 'string', description: 'Sponsor name.' },
                      status: {
                          type: 'string',
                          description: 'Must be ISSUED.',
                          enum: ['ISSUED'],
                      },
                  },
                  required: [
                      'card_id',
                      'card_public_key',
                      'digital_signature',
                      'message',
                      'cardValue',
                      'sponsor_name',
                      'status',
                  ],
              },
          },
          required: ['player_publickey', 'cardInfo'],
      },