Skip to content

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/mcp

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

  1. 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.
  2. 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/mcp
  • ChatGPT

    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/mcp
  • Claude 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/mcp
  • Codex 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

  1. pmm_competitor_track with { "domain": "example.com" }. It adds the competitor and starts its first run, which finds the site's pages and captures each one. It returns competitor_id, run.batch_id and next, the call to make next.
  2. pmm_run_status with { "batch_id": "..." } every minute or two until is_terminal is true. A first run usually takes about 16 minutes. pages_ready says how many pages are already captured: read them while it runs.
  3. pmm_competitor_pages with { "competitor_id": "..." } lists the captured pages, and pmm_competitor_read reads one as markdown.
  4. Calling pmm_competitor_track again 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, call pmm_competitor_run_now.

Errors and what to do

ErrorWhenWhat 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_domainThe domain could not be read.Pass a plain domain like example.com.
competitor_quotaThe plan's competitor limit is reached.Tell the person. They can remove a competitor or pick a larger plan.
rate_limitedToo many competitors were started in a short time.Wait retry_after_seconds, then call again.
no_tracked_urlspmm_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.

See every tool and the plan limits.