Luigi's Pizzeria — 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

Related MCP server: hubspot-mcp-server

UCP Primitive Mapping

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