English Français العربية

org.giftcardshop/mcp

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • GCS_INTERNAL_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.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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).

الأسئلة الشائعة

ما هو org.giftcardshop/mcp؟

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

كيف أثبّت org.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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج org.giftcardshop/mcp إلى مفتاح API؟

نعم. يتطلب GCS_INTERNAL_SECRET، وتضبطها في إعداداته.

هل org.giftcardshop/mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون org.giftcardshop/mcp؟

ينشره i2dor. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.