What is Giftcardshop MCP?

Giftcardshop MCP is a Model Context Protocol server. Browse the giftcardshop catalog and buy gift cards with Lightning over MCP. No account, no signup.

How do I install Giftcardshop MCP?

Install or launch Giftcardshop MCP with npx -y @giftcardshop/mcp.

What environment variables does Giftcardshop MCP use?

Giftcardshop MCP lists these environment variables: GCS_API_BASE, GCS_INTERNAL_SECRET.

Which transports does Giftcardshop MCP support?

Giftcardshop MCP is listed with stdio transport support.

Where can I verify Giftcardshop MCP?

Verify Giftcardshop MCP against its upstream source at https://github.com/i2dor/giftcardshop-mcp.

Giftcardshop MCP

org.giftcardshop/mcp

Documentation

Installation

Run with npx @giftcardshop/mcp.

Configuration

GCS_API_BASE: public API base, defaults to https://api.giftcardshop.org
GCS_INTERNAL_SECRET: optional 64-hex HMAC secret that enables create_order

Capabilities

list_brands: list brands from GET /v1/brands
search_products: search products from GET /v1/products
get_product: fetch product details and variants from GET /v1/products/:id
get_order_status: fetch payment state and reveal availability from GET /v1/orders/:id
create_order: create a Lightning-backed order through POST /internal/agent-orders

Limitations

create_order is unavailable until GCS_INTERNAL_SECRET is configured
Read tools depend on the live public giftcardshop API
The checkout flow is early access and still server-side dependent