Luigi Ucp Server

A local MCP server implementing Universal Commerce Protocol (UCP) primitives, backed by HubSpot CRM. Built as a proof-of-concept for the AgentFriend blog.

Architecture

[Buyer Agent: Claude]  ←→  MCP (stdio)  ←→  [This Server]  ←→  HubSpot CRM

UCP Primitive Mapping

UCP Primitive	MCP Tool	Backend
BuyerProfile	get_buyer_profile	HubSpot Contacts
ProductCatalog	get_product_catalog	HubSpot Products
Cart	create_cart	in-memory
Order	place_order	HubSpot Deals

Setup

pip install -r requirements.txt
cp .env.example .env
# Add your HubSpot Private App token to .env

Register as MCP server in Claude Code

Add to your ~/.claude/settings.json:

{
  "mcpServers": {
    "luigi-ucp-server": {
      "command": "python",
      "args": ["/absolute/path/to/luigi-ucp-server/server.py"],
      "env": {
        "HUBSPOT_ACCESS_TOKEN": "your-token-here"
      }
    }
  }
}

HubSpot Private App Setup

1. HubSpot → Settings → Integrations → Private Apps
2. Create a Private App with these scopes:
   • crm.objects.contacts.read
   • crm.objects.products.read
   • crm.objects.deals.write
   • crm.objects.line_items.write
   • (Notes are readable via crm.objects.contacts.read — no separate scope needed)
3. Copy the token into .env