Skip to main content
Glama
Sign In
@giftcardshop/mcp

@giftcardshop/mcp

by i2dor
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

@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

Tool

Kind

Backed by

list_brands

read

GET /v1/brands

search_products

read

GET /v1/products

get_product

read

GET /v1/products/:id (variants + denominations)

get_order_status

read

GET /v1/orders/:id (payment state + reveal availability)

create_order

write

POST /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 }.

Related MCP server: Crossmint Checkout MCP Server

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

Env

Default

Purpose

GCS_API_BASE

https://api.giftcardshop.org

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

Available Tools

5 tools
create_orderCreate orderA

Create an order and get a Lightning invoice to pay. After payment, poll get_order_status for the reveal link. Needs the variantId from get_product.

Inputs: amount (required), currency (required), productId (required), variantId (required), +2 more.

get_order_statusGet order statusA

Check an order: payment state and whether the reveal link (the code) is available yet.

Inputs: orderId (required).

get_productGet productA

Get one product by id, including its denominations/variants (the variantId + amount needed for create_order).

Inputs: id (required).

list_brandsList brandsA

List gift-card brands in the giftcardshop catalog. Optionally filter by country and paginate.

Inputs: limit, offset, country.

search_productsSearch productsB

Search/list purchasable products. Filter by free-text query, brand slug, country, or category.

Inputs: q, brand, limit, country, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clear, distinct purpose: browsing brands, searching products, fetching product details, creating orders, and checking order status. No meaningful overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun snake_case pattern (list_, search_, get_, create_), making the API intuitive and predictable.

    Tool Count5/5

    Five tools cover the essential gift card shop workflow without unnecessary bloat or missing core operations. The count is well-scoped for the domain.

    Completeness5/5

    The toolset covers the full user journey: browse brands, search products, inspect product details/denominations, create an order, and poll order status. No obvious gaps for the stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Lightning Tools MCP Server

      getAlby
      A
      license
      B
      quality
      F
      maintenance
      Enables interaction with lightning addresses and common lightning tools via your LLM, providing Lightning Network functionality through natural language.
      3
      7 npm
      1
      MIT

    • CDK

      cdkbotmcp
      F
      license
      Not graded
      quality
      C
      maintenance
      Buy video game keys, gift cards, and digital subscriptions via x402 USDC payments on Base. 8 tools covering catalog search, price quotes, on-chain purchase confirmation, delivery status, and refunds.
      -

    • Bitrefill MCP Server

      mcpflow
      A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to search for and purchase gift cards, mobile topups, and digital products via Bitrefill, with tools for managing invoices, orders, and account balance.
      12
      178 npm
      2
      MIT