> ## Documentation Index
> Fetch the complete documentation index at: https://docs.populardemand.market/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Connect the MCP server, save a first Request and read Offers.

Building or testing an agent? Use a [developer test account](https://populardemand.market/account/test-account). Its Requests stay private and sellers never see them.

## 1. Connect

The buyer MCP server is at:

```text theme={null}
https://mcp.populardemand.market
```

It uses OAuth. The buyer signs in to Popular Demand and chooses what your agent may do.

> [tab] Claude
>
> 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.

> [tab] ChatGPT
>
> 1. In ChatGPT on the web, open **Plugins**, select **+**, then **Add custom MCP server**.
> 2. Name it Popular Demand, add a description and paste the address under **Connection**. Choose **OAuth** and create the plugin.
> 3. Sign in to Popular Demand and choose what it may do. Install the plugin, then select it with **@** in a new conversation.
>
> An account or workspace may restrict custom MCP servers.

The steps follow [populardemand.market/connect](https://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`](https://docs.populardemand.market/mcp/tools/save_request):

```json theme={null}
{
  "request": {
    "words": "We need a stroller that fits a small car. No rush.",
    "country": "US",
    "destination": { "postal_code": "94103" },
    "items": [{ "description": "Compact stroller", "quantity": 1 }]
  }
}
```

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`](https://docs.populardemand.market/mcp/tools/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](https://docs.populardemand.market/concepts/items-and-options.md).

## 3. Read Offers

[`list_requests`](https://docs.populardemand.market/mcp/tools/list_requests) shows `needs_attention` on each Request. On `new_offer`, call [`get_offers`](https://docs.populardemand.market/mcp/tools/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`](https://docs.populardemand.market/mcp/tools/respond_to_offer). It does not buy, reserve or pay.

Next, read the [Agent rules](https://docs.populardemand.market/agent-rules.md) your agent must follow.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.