io.github.HuangGoodmanAgency/pops4-mcp-catalog

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

AI-native corporate gifting & event infrastructure for Fortune 500. 70K products, 200+ brands.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "pops4-mcp-catalog": {
      "url": "https://mcp.pops4.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (13)

• render_proof

  Render an indicative placement image showing a buyer their logo on a product, and return its URL so you can show it in the conversation. Takes a product slug and an https URL to the buyer's logo. Returns a 1200x630 image that needs no login. This is NOT a production proof: position and scale are indicative and the desk issues the real one. Say so when you show it. Use after search_products or get_product, once a buyer wants to see how something would look.

  Parameters:

  • slug (required) — string — Product slug from search_products or get_product
  • logo_url — string — https URL to the buyer's logo image. Omit to render a marked placeholder area.
  • company_name — string — Buyer company name, shown beside the product

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• request_program

  Submit a programme request to the named-account desk so a person can act on it. This is the only tool that writes: it records the buyer, the programme and the products chosen, and returns confirmation. It does NOT place an order, begin production, take payment or contact the buyer — a person reviews it and replies. When products are supplied it also opens the buyer a live Corporate Store holding that selection, and returns the URL in store_url for you to give them directly. Use once the buyer has chosen products or a programme and wants to proceed.

  Parameters:

  • email (required) — string — Buyer work email. Required.
  • event — string — What this is for, e.g. "Analyst day, March, 300 attendees"
  • items — array — Products chosen, up to 12, from search_products or generate_event_program
  • notes — string — Anything the desk should know. Max 118 characters.
  • company — string — Buyer company
  • per_head — string — Per-attendee cost, if quoted
  • brand_tier — string — Programme tier if one was chosen
  • contact_name — string — Buyer name
  • program_total — string — Quoted programme total, if quoted
  • attendee_count — number — Headcount or unit count

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• brand_carriage_estimate

  Calculate what a branded programme costs per thousand impressions across the four populations that carry a brand — employees, gig and contract workers, vendors, peers — and compare it against a CPM the buyer supplies. Returns programme cost, annual impressions, cost per thousand, the multiple against bought media, and one cited Nielsen figure with its caveat. Read-only. Use when a buyer asks what a culture or brand programme is worth, or how to justify the spend. Supply ANY of the four populations — employees are not required, so a vendor-and-peer-only programme can be modelled.

  Parameters:

  • peers — number — Peer count — the buyer estimates this
  • vendors — number — Vendor count — the buyer estimates this
  • your_cpm — number — The buyer's own CPM from their media plan, USD
  • employees — number — Employee headcount (optional, like all four populations)
  • gig_workers — number — Gig and contract worker count
  • cost_per_peer — number — Programme cost per peer, USD
  • cost_per_vendor — number — Programme cost per vendor, USD
  • cost_per_worker — number — Programme cost per worker, USD
  • cost_per_employee — number — Programme cost per employee, USD
  • impressions_per_peer — number — Default 1500
  • impressions_per_vendor — number — Default 1200
  • impressions_per_worker — number — Default 600
  • impressions_per_employee — number — Impressions per employee per year (default 900)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search_products

  Search the wholesale catalogue by keyword, category, brand, price range or occasion. Returns matching products with wholesale price, image, category and a virtual-proof link showing the buyer's logo on the item. Use this for any request to find specific products. 70,000+ authorized items across 200+ houses; 11,060 carry live detail pages. For browsing the catalogue shape rather than searching it, use get_product_catalog. Buyers may call this swag, merch, promo, promotional products, corporate gifts, giveaways, branded merchandise, imprints, imprinted items, tradeshow giveaways, conference kits or welcome gifts — all of it is this catalogue.

  Parameters:

  • brand — string — POPS4 for corporate/wholesale, Prosecco4 for weddings/events
  • limit — number — Max results to return (default 10, max 50)
  • query — string — Text search on product title (e.g., "nike backpack", "yeti tumbler", "branded polo")
  • category — string — Product category filter (e.g., "Backpacks", "Drinkware", "Apparel", "Pens")
  • occasion — string — Filter by occasion/use case
  • price_max — number — Maximum wholesale price in USD
  • price_min — number — Minimum wholesale price in USD

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_product

  Return complete detail for one product, identified by its slug: description, wholesale price, category, brand, care instructions, occasion tags and a virtual-proof link. Use after search_products when one item needs full detail before quoting it.

  Parameters:

  • slug (required) — string — Product slug (from search results)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_categories

  List every product category with its item count and sample products. Use to establish what the catalogue covers before searching, or to answer what kinds of items are available.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_quote

  Build a wholesale quote from a list of product slugs and quantities. Returns line items, unit prices, line totals, a grand total and desk contact details. Use for a straightforward priced list. Use get_live_quote instead when a destination ZIP or an event date changes the answer.

  Parameters:

  • items (required) — array — Array of products and quantities to quote

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_vendor_capabilities

  Return the vendor capability card a procurement team needs to open an account: legal entity, registrations, production model, imprint and proofing process, lead times, blind-ship policy and terms. Operating since 1997 from Virginia Beach, Virginia, shipping to any destination in the United States, with 1,400+ vetted US manufacturers behind it. Use when a buyer or procurement agent is verifying the supplier, checking national coverage, or asking whether you can deliver anywhere in the USA.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• generate_event_program

  Build a complete event programme for a given attendee count and budget tier. Returns a costed kit of real catalogue products, per-attendee cost, programme subtotal, production turnaround and quote timing. Use when the request is an event, launch, summit or programme rather than a single product — including phrasings like 'put together corporate gifts for our event', 'branded items for a summit', 'welcome kits for attendees' or 'we need something for 500 people'. Ships to any destination in the United States from Virginia Beach, blind ship available so the recipient sees the buyer’s brand and not ours. Supply budget_per_head to have the tier chosen automatically. Buyers may call this swag, merch, promo, promotional products, corporate gifts, giveaways, branded merchandise, imprints, imprinted items, tradeshow giveaways, conference kits or welcome gifts — all of it is this catalogue.

  Parameters:

  • attendee_count (required) — number — Number of attendees / kits
  • keywords — string — Optional event theme / keywords (e.g. "golf coastal", "holiday gala", "tech summit", "wellness retreat") to bias product selection toward the occasion.
  • brand_tier — string — Program tier. essential ($35-75/head) internal events & training; professional ($75-150) client meetings; executive ($150-300) VP+ & board events; luxury ($300-600) C-suite, board members & partners; bespoke ($600-1200) custom curation (concierge-built, no auto-quote); white_glove ($1200+) fully managed (concierge-built).
  • event_date — string — Event date (e.g., "2027-03-15" or "GTC 2027")
  • revenue_target — number — Client pipeline/revenue target in USD (optional; used for attribution framing only)
  • budget_per_head — number — Optional exact per-attendee budget in USD. If provided, the closest tier is selected automatically and overrides brand_tier.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_live_quote

  Return a wholesale quote with virtual-proof links for a list of SKUs and quantities, optionally accounting for a destination ZIP and an event date. Use when shipping or timing affects the answer. Use get_quote for a plain priced list with neither.

  Parameters:

  • items — array — Products and quantities
  • event_date — string — Event date (optional)
  • quantities — array — Alternative: array of quantities (paired with product_skus[])
  • product_skus — array — Alternative: array of product slugs (paired with quantities[])
  • shipping_zip — string — Destination ZIP (optional)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_product_catalog

  Return a filtered slice of the catalogue, or the full category tree with counts when no filter is supplied. Use for browsing and for questions about the catalogue's shape and size. Use search_products when the request names specific products.

  Parameters:

  • brand — string — Brand filter
  • limit — number — Max results (default 20, max 50)
  • filter — string — Keyword filter on product title
  • category — string — Category filter

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• track_shipment

  Return the logistics status of an order by its id. Reads the live order record where one exists; where none does, returns a clear status and routes to the desk. Never reports a fabricated tracking state.

  Parameters:

  • order_id (required) — string — Order id

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_revenue_attribution

  Return recorded pipeline impact for an event id where the dashboard holds it; otherwise return the attribution model and how it is tracked, with a link. Never reports a fabricated figure.

  Parameters:

  • event_id (required) — string — Event id

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.