claim_sponsor_card
Claim a sponsor card to credit your DAH balance from the W3 Ledger MCP Server. Only ISSUED cards can be claimed using your public key and card verification details.
Instructions
Claim a sponsor card and credit the claimer's DAH balance. Only cards with status ISSUED can be claimed.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| player_publickey | Yes | Public key of the person claiming the card. | |
| cardInfo | Yes | Sponsor card to claim (must include verification fields). |
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'], },