Set up PMM Tools (for agents)
This page is for an AI agent setting up PMM Tools for a person. If you are the person, paste this into your agent:
Read https://www.pmmtools.com/docs/mcp/agents and set up PMM Tools for me.Server URL
https://www.pmmtools.com/api/mcpStreamable HTTP. Works with the Claude or Codex subscription you already have. We never bill you for AI usage — your plan covers captures.
What the person does
An agent cannot do these two steps. Ask the person, then wait.
- Pick a plan. PMM Tools has no free plan, so an account without one is refused with
subscription_required. Plans are at https://www.pmmtools.com/pricing. - Sign in and choose Allow. When the app connects, PMM Tools opens a sign-in page that names the app. The person signs in, checks the name, and chooses Allow.
Connect your app
Claude and claude.ai
Settings, then Connectors, then Add custom connector. Paste the server URL, choose Connect, then sign in and choose Allow. Full steps.
https://www.pmmtools.com/api/mcpChatGPT
Find PMM Tools in the app directory and choose Connect. To add it yourself, open Settings, then Apps, turn on developer mode, paste the server URL and choose OAuth. Then sign in and choose Allow. Full steps.
https://www.pmmtools.com/api/mcpClaude Code
Run this command, then run /mcp in Claude Code and sign in from the browser. To use a connection key instead, see the Claude Code page. Full steps.
claude mcp add --transport http pmm https://www.pmmtools.com/api/mcpCodex CLI
Connects with a connection key. The person creates one at https://www.pmmtools.com/private/mcp; the Codex page gives the command. Full steps.
Cursor
Connects with a connection key. The person creates one at https://www.pmmtools.com/private/mcp; the Cursor page gives the JSON. Full steps.
First calls
pmm_competitor_trackwith{ "domain": "example.com" }. It adds the competitor and starts its first run, which finds the site's pages and captures each one. It returnscompetitor_id,run.batch_idandnext, the call to make next.pmm_run_statuswith{ "batch_id": "..." }every minute or two untilis_terminalis true. A first run usually takes about 16 minutes.pages_readysays how many pages are already captured: read them while it runs.pmm_competitor_pageswith{ "competitor_id": "..." }lists the captured pages, andpmm_competitor_readreads one as markdown.- Calling
pmm_competitor_trackagain is safe. If a run is already going, it returns that run and starts no new one. A competitor that already has pages starts nothing. To capture its pages again, callpmm_competitor_run_now.
Errors and what to do
| Error | When | What to do |
|---|---|---|
missing_authorization or invalid_token or invalid_key (HTTP 401) | Nothing was sent, the sign-in expired or was disconnected, or the key was revoked. | Reconnect the app so the person signs in again, or ask them for a new connection key. |
subscription_required (HTTP 402) | The account has no active plan. | Tell the person what next_step in the response says: the account needs a plan, and plans_url describes them. Then call again. |
account_suspended (HTTP 403) | The account is suspended. | Stop and tell the person. A plan does not lift it; they contact support. |
rate_limit_exceeded (HTTP 429) | The plan's hourly MCP budget is used up. | Wait the seconds in the Retry-After header, then try again. |
invalid_domain | The domain could not be read. | Pass a plain domain like example.com. |
competitor_quota | The plan's competitor limit is reached. | Tell the person. They can remove a competitor or pick a larger plan. |
rate_limited | Too many competitors were started in a short time. | Wait retry_after_seconds, then call again. |
no_tracked_urls | pmm_competitor_run_now was called for a competitor with no pages yet. | Call the tool in next_tool_args, which runs the full first capture. |
Every docs page is also in one markdown file: https://www.pmmtools.com/llms-full.txt.