​

uGiftme MCP Server - Model Context Protocol Integration

​

Overview

​

Features

​

18 MCP Tools Available

​

Basic Search Tools (6)

• find_gifts_by_country - Find gift products available in a specific country
• find_gifts_by_category - Find gift products in a specific category
• find_gifts_in_price_range - Find gift products within a specific price range
• find_gifts_by_merchant - Find gift products from a specific merchant
• get_gift_details - Get detailed information about a specific gift product
• list_gift_categories - Get a list of all available gift categories

​

Persona-Based Gift Discovery Tools (12)

• find_gifts_for_runner - Perfect for runners and fitness enthusiasts
• find_gifts_for_foodie - For food lovers and culinary enthusiasts
• find_gifts_for_tech_enthusiast - For technology lovers and gadget enthusiasts
• find_gifts_for_traveler - For travel enthusiasts and frequent flyers
• find_gifts_for_artist - For creative individuals and artists
• find_gifts_for_parent - For parents and family-oriented individuals
• find_gifts_for_professional - For business professionals and career-focused individuals
• find_gifts_for_wellness_seeker - For health and wellness enthusiasts
• find_gifts_for_student - For students and learners
• find_gifts_for_retiree - For retirees and seniors
• find_gifts_for_teenager - For teenagers and young adults
• find_gifts_for_pet_lover - For pet owners and animal lovers

​

Installation

​

Prerequisites

• Node.js 18+ installed
• uGiftme API key

​

Setup

1. Download the MCP Server Download mcp-server.js from the uGiftme integration hub to any directory on your computer.
2. Install Dependencies
   Copy

   npm install @modelcontextprotocol/sdk
   
3. Set Environment Variable
   Copy

   export UGIFTME_API_KEY="your-uGiftme-api-key-here"
   
4. Test the Server
   Copy

   node mcp-server.js
   

​

MCP Client Configuration

​

Claude Desktop Configuration

​

Simple Configuration

{
  "mcpServers": {
    "ugiftme": {
      "command": "node",
      "args": ["/path/to/mcp-server.js"],
      "env": {
        "UGIFTME_API_KEY": "your-uGiftme-api-key-here"
      }
    }
  }
}

​

Example Configuration

{
  "mcpServers": {
    "ugiftme": {
      "command": "node",
      "args": ["/Users/john/Downloads/mcp-server.js"],
      "env": {
        "UGIFTME_API_KEY": "6b4e22b2-c0a5-4c7a-888a-b38eac20b454"
      }
    }
  }
}

​

Other MCP Clients

​

Usage Examples

​

Basic Gift Search

User: "What gifts are available in the UK?"
AI: [Uses find_gifts_by_country tool with country_code="GB"]

​

Persona-Based Recommendations

User: "I need a gift for my friend who loves running"
AI: [Uses find_gifts_for_runner tool with country_code="GB", price_range="mid-range"]

​

Category-Specific Search

User: "Show me food and drink gifts under £50"
AI: [Uses find_gifts_in_price_range tool with min_price=0, max_price=50, currency="GBP"]

​

Merchant-Specific Search

User: "What gifts does ASDA offer?"
AI: [Uses find_gifts_by_merchant tool with merchant_name="ASDA"]

​

Tool Parameters

​

Common Parameters

• country_code (string, optional): Two-letter country code (e.g., “GB”, “US”, “FR”)
• price_range (string, optional): “budget”, “mid-range”, or “premium”

​

Persona-Specific Parameters

• cuisine_type (foodie): “italian”, “asian”, “fine-dining”, “coffee”, “baking”
• tech_category (tech_enthusiast): “gaming”, “electronics”, “crypto”, “mobile”, “computing”
• travel_type (traveler): “business”, “leisure”, “adventure”, “luxury”
• art_medium (artist): “digital”, “traditional”, “music”, “writing”
• family_stage (parent): “new-parent”, “toddler”, “teenager”, “empty-nester”
• profession (professional): “executive”, “teacher”, “healthcare”, “finance”
• wellness_focus (wellness_seeker): “spa”, “fitness”, “mental-health”, “nutrition”
• study_field (student): “science”, “arts”, “business”, “technology”
• interests (retiree/teenager): Various interest keywords
• pet_type (pet_lover): “dog”, “cat”, “bird”, “fish”, “exotic”

​

Response Format

• Product merchant name
• Product code
• Price range and currency
• Categories
• Available countries
• Redemption method
• Availability status

​

Error Handling

• Invalid parameters
• API connection issues
• Product not found
• Authentication failures

​

HTTP API Integration

​

List Available Tools

GET /api/v1/integrations/mcp/tools

​

Get Tool Details

GET /api/v1/integrations/mcp/tools/{toolName}

​

Execute Tool

POST /api/v1/integrations/mcp/tools/{toolName}/execute

​

Integration with Multi-Platform Hub

• Uses the same McpService and PlatformAPIService
• Accesses the same real-time uGiftme product catalog
• Maintains consistency with other platform integrations (Zapier, Monday.com, etc.)

​

Troubleshooting

​

Common Issues

• Install Node.js from https://nodejs.org

• Run: npm install @modelcontextprotocol/sdk

• Set your API key: export UGIFTME_API_KEY="your-key"

• Make the file executable: chmod +x mcp-server.js

• Check that your API key is valid and has proper permissions

​

Testing Your Installation

1. Restart your MCP client (e.g., Claude Desktop)
2. Ask a test question: “Find gift cards for runners in the UK”
3. You should see: uGiftme tools working and returning real product data

​

Support

1. Check the main integration hub documentation
2. Verify your API key is correct
3. Ensure Node.js 18+ is installed
4. Check the server logs for detailed error messages
5. Contact: [email protected]

​

License