redeem_code

Connect to https://mcp.agentcard.sh/mcp with the user’s connection token (or a buy_token for org-owned accounts). Behavior: idempotent.

What it does

Redeem a promo code that adds money to the user’s cash balance. Each code works once per user; the credit lands in the balance and becomes spendable within a minute or two. Some codes hold the money until the user verifies their identity — the claim still locks the code to this user instantly, and the credit lands automatically once KYC is approved (start_kyc begins verification). The gated tool list_codes shows the user’s code history; call it by name even though it isn’t in the tools list.

Inputs

Field	Type	Description
`code` (required)	string	The promo code exactly as the user provided it (case and dashes are forgiven).

Returns

Field	Type	Description
`message` (required)	string	Human-readable result or next step.

Example call

{
  "tool": "redeem_code",
  "arguments": {
    "code": "\u2026"
  }
}

MCP

Organization tools

User tools

What it does

Inputs

Returns

Example call

​What it does

​Inputs

​Returns

​Example call

What it does

Inputs

Returns

Example call