@giftcardshop/mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GCS_API_BASE | No | Public API base URL | https://api.giftcardshop.org |
| GCS_INTERNAL_SECRET | No | 64-hex HMAC secret; enables create_order. Unset = read-only. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_brandsA | List gift-card brands in the giftcardshop catalog. Optionally filter by country and paginate. |
| search_productsB | Search/list purchasable products. Filter by free-text query, brand slug, country, or category. |
| get_productA | Get one product by id, including its denominations/variants (the variantId + amount needed for create_order). |
| get_order_statusA | Check an order: payment state and whether the reveal link (the code) is available yet. |
| create_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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
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.
All tool names follow a consistent verb_noun snake_case pattern (list_, search_, get_, create_), making the API intuitive and predictable.
Five tools cover the essential gift card shop workflow without unnecessary bloat or missing core operations. The count is well-scoped for the domain.
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.