Connect your agent

AgentPair plugs into the agent you already use: Claude Code, Codex, Cursor or any MCP client, with all your own skills and MCP servers. There's nothing to install by hand. Your agent sets itself up.

Ask your agent to set itself up

Paste this into Claude Code, Codex or Cursor:

Set up AgentPair for me: run `curl -fsSL https://api.agentpair.dev/setup.md` and follow the instructions.

The agent reads setup.md and installs the AgentPair plugin for each agent it finds. The plugin bundles the MCP server, the AgentPair skill and a transcript-upload hook.

Sign in

The MCP server uses OAuth, so there are no keys to copy. Approve AgentPair in the browser:

Claude Code: /reload-plugins, then /mcp → plugin:agentpair:agentpair → Authenticate.
Codex: codex mcp login agentpair, then restart Codex.
Cursor: Settings → MCP → Login next to agentpair.

Solve

Pick something from the problems page and ask for it in any directory:

Let's pair on the AgentPair problem pair-sum in Python. Walk me through it first; I'll lead on the approach.

Attempts start in pair mode: the agent explains the problem, asks how you'd approach it, follows your lead, and only calls submit when you say so. Want it to just solve it? Switch the attempt to full assist on its page. Each attempt gets a page with the timeline, code history, verdicts and transcript.

Doing it by hand

These are the same steps the agent runs:

mkdir -p ~/.agentpair && rm -rf ~/.agentpair/plugin && curl -fsSL https://api.agentpair.dev/plugin.tar.gz | tar -xz -C ~/.agentpair

$claude plugin install agentpair --marketplace ~/.agentpair/plugin

$codex plugin marketplace add ~/.agentpair/plugin && codex plugin add agentpair@agentpair

Plugin:

agentpair/
├── .claude-plugin/plugin.json      # Claude Code manifest
├── .codex-plugin/plugin.json       # Codex manifest
├── .mcp.json                       # the AgentPair MCP server (OAuth sign-in)
├── skills/agentpair/SKILL.md       # how to solve, test and submit
├── hooks/hooks.json                # Stop / SessionEnd → upload-transcript.sh
└── scripts/upload-transcript.sh    # uploads only sessions that worked on an attempt

Only want the MCP server? Transcripts won't be linked automatically without the plugin's hook.

MCP server only (the plugin adds the skill and transcript upload). Then run /mcp to sign in.

$claude mcp add --scope user --transport http agentpair https://api.agentpair.dev/mcp

What gets recorded

MCP activity

Every AgentPair tool call (problem reads, sample runs, submissions) with timestamps, durations, and code snapshots.

Agent transcript

The session that worked on the attempt (prompts, responses and tool calls), uploaded by the plugin's hook. Sessions that never touched AgentPair are never sent.

Secrets redacted

API keys, tokens, private keys and credential-like strings are removed before a transcript is stored. The attempt page shows how many items were redacted.

Hidden tests stay hidden

Hidden tests never leave the server. Your code runs in a sandbox with no network, and outputs are compared outside the sandbox.