Giftbit MCP by usefulapi is an MCP server published by io.usefulapi, hosted at giftbit.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 14 tools, including giftbit_list_brands, giftbit_get_brand, giftbit_list_regions, giftbit_list_rewards, giftbit_get_reward.
Browse reward brands, order and cancel rewards, resend emails and check balances in Giftbit.
4,128 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Results per page (Giftbit default 20). |
| offset | integer | Results to skip (Giftbit default 0). |
| region | integer | Region id (from giftbit_list_regions). |
| search | string | Search text in the brand name. |
| embeddable | boolean | Only brands usable for embedded rewards. |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| currencyisocode | string | Currency of the brand prices. |
| max_price_in_cents | integer |
| min_price_in_cents | integer |
{
"name": "giftbit_list_brands",
"title": "List reward brands",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"description": "Results per page (Giftbit default 20).",
"exclusiveMinimum": 0
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Results to skip (Giftbit default 0)."
},
"region": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Region id (from giftbit_list_regions)."
},
"search": {
"type": "string",
"description": "Search text in the brand name."
},
"embeddable": {
"type": "boolean",
"description": "Only brands usable for embedded rewards."
},
"currencyisocode": {
"enum": [
"CAD",
"USD",
"AUD"
],
"type": "string",
"description": "Currency of the brand prices."
},
"max_price_in_cents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"min_price_in_cents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
}
},
"annotations": {
"title": "List reward brands",
"readOnlyHint": true
}
}Get extended information for one brand: allowed prices, terms and disclaimer. GET /brands/{brand_code}.
| Parameter | Type | Description |
|---|---|---|
| brand_code * | string | The brand_code (from giftbit_list_brands). |
{
"name": "giftbit_get_brand",
"title": "Get a reward brand",
"description": "Get extended information for one brand: allowed prices, terms and disclaimer. GET /brands/{brand_code}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"brand_code"
],
"properties": {
"brand_code": {
"type": "string",
"minLength": 1,
"description": "The brand_code (from giftbit_list_brands)."
}
}
},
"annotations": {
"title": "Get a reward brand",
"readOnlyHint": true
}
}List the regions. A region id filters brands and requests a Full Catalog reward (every brand in the region). GET /regions.
No parameters.
{
"name": "giftbit_list_regions",
"title": "List regions",
"description": "List the regions. A region id filters brands and requests a Full Catalog reward (every brand in the region). GET /regions.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List regions",
"readOnlyHint": true
}
}List rewards ordered earlier through the API, with recipient, price, brand, delivery and redemption status. Dates are Pacific time. GET /gifts.
| Parameter | Type | Description |
|---|---|---|
| sort | string | one of ["campaign_id","price_in_cents","recipient_name","recipient_email","delivery_status","status"] |
| limit | integer | Results per page (Giftbit default 20). |
| order | string | Sort direction (Giftbit default desc). |
| offset | integer | Results to skip (Giftbit default 0). |
| status | string | Reward status. |
| campaign_id | string | Only rewards of this order id. |
| delivery_status | string | Email delivery status. |
| recipient_email | string | Only rewards for this recipient email. |
| created_date_less_than | string | Created before this date. |
| created_date_greater_than | string | Created on or after this date. |
{
"name": "giftbit_list_rewards",
"title": "List rewards",
"description": "List rewards ordered earlier through the API, with recipient, price, brand, delivery and redemption status. Dates are Pacific time. GET /gifts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"sort": {
"enum": [
"campaign_id",
"price_in_cents",
"recipient_name",
"recipient_email",
"delivery_status",
"status"
],
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 500,
"description": "Results per page (Giftbit default 20).",
"exclusiveMinimum": 0
},
"order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "Sort direction (Giftbit default desc)."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Results to skip (Giftbit default 0)."
},
"status": {
"enum": [
"SENT_AND_REDEEMABLE",
"REDEEMED",
"TO_CHARITY",
"GIVER_CANCELLED",
"EXPIRED"
],
"type": "string",
"description": "Reward status."
},
"campaign_id": {
"type": "string",
"description": "Only rewards of this order id."
},
"delivery_status": {
"enum": [
"UNSENT",
"DELIVERED",
"UNDELIVERABLE",
"TEMPORARILY_UNDELIVERABLE",
"UNSUBSCRIBED",
"COMPLAINT"
],
"type": "string",
"description": "Email delivery status."
},
"recipient_email": {
"type": "string",
"description": "Only rewards for this recipient email."
},
"created_date_less_than": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Created before this date."
},
"created_date_greater_than": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Created on or after this date."
}
}
},
"annotations": {
"title": "List rewards",
"readOnlyHint": true
}
}Get one reward by its uuid: recipient, price, brand, delivery and redemption status. GET /gifts/{uuid}.
| Parameter | Type | Description |
|---|---|---|
| uuid * | string | The reward uuid (from giftbit_list_rewards or an order response). |
{
"name": "giftbit_get_reward",
"title": "Get a reward",
"description": "Get one reward by its uuid: recipient, price, brand, delivery and redemption status. GET /gifts/{uuid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"uuid"
],
"properties": {
"uuid": {
"type": "string",
"minLength": 1,
"description": "The reward uuid (from giftbit_list_rewards or an order response)."
}
}
},
"annotations": {
"title": "Get a reward",
"readOnlyHint": true
}
}Get the status of an order (email or shortlink), with its contacts, price, brand codes and delivery counts. GET /campaign/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The order id you supplied, or the order uuid Giftbit assigned. |
{
"name": "giftbit_get_order",
"title": "Get an order",
"description": "Get the status of an order (email or shortlink), with its contacts, price, brand codes and delivery counts. GET /campaign/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The order id you supplied, or the order uuid Giftbit assigned."
}
}
},
"annotations": {
"title": "Get an order",
"readOnlyHint": true
}
}Get the claim URLs of a shortlink or direct link order. The URLs are ready a short time after the order. GET /links/{id}.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The client-provided id of the link order. |
{
"name": "giftbit_get_link_urls",
"title": "Get link URLs",
"description": "Get the claim URLs of a shortlink or direct link order. The URLs are ready a short time after the order. GET /links/{id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"minLength": 1,
"description": "The client-provided id of the link order."
}
}
},
"annotations": {
"title": "Get link URLs",
"readOnlyHint": true
}
}Get the account balance by currency. Adding funds is not offered here: do it in the Giftbit web interface. GET /funds.
No parameters.
{
"name": "giftbit_get_funds",
"title": "Get account funds",
"description": "Get the account balance by currency. Adding funds is not offered here: do it in the Giftbit web interface. GET /funds.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get account funds",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| expiry | string | Last claim date (yyyy-mm-dd, at most one year away). Makes a promotional reward. |
| region | string | Region id for a Full Catalog reward (from giftbit_list_regions). |
| confirm * | object | Repeat the order values exactly (brand, price, recipient, count). Show these values to the user and get their OK first. |
| message | string | Email message (required without gift_template). |
| subject | string | Email subject (required without gift_template). |
| lastname | string | Recipient last name. |
| order_id * | string | Your unique id for this order. Reuse it only to retry the same order; a new id makes a new order. |
| firstname | string | Recipient first name. |
| brand_codes | array | One or more brand_code values from giftbit_list_brands. Several codes let the recipient pick one. |
| gift_template | string | Giftbit template id (uppercase identifier from the web interface). |
| price_in_cents * | integer | Reward value in cents, for example 2500 for 25.00. |
| recipient_email * | string | The one recipient email address. |
{
"name": "giftbit_create_email_reward",
"title": "Order an email reward",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"price_in_cents",
"recipient_email",
"confirm"
],
"properties": {
"expiry": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last claim date (yyyy-mm-dd, at most one year away). Makes a promotional reward."
},
"region": {
"type": "string",
"minLength": 1,
"description": "Region id for a Full Catalog reward (from giftbit_list_regions)."
},
"confirm": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "Echo of the reward uuid."
},
"expiry": {
"type": "string",
"description": "Echo of expiry."
},
"region": {
"type": "string",
"description": "Echo of region."
},
"message": {
"type": "string",
"description": "Echo of the message, exactly."
},
"subject": {
"type": "string",
"description": "Echo of the subject, exactly."
},
"lastname": {
"type": "string",
"description": "Echo of the recipient last name."
},
"firstname": {
"type": "string",
"description": "Echo of the recipient first name."
},
"brand_code": {
"type": "string",
"description": "Echo of brand_code (embedded rewards)."
},
"link_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Echo of link_count."
},
"brand_codes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Echo of brand_codes, in the same order."
},
"gift_template": {
"type": "string",
"description": "Echo of gift_template."
},
"price_in_cents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Echo of price_in_cents."
},
"recipient_email": {
"type": "string",
"description": "Echo of the recipient email address."
}
},
"description": "Repeat the order values exactly (brand, price, recipient, count). Show these values to the user and get their OK first."
},
"message": {
"type": "string",
"description": "Email message (required without gift_template)."
},
"subject": {
"type": "string",
"description": "Email subject (required without gift_template)."
},
"lastname": {
"type": "string",
"description": "Recipient last name."
},
"order_id": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Your unique id for this order. Reuse it only to retry the same order; a new id makes a new order."
},
"firstname": {
"type": "string",
"description": "Recipient first name."
},
"brand_codes": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "One or more brand_code values from giftbit_list_brands. Several codes let the recipient pick one."
},
"gift_template": {
"type": "string",
"minLength": 1,
"description": "Giftbit template id (uppercase identifier from the web interface)."
},
"price_in_cents": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Reward value in cents, for example 2500 for 25.00.",
"exclusiveMinimum": 0
},
"recipient_email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "The one recipient email address."
}
}
},
"annotations": {
"title": "Order an email reward",
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| expiry | string | Last claim date (yyyy-mm-dd, at most one year away). |
| region | string | Region id for a Full Catalog reward (from giftbit_list_regions). |
| confirm * | object | Repeat the order values exactly (brand, price, recipient, count). Show these values to the user and get their OK first. |
| message | string | Landing-page message (required without gift_template). |
| subject | string | Reward subject (required without gift_template). |
| order_id * | string | Your unique id for this order. Reuse it only to retry the same order; a new id makes a new order. |
| link_count * | integer | How many shortlink rewards to create. |
| brand_codes | array | One or more brand_code values from giftbit_list_brands. Several codes let the recipient pick one. |
| gift_template | string | Giftbit template id (uppercase identifier from the web interface). |
| price_in_cents * | integer | Reward value in cents, for example 2500 for 25.00. |
{
"name": "giftbit_create_shortlink_order",
"title": "Order shortlink rewards",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"price_in_cents",
"link_count",
"confirm"
],
"properties": {
"expiry": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last claim date (yyyy-mm-dd, at most one year away)."
},
"region": {
"type": "string",
"minLength": 1,
"description": "Region id for a Full Catalog reward (from giftbit_list_regions)."
},
"confirm": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "Echo of the reward uuid."
},
"expiry": {
"type": "string",
"description": "Echo of expiry."
},
"region": {
"type": "string",
"description": "Echo of region."
},
"message": {
"type": "string",
"description": "Echo of the message, exactly."
},
"subject": {
"type": "string",
"description": "Echo of the subject, exactly."
},
"lastname": {
"type": "string",
"description": "Echo of the recipient last name."
},
"firstname": {
"type": "string",
"description": "Echo of the recipient first name."
},
"brand_code": {
"type": "string",
"description": "Echo of brand_code (embedded rewards)."
},
"link_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Echo of link_count."
},
"brand_codes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Echo of brand_codes, in the same order."
},
"gift_template": {
"type": "string",
"description": "Echo of gift_template."
},
"price_in_cents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Echo of price_in_cents."
},
"recipient_email": {
"type": "string",
"description": "Echo of the recipient email address."
}
},
"description": "Repeat the order values exactly (brand, price, recipient, count). Show these values to the user and get their OK first."
},
"message": {
"type": "string",
"description": "Landing-page message (required without gift_template)."
},
"subject": {
"type": "string",
"description": "Reward subject (required without gift_template)."
},
"order_id": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Your unique id for this order. Reuse it only to retry the same order; a new id makes a new order."
},
"link_count": {
"type": "integer",
"maximum": 1000,
"description": "How many shortlink rewards to create.",
"exclusiveMinimum": 0
},
"brand_codes": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "One or more brand_code values from giftbit_list_brands. Several codes let the recipient pick one."
},
"gift_template": {
"type": "string",
"minLength": 1,
"description": "Giftbit template id (uppercase identifier from the web interface)."
},
"price_in_cents": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Reward value in cents, for example 2500 for 25.00.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Order shortlink rewards",
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| expiry | string | Last claim date (yyyy-mm-dd, at most one year away). |
| region | string | Region id for a Full Catalog reward (from giftbit_list_regions). |
| confirm * | object | Repeat the order values exactly (brand, price, recipient, count). Show these values to the user and get their OK first. |
| order_id * | string | Your unique id for this order. Reuse it only to retry the same order; a new id makes a new order. |
| link_count | integer | How many direct links to create (default 1). |
| brand_codes | array | One or more brand_code values from giftbit_list_brands. Several codes let the recipient pick one. |
| price_in_cents * | integer | Reward value in cents, for example 2500 for 25.00. |
{
"name": "giftbit_create_direct_link_order",
"title": "Order direct link rewards",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"price_in_cents",
"confirm"
],
"properties": {
"expiry": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last claim date (yyyy-mm-dd, at most one year away)."
},
"region": {
"type": "string",
"minLength": 1,
"description": "Region id for a Full Catalog reward (from giftbit_list_regions)."
},
"confirm": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "Echo of the reward uuid."
},
"expiry": {
"type": "string",
"description": "Echo of expiry."
},
"region": {
"type": "string",
"description": "Echo of region."
},
"message": {
"type": "string",
"description": "Echo of the message, exactly."
},
"subject": {
"type": "string",
"description": "Echo of the subject, exactly."
},
"lastname": {
"type": "string",
"description": "Echo of the recipient last name."
},
"firstname": {
"type": "string",
"description": "Echo of the recipient first name."
},
"brand_code": {
"type": "string",
"description": "Echo of brand_code (embedded rewards)."
},
"link_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Echo of link_count."
},
"brand_codes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Echo of brand_codes, in the same order."
},
"gift_template": {
"type": "string",
"description": "Echo of gift_template."
},
"price_in_cents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Echo of price_in_cents."
},
"recipient_email": {
"type": "string",
"description": "Echo of the recipient email address."
}
},
"description": "Repeat the order values exactly (brand, price, recipient, count). Show these values to the user and get their OK first."
},
"order_id": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Your unique id for this order. Reuse it only to retry the same order; a new id makes a new order."
},
"link_count": {
"type": "integer",
"maximum": 1000,
"description": "How many direct links to create (default 1).",
"exclusiveMinimum": 0
},
"brand_codes": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"minItems": 1,
"description": "One or more brand_code values from giftbit_list_brands. Several codes let the recipient pick one."
},
"price_in_cents": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Reward value in cents, for example 2500 for 25.00.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Order direct link rewards",
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| confirm * | object | Repeat the order values exactly (brand, price, recipient, count). Show these values to the user and get their OK first. |
| order_id * | string | Your unique id for this order. Reuse it only to retry the same order; a new id makes a new order. |
| brand_code * | string | The brand_code (from giftbit_list_brands, embeddable brands). |
| price_in_cents * | integer | Reward value in cents, for example 2500 for 25.00. |
{
"name": "giftbit_create_embedded_reward",
"title": "Order an embedded reward",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"order_id",
"brand_code",
"price_in_cents",
"confirm"
],
"properties": {
"confirm": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "Echo of the reward uuid."
},
"expiry": {
"type": "string",
"description": "Echo of expiry."
},
"region": {
"type": "string",
"description": "Echo of region."
},
"message": {
"type": "string",
"description": "Echo of the message, exactly."
},
"subject": {
"type": "string",
"description": "Echo of the subject, exactly."
},
"lastname": {
"type": "string",
"description": "Echo of the recipient last name."
},
"firstname": {
"type": "string",
"description": "Echo of the recipient first name."
},
"brand_code": {
"type": "string",
"description": "Echo of brand_code (embedded rewards)."
},
"link_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Echo of link_count."
},
"brand_codes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Echo of brand_codes, in the same order."
},
"gift_template": {
"type": "string",
"description": "Echo of gift_template."
},
"price_in_cents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Echo of price_in_cents."
},
"recipient_email": {
"type": "string",
"description": "Echo of the recipient email address."
}
},
"description": "Repeat the order values exactly (brand, price, recipient, count). Show these values to the user and get their OK first."
},
"order_id": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Your unique id for this order. Reuse it only to retry the same order; a new id makes a new order."
},
"brand_code": {
"type": "string",
"minLength": 1,
"description": "The brand_code (from giftbit_list_brands, embeddable brands)."
},
"price_in_cents": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Reward value in cents, for example 2500 for 25.00.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Order an embedded reward",
"destructiveHint": true
}
}SENDS THE REWARD EMAIL AGAIN to the recipient. Email rewards only; embedded rewards cannot be resent. PUT /gifts/{uuid}.
| Parameter | Type | Description |
|---|---|---|
| uuid * | string | The reward uuid. |
| confirm * | object | Repeat the order values exactly (brand, price, recipient, count). Show these values to the user and get their OK first. |
{
"name": "giftbit_resend_reward",
"title": "Resend a reward",
"description": "SENDS THE REWARD EMAIL AGAIN to the recipient. Email rewards only; embedded rewards cannot be resent. PUT /gifts/{uuid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"uuid",
"confirm"
],
"properties": {
"uuid": {
"type": "string",
"minLength": 1,
"description": "The reward uuid."
},
"confirm": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "Echo of the reward uuid."
},
"expiry": {
"type": "string",
"description": "Echo of expiry."
},
"region": {
"type": "string",
"description": "Echo of region."
},
"message": {
"type": "string",
"description": "Echo of the message, exactly."
},
"subject": {
"type": "string",
"description": "Echo of the subject, exactly."
},
"lastname": {
"type": "string",
"description": "Echo of the recipient last name."
},
"firstname": {
"type": "string",
"description": "Echo of the recipient first name."
},
"brand_code": {
"type": "string",
"description": "Echo of brand_code (embedded rewards)."
},
"link_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Echo of link_count."
},
"brand_codes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Echo of brand_codes, in the same order."
},
"gift_template": {
"type": "string",
"description": "Echo of gift_template."
},
"price_in_cents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Echo of price_in_cents."
},
"recipient_email": {
"type": "string",
"description": "Echo of the recipient email address."
}
},
"description": "Repeat the order values exactly (brand, price, recipient, count). Show these values to the user and get their OK first."
}
}
},
"annotations": {
"title": "Resend a reward",
"destructiveHint": true
}
}CANCELS A REWARD. Not possible once the recipient has claimed it; embedded rewards cannot be cancelled. DELETE /gifts/{uuid}.
| Parameter | Type | Description |
|---|---|---|
| uuid * | string | The reward uuid. |
| confirm * | object | Repeat the order values exactly (brand, price, recipient, count). Show these values to the user and get their OK first. |
{
"name": "giftbit_cancel_reward",
"title": "Cancel a reward",
"description": "CANCELS A REWARD. Not possible once the recipient has claimed it; embedded rewards cannot be cancelled. DELETE /gifts/{uuid}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"uuid",
"confirm"
],
"properties": {
"uuid": {
"type": "string",
"minLength": 1,
"description": "The reward uuid."
},
"confirm": {
"type": "object",
"properties": {
"uuid": {
"type": "string",
"description": "Echo of the reward uuid."
},
"expiry": {
"type": "string",
"description": "Echo of expiry."
},
"region": {
"type": "string",
"description": "Echo of region."
},
"message": {
"type": "string",
"description": "Echo of the message, exactly."
},
"subject": {
"type": "string",
"description": "Echo of the subject, exactly."
},
"lastname": {
"type": "string",
"description": "Echo of the recipient last name."
},
"firstname": {
"type": "string",
"description": "Echo of the recipient first name."
},
"brand_code": {
"type": "string",
"description": "Echo of brand_code (embedded rewards)."
},
"link_count": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Echo of link_count."
},
"brand_codes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Echo of brand_codes, in the same order."
},
"gift_template": {
"type": "string",
"description": "Echo of gift_template."
},
"price_in_cents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Echo of price_in_cents."
},
"recipient_email": {
"type": "string",
"description": "Echo of the recipient email address."
}
},
"description": "Repeat the order values exactly (brand, price, recipient, count). Show these values to the user and get their OK first."
}
}
},
"annotations": {
"title": "Cancel a reward",
"destructiveHint": true
}
}Tools for Giftbit, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which reward brands can I order in the US, and what are their price limits?"; "Show me the rewards we sent last week and which ones are still unclaimed."; "Send a 25 USD Amazon reward by email to jane@example.com (I will confirm the details first).". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Giftbit data. Free plan: 50 tool calls per month. Run giftbit_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run giftbit_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run giftbit_upgrade without a plan: it returns both plans, each with a payment link for the user to open. giftbit_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.