{
  "markdown": "# @giftcardshop/mcp\n\nMCP server that lets AI agents browse the giftcardshop catalog and buy gift\ncards with Lightning - no account, no signup. The agent pays a Lightning\ninvoice and receives a single-view reveal link with the code.\n\nRead tools work against the live public API with no key. `create_order` is\nearly access: it needs the shared `GCS_INTERNAL_SECRET` (request one at\nhttps://giftcardshop.org/contact); without it the read tools still work and\n`create_order` reports that it is not configured.\n\n## Tools\n\n| Tool | Kind | Backed by |\n|------|------|-----------|\n| `list_brands` | read | `GET /v1/brands` |\n| `search_products` | read | `GET /v1/products` |\n| `get_product` | read | `GET /v1/products/:id` (variants + denominations) |\n| `get_order_status` | read | `GET /v1/orders/:id` (payment state + reveal availability) |\n| `create_order` | write | `POST /internal/agent-orders` (HMAC) -> Lightning invoice |\n\nRead tools pass the API JSON through verbatim. `create_order` returns\n`{ orderId, invoiceId, invoiceUrl, bolt11?, sats?, total, currency, expiresAt }`.\n\n## Run\n\n```bash\n# read-only (browsing works, create_order reports \"not configured\")\nnpx @giftcardshop/mcp\n\n# with checkout enabled\nGCS_INTERNAL_SECRET=<64-hex> npx @giftcardshop/mcp\n```\n\nClaude Desktop / any MCP client (stdio):\n\n```json\n{\n  \"mcpServers\": {\n    \"giftcardshop\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@giftcardshop/mcp\"],\n      \"env\": { \"GCS_INTERNAL_SECRET\": \"<64-hex>\" }\n    }\n  }\n}\n```\n\n## Config\n\n| Env | Default | Purpose |\n|-----|---------|---------|\n| `GCS_API_BASE` | `https://api.giftcardshop.org` | public API base |\n| `GCS_INTERNAL_SECRET` | (unset) | 64-hex HMAC secret; enables `create_order`. Unset = read-only. |\n\n## Checkout (create_order)\n\n`create_order` POSTs to `POST /internal/agent-orders`, HMAC-signed with\n`GCS_INTERNAL_SECRET` (header `x-internal-sig`), and returns a Lightning\ninvoice. Pay it, then poll `get_order_status` for the single-view reveal\nlink. No Nostr identity and no partner account required.\n\n## Roadmap\n\n- L402 (Lightning HTTP 402) so an agent pays per-call without a human step.\n- A hosted remote MCP over HTTP, so there is nothing to install.\n- A btcrecharge MCP for mobile top-ups (same shape).\n",
  "bytes": 2239,
  "sha": "fbc49f9010d46442208bacfdd957b1b1f323e9d882319fff978c7b32171480fe",
  "repo_slug": "i2dor/giftcardshop-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_org_giftcardshop_mcp_c0807768/readme"
}