Skip to main content
Building or testing an agent? Use a developer test account. Its Requests stay private and sellers never see them.

1. Connect

The buyer MCP server is at:
It uses OAuth. The buyer signs in to Popular Demand and chooses what your agent may do.
  1. In Claude on the web or desktop, open Customize, then Connectors. Choose + Add, then Add custom connector.
  2. Name it Popular Demand, paste the address and continue. Choose Sign in now and finish adding it.
  3. In the Popular Demand window, sign in and choose what it may do. In a chat, use +, then Connectors to enable it.
On a Team or Enterprise plan, the organization may need to add the connector first. Claude Code: claude mcp add --transport http --scope user popular-demand https://mcp.populardemand.market, then run /mcp and sign in.
The steps follow populardemand.market/connect. For other hosts, add a remote MCP server with OAuth sign-in and the same address.

2. Save a first Request

The buyer says what they would buy later, for example: “We need a stroller that fits a small car. No rush.” Your agent shows what it will save and gets the buyer’s yes. It asks once, together, for what is missing: how many, when they need it and their postal code (ZIP in the US). Then it calls save_request:
The result carries save_confirmation. Relay it to the buyer as it is, and tell them an offer isn’t guaranteed. When the buyer names models they would accept, add each as an option with update_request. Sellers count a Request once each item has the brand and model of every option the buyer would accept, and a quantity. See Items and options.

3. Read Offers

list_requests shows needs_attention on each Request. On new_offer, call get_offers with the request_id. Relay must_tell_user.text and the buyer’s own Offer link. Only the buyer decides to buy, at the seller’s checkout. If the Offer fits what they asked for, offer to record that with respond_to_offer. It does not buy, reserve or pay. Next, read the Agent rules your agent must follow.