Skip to main content
POST
/
api
/
v1
/
integrations
/
mcp
/
tools
/
{toolName}
/
execute
curl --request POST \
  --url https://api.ugift.me/api/v1/integrations/mcp/tools/{toolName}/execute \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "country_code": "GB",
  "price_range": "mid-range"
}
'
{
  "success": true,
  "tool": "find_gifts_for_runner",
  "data": {
    "success": true,
    "data": [
      {
        "merchant": "Nike",
        "product_code": "NIKE-GB",
        "currency": "GBP",
        "min_price": 10,
        "max_price": 500,
        "categories": [
          "sports",
          "fashion",
          "fitness"
        ],
        "countries": [
          "GB",
          "US",
          "FR"
        ],
        "redemption": "online",
        "available": true,
        "description": "Nike gift card for sports and fitness products"
      }
    ],
    "count": 15
  }
}

Authorizations

​
X-API-Key
string
header
required

Your uGiftme business API key for authentication.

Format: UUID format (e.g., 6b4e22b2-c0a5-4c7a-888a-b38eac20b454) Required: All endpoints require this header Permissions: Must have business-level access with Zapier integration permissions

Example: X-API-Key: 6b4e22b2-c0a5-4c7a-888a-b38eac20b454

Path Parameters

​
toolName
enum<string>
required

The name of the MCP tool to execute

Available options:
find_gifts_by_country,
find_gifts_by_category,
find_gifts_in_price_range,
find_gifts_by_merchant,
get_gift_details,
list_gift_categories,
find_gifts_for_runner,
find_gifts_for_foodie,
find_gifts_for_tech_enthusiast,
find_gifts_for_traveler,
find_gifts_for_artist,
find_gifts_for_parent,
find_gifts_for_professional,
find_gifts_for_wellness_seeker,
find_gifts_for_student,
find_gifts_for_retiree,
find_gifts_for_teenager,
find_gifts_for_pet_lover

Body

application/json
​
country_code
string
required

Two-letter country code

Example:

"GB"

Response

MCP tool executed successfully

​
success
boolean
required

Indicates if the execution was successful

Example:

true

​
tool
string
required

The tool that was executed

Example:

"find_gifts_for_runner"

​
data
object
required

Tool execution results