MCP server
Giftbit MCP by usefulapi
Browse reward brands, order and cancel rewards, resend emails and check balances in…
- Runs
- Remotely
- Version
- 1.4.0
- Listing updated
- 4 days ago
About Giftbit MCP by usefulapi
Giftbit MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Browse reward brands, order and cancel rewards, resend emails and check balances in Giftbit.
Install
Run in a terminal
claude mcp add --transport http giftbit https://giftbit.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://giftbit.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"giftbit": {
"url": "https://giftbit.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"giftbit": {
"type": "http",
"url": "https://giftbit.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"giftbit": {
"serverUrl": "https://giftbit.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"giftbit": {
"type": "http",
"url": "https://giftbit.usefulapi.io/mcp"
}
}
}Tools this server provides (14)
Read directly from the server.
- giftbit_list_brands
- List reward brands with brand_code, name, image and allowed price. Use the brand_code in an order. Filter by region, currency, price range, search text or embeddable. GET /brands.
- giftbit_get_brand
- Get extended information for one brand: allowed prices, terms and disclaimer. GET /brands/{brand_code}.
- giftbit_list_regions
- List the regions. A region id filters brands and requests a Full Catalog reward (every brand in the region). GET /regions.
- giftbit_list_rewards
- List rewards ordered earlier through the API, with recipient, price, brand, delivery and redemption status. Dates are Pacific time. GET /gifts.
- giftbit_get_reward
- Get one reward by its uuid: recipient, price, brand, delivery and redemption status. GET /gifts/{uuid}.
- giftbit_get_order
- Get the status of an order (email or shortlink), with its contacts, price, brand codes and delivery counts. GET /campaign/{id}.
- giftbit_get_link_urls
- Get the claim URLs of a shortlink or direct link order. The URLs are ready a short time after the order. GET /links/{id}.
- giftbit_get_funds
- Get the account balance by currency. Adding funds is not offered here: do it in the Giftbit web interface. GET /funds.
- giftbit_create_email_reward
- ORDERS A REWARD AND CHARGES THE ACCOUNT. Giftbit emails the reward to one recipient. Give brand_codes, region or gift_template, plus price_in_cents. Without gift_template, message and subject are required. In Testbed the email goes to the account owner, not the recipient. POST /campaign.
- giftbit_create_shortlink_order
- ORDERS REWARDS AND CHARGES THE ACCOUNT. Creates shortlink rewards (landing-page links) that you distribute yourself. No recipient is needed. Set link_count. Read them with giftbit_get_link_urls. POST /campaign with delivery_type SHORTLINK.
- giftbit_create_direct_link_order
- ORDERS REWARDS AND CHARGES THE ACCOUNT. Creates direct links that go straight to the claim steps, with minimal Giftbit branding. Give brand_codes (one region) or region for a Full Catalog. URLs come back in the response. POST /direct_links.
- giftbit_create_embedded_reward
- ORDERS ONE REWARD AND CHARGES THE ACCOUNT. Returns a gift_link where the reward code is revealed at once, for in-app delivery. Embedded rewards are claimed at once and cannot be cancelled. POST /embedded.
- giftbit_resend_reward
- SENDS THE REWARD EMAIL AGAIN to the recipient. Email rewards only; embedded rewards cannot be resent. PUT /gifts/{uuid}.
- giftbit_cancel_reward
- CANCELS A REWARD. Not possible once the recipient has claimed it; embedded rewards cannot be cancelled. DELETE /gifts/{uuid}.
Giftbit MCP by usefulapi FAQ
How do I add Giftbit MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http giftbit https://giftbit.usefulapi.io/mcp