English Français العربية

SpendTheBits Gift Cards

Official registry Finance and payments

Let an AI agent buy gift cards with USDC over x402, within limits the wallet owner sets.

Website

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http spendthebits-gift-cards 'https://x402.spendthebits.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "spendthebits-gift-cards": {
            "type": "http",
            "url": "https://x402.spendthebits.com/mcp"
        }
    }
}
NPM package @spendthebits/mcp-giftcards
Claude Code 
claude mcp add spendthebits-gift-cards -e 'STB_AGENT_PRIVATE_KEY=<your stb_agent_private_key>' -e 'STB_MAX_USDC_PER_PAYMENT=30' -e 'STB_ORDERS_FILE=<STB_ORDERS_FILE>' -- npx -y @spendthebits/mcp-giftcards@0.1.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "spendthebits-gift-cards": {
            "command": "npx",
            "args": [
                "-y",
                "@spendthebits/mcp-giftcards@0.1.2"
            ],
            "env": {
                "STB_AGENT_PRIVATE_KEY": "<your stb_agent_private_key>",
                "STB_MAX_USDC_PER_PAYMENT": "30",
                "STB_ORDERS_FILE": "<STB_ORDERS_FILE>"
            }
        }
    }
}

Environment variables

  • STB_AGENT_PRIVATE_KEY secret The agent key from the SpendTheBits app's Agents screen. Never the wallet's recovery phrase. Without it, search, price and status still work.
  • STB_MAX_USDC_PER_PAYMENT The most this server signs for in one payment, in USDC.
  • STB_ORDERS_FILE Optional file that keeps order claim tokens across restarts.

Frequently asked questions

What is SpendTheBits Gift Cards?

Let an AI agent buy gift cards with USDC over x402, within limits the wallet owner sets.

How do I install SpendTheBits Gift Cards?

It runs as a remote server. In Claude Code: claude mcp add --transport http spendthebits-gift-cards 'https://x402.spendthebits.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does SpendTheBits Gift Cards need an API key?

Yes. It expects STB_AGENT_PRIVATE_KEY, which you set in its configuration.

Who maintains SpendTheBits Gift Cards?

It is published by jkambo1986-collab. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.