English Français العربية

org.giftcardshop/mcp

Registre officiel Autres

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

  • 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

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

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

Questions fréquentes

Qu'est-ce que org.giftcardshop/mcp ?

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

Comment installer org.giftcardshop/mcp ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour org.giftcardshop/mcp ?

Oui. Il attend GCS_INTERNAL_SECRET, à renseigner dans sa configuration.

org.giftcardshop/mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient org.giftcardshop/mcp ?

Il est publié par i2dor. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.