English Français العربية

org.giftcardshop/mcp

Official registry Other

Browse the giftcardshop catalog and buy gift cards with Lightning over MCP. No account, no signup.

Source code Documentation

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).

NPM package @giftcardshop/mcp
Claude Code 
claude mcp add org-giftcardshop-mcp -e 'GCS_INTERNAL_SECRET=<your gcs_internal_secret>' -e 'GCS_API_BASE=<GCS_API_BASE>' -- npx -y @giftcardshop/mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "org-giftcardshop-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@giftcardshop/mcp@0.1.1"
            ],
            "env": {
                "GCS_INTERNAL_SECRET": "<your gcs_internal_secret>",
                "GCS_API_BASE": "<GCS_API_BASE>"
            }
        }
    }
}

Environment variables

  • GCS_INTERNAL_SECRET secret 64-hex HMAC secret that enables create_order (Lightning checkout). Browsing tools work without it. Requested at https://giftcardshop.org/contact.
  • GCS_API_BASE Override the public API base. Defaults to https://api.giftcardshop.org.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @giftcardshop/mcp
  2. Tools
  3. Run
  4. Config
  5. Checkout (create_order)
  6. Roadmap

@giftcardshop/mcp

MCP server that lets AI agents browse the giftcardshop catalog and buy gift cards with Lightning - no account, no signup. The agent pays a Lightning invoice and receives a single-view reveal link with the code.

Read tools work against the live public API with no key. create_order is early access: it needs the shared GCS_INTERNAL_SECRET (request one at https://giftcardshop.org/contact); without it the read tools still work and create_order reports that it is not configured.

Tools

ToolKindBacked by
list_brandsreadGET /v1/brands
search_productsreadGET /v1/products
get_productreadGET /v1/products/:id (variants + denominations)
get_order_statusreadGET /v1/orders/:id (payment state + reveal availability)
create_orderwritePOST /internal/agent-orders (HMAC) -> Lightning invoice

Read tools pass the API JSON through verbatim. create_order returns { orderId, invoiceId, invoiceUrl, bolt11?, sats?, total, currency, expiresAt }.

Run

# read-only (browsing works, create_order reports "not configured")
npx @giftcardshop/mcp

# with checkout enabled
GCS_INTERNAL_SECRET=<64-hex> npx @giftcardshop/mcp

Claude Desktop / any MCP client (stdio):

{
  "mcpServers": {
    "giftcardshop": {
      "command": "npx",
      "args": ["-y", "@giftcardshop/mcp"],
      "env": { "GCS_INTERNAL_SECRET": "<64-hex>" }
    }
  }
}

Config

EnvDefaultPurpose
GCS_API_BASEhttps://api.giftcardshop.orgpublic API base
GCS_INTERNAL_SECRET(unset)64-hex HMAC secret; enables create_order. Unset = read-only.

Checkout (create_order)

create_order POSTs to POST /internal/agent-orders, HMAC-signed with GCS_INTERNAL_SECRET (header x-internal-sig), and returns a Lightning invoice. Pay it, then poll get_order_status for the single-view reveal link. No Nostr identity and no partner account required.

Roadmap

  • L402 (Lightning HTTP 402) so an agent pays per-call without a human step.
  • A hosted remote MCP over HTTP, so there is nothing to install.
  • A btcrecharge MCP for mobile top-ups (same shape).

Frequently asked questions

What is org.giftcardshop/mcp?

Browse the giftcardshop catalog and buy gift cards with Lightning over MCP. No account, no signup.

How do I install org.giftcardshop/mcp?

It runs on your machine. In Claude Code: claude mcp add org-giftcardshop-mcp -e 'GCS_INTERNAL_SECRET=<your gcs_internal_secret>' -e 'GCS_API_BASE=<GCS_API_BASE>' -- npx -y @giftcardshop/mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does org.giftcardshop/mcp need an API key?

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

Is org.giftcardshop/mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains org.giftcardshop/mcp?

It is published by i2dor. 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.