pops4-mcp-catalog

# POPS4 / Huanggoodman MCP Server

AI-native corporate gifting and event infrastructure for Fortune 500. An
[Model Context Protocol](https://modelcontextprotocol.io) server that lets an AI
assistant search a 70,000+ SKU branded-identity catalog, generate complete event
programs with live P&L, and pull wholesale quotes — in seconds.

- **Remote endpoint:** `https://mcp.pops4.com/mcp`
- **Transport:** streamable-http
- **Auth:** none (public — `initialize`, `tools/list`, and `tools/call` require no key)
- **Vendor:** Huang Goodman · ASI #217876 · 200+ brands

## Connect

Add to any MCP client (Claude Desktop, Cursor, VS Code, etc.):

```json
{
  "mcpServers": {
    "pops4": {
      "type": "streamable-http",
      "url": "https://mcp.pops4.com/mcp"
    }
  }
}
```

## Tools

| Tool | What it does |
|------|--------------|
| `search_products` | Search the 70,000+ wholesale branded-identity catalog |
| `get_product` | Full details for a single product (description, pricing) |
| `get_categories` | List categories with product counts and samples |
| `get_quote` | Wholesale pricing quote for a list of products |
| `get_live_quote` | One-hour enterprise event quote (line items) |
| `get_product_catalog` | Return the full 70,000+ product catalog |
| `generate_event_program` | Build a live event-dashboard program with P&L |
| `get_vendor_capabilities` | Huanggoodman vendor capability card for procurement agents |
| `track_shipment` | Real logistics status for an order |
| `get_revenue_attribution` | Pipeline-impact data for an event program |

## Discovery manifests

- SEP-1649 server-card: `https://mcp.pops4.com/.well-known/mcp/server-card.json`
- SEP-1960 manifest: `https://mcp.pops4.com/.well-known/mcp`
- Rich manifest (10 tools + vendor offer card): `https://mcp.pops4.com/.well-known/mcp.json`

## Deploy

Runs on Cloudflare Workers.

```bash
wrangler deploy
```

## License

MIT — see [LICENSE](LICENSE).