Pops4 Mcp Catalog

io.github.HuangGoodmanAgencyPublished by GitHub account HuangGoodmanAgencyv2.0.0Updated Oct 27, 2026

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

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Public MCP endpoint for a corporate gifting and branded-merchandise vendor: search a 70,000+ item wholesale catalog, build event programs, and get quotes.

What you can do
  • Search and browse the wholesale branded catalog by keyword, category, brand, price or occasion, and list categories with counts
  • Read full detail for a single product, including wholesale price, care instructions and occasion tags
  • Build wholesale quotes from product slugs and quantities, with or without destination ZIP and event date
  • Generate a costed event program for an attendee count and budget tier, and estimate brand-carriage cost per thousand impressions
  • Render an indicative logo-placement image for a product and return its URL
  • Retrieve the vendor capability card, look up shipment status by order id, and read revenue-attribution data for an event
When to use it
Useful when an assistant is helping plan corporate gifting, branded merchandise or event swag and needs real catalog items, wholesale pricing, or a costed program to compare against a budget. Also handy for procurement-style questions about the vendor's capabilities, lead times and terms.
Requirements
Remote streamable-HTTP endpoint; no API key or account is required for initialize, tools/list or tools/call. Network access to the vendor's endpoint. Product logo proofs need an https URL to the buyer's logo image.
Before you install
request_program is the only writing tool: it records buyer, program and chosen products to the vendor's desk, so confirm before calling it. It does not place orders, take payment or contact the buyer. Rendered proofs are indicative only, not production proofs. Quotes, shipment status and attribution figures come from the vendor's records and may route to a human desk when no record exists.

Installation

In SourceWeft

  1. Open Pops4 Mcp Catalog in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.HuangGoodmanAgency%2Fpops4-mcp-catalog/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

POPS4 / Huanggoodman MCP Server

AI-native corporate gifting and event infrastructure for Fortune 500. An Model Context Protocol 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

ToolWhat it does
search_productsSearch the 70,000+ wholesale branded-identity catalog
get_productFull details for a single product (description, pricing)
get_categoriesList categories with product counts and samples
get_quoteWholesale pricing quote for a list of products
get_live_quoteOne-hour enterprise event quote (line items)
get_product_catalogReturn the full 70,000+ product catalog
generate_event_programBuild a live event-dashboard program with P&L
get_vendor_capabilitiesHuanggoodman vendor capability card for procurement agents
track_shipmentReal logistics status for an order
get_revenue_attributionPipeline-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.

Source: README.md at commit 8d4948c

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.

Parametersslugrequiredlogo_urlcompany_name

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.

Parametersemailrequiredeventitemsnotescompanyper_headbrand_tiercontact_nameprogram_totalattendee_count

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.

Parameterspeersvendorsyour_cpmemployeesgig_workerscost_per_peercost_per_vendorcost_per_workercost_per_employeeimpressions_per_peerimpressions_per_vendorimpressions_per_worker+1 more

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.

Parametersbrandlimitquerycategoryoccasionprice_maxprice_min

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.

Parametersslugrequired

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.

Takes no parameters.

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.

Parametersitemsrequired

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.

Takes no parameters.

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.

Parameterskeywordsbrand_tierevent_dateattendee_countrequiredrevenue_targetbudget_per_head

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.

Parametersitemsevent_datequantitiesproduct_skusshipping_zip

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.

Parametersbrandlimitfiltercategory

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.

Parametersorder_idrequired

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.

Parametersevent_idrequired

Version history

1
  1. v2.0.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts