SpendTheBits Gift Cards MCP Server

io.github.jkambo1986-collab/stb-giftcardsv0.1.0

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

Node.jsstdioofficial registry

context tax

pending

security

pending

cold start

pending

freshness

pending

Our reading of SpendTheBits Gift Cards, from the data

SpendTheBits Gift Cards is a finance & fintech MCP server, listed in the official MCP Registry.

We haven't measured its tool list yet, so its token cost is unknown.

It runs locally on your machine over stdio and needs one secret (STB_AGENT_PRIVATE_KEY); use a scoped, least-privilege key.

Install SpendTheBits Gift Cards MCP server

claude mcp add giftcards -e STB_AGENT_PRIVATE_KEY='<stb-agent-private-key>' -- npx -y @spendthebits/mcp-giftcards

{
  "mcpServers": {
    "giftcards": {
      "command": "npx",
      "args": [
        "-y",
        "@spendthebits/mcp-giftcards"
      ],
      "env": {
        "STB_AGENT_PRIVATE_KEY": "<stb-agent-private-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "giftcards": {
      "command": "npx",
      "args": [
        "-y",
        "@spendthebits/mcp-giftcards"
      ],
      "env": {
        "STB_AGENT_PRIVATE_KEY": "<stb-agent-private-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "giftcards": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@spendthebits/mcp-giftcards"
      ],
      "env": {
        "STB_AGENT_PRIVATE_KEY": "<stb-agent-private-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "giftcards": {
      "command": "npx",
      "args": [
        "-y",
        "@spendthebits/mcp-giftcards"
      ],
      "env": {
        "STB_AGENT_PRIVATE_KEY": "<stb-agent-private-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
STB_AGENT_PRIVATE_KEY	—	yes	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.

Freshness

Not enough public signals yet to judge maintenance.

Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-10-09 · 9d ago · official registry · v0.1.0

How it compares in Finance & Fintech

Against the most-starred finance & fintech servers we index. Token cost is per model turn, measured from each server's live tool list.

Server	Stars	Tools	Tokens / turn	Freshness	Runs
SpendTheBits Gift Cards (this)	—	—	not measured	—	local
CCXT	44,454	—	not measured	Active	local
Finance Toolkit	5,439	—	not measured	Active	local + hosted
Agent Toolkit	1,960	—	not measured	Active	hosted
Stripe	1,960	—	not measured	Active	local
Tradememory Protocol	1,430	—	not measured	Active	local

All finance & fintech MCP servers

FAQ

›How do I install the SpendTheBits Gift Cards MCP server in Claude Code?

Run: claude mcp add giftcards -e STB_AGENT_PRIVATE_KEY='<stb-agent-private-key>' -- npx -y @spendthebits/mcp-giftcards. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does SpendTheBits Gift Cards require an API key?

Yes. It expects STB_AGENT_PRIVATE_KEY, of which 1 is a secret.

›Can I use SpendTheBits Gift Cards as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is SpendTheBits Gift Cards in the official MCP registry?

Yes, as io.github.jkambo1986-collab/stb-giftcards.

Sources and method

Official MCP Registry entry: updated 2026-10-09
Package registry (npm / PyPI): listed
Last checked against all sources: 2026-10-19

The description, packages and links come from the maintainer's own published metadata. Token cost, security signals, freshness and the reading above are MCPSkillHub's own measurements; see the methodology. Spot an error? Request a correction or claim the listing.