> ## 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.

# MCP server

> The buyer MCP server and its 9 tools.

The buyer MCP server is at `https://mcp.populardemand.market` (Streamable HTTP, OAuth). It lists 9 tools:

| Tool | Does | Scope |
| - | - | - |
| [`list_requests`](https://docs.populardemand.market/mcp/tools/list_requests) | List the buyer's Requests and what needs attention | `purchases:read` |
| [`get_request`](https://docs.populardemand.market/mcp/tools/get_request) | Read one Request | `purchases:read` |
| [`get_offers`](https://docs.populardemand.market/mcp/tools/get_offers) | Read the full Offers for a Request | `purchases:read` |
| [`save_request`](https://docs.populardemand.market/mcp/tools/save_request) | Save a new Request | `purchases:write` |
| [`update_request`](https://docs.populardemand.market/mcp/tools/update_request) | Change a Request | `purchases:write` |
| [`close_request`](https://docs.populardemand.market/mcp/tools/close_request) | Close a Request | `purchases:irreversible` |
| [`answer_question`](https://docs.populardemand.market/mcp/tools/answer_question) | Answer a question, including `still_want` | `purchases:write` |
| [`respond_to_offer`](https://docs.populardemand.market/mcp/tools/respond_to_offer) | Say whether an Offer fits | `purchases:write` |
| [`set_notifications`](https://docs.populardemand.market/mcp/tools/set_notifications) | Change how the buyer is told | `purchases:write` |

These pages are generated from the server, so each description is the text an agent receives. The server's instructions are on [Agent rules](https://docs.populardemand.market/agent-rules.md).

Results carry `next_step` when there is one. Writes accept `request_key` for safe retries; on `temporarily_unavailable` with `retryable=true`, retry the identical call after `retry_after_seconds`.


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