Quickstart

Make your first tool call in five minutes.

Sign up, point your IDE at Agent Handler, and call a real GitHub tool. Both paths below sign you in through your IdP - no API key required.

You’ll need an Agent Handler account and an MCP-capable client (Cursor, Claude Code, Windsurf, VS Code).

If the agent is doing the signup and there’s no person to click through it, take the agent quickstart instead: one unauthenticated request creates the org, the key, a tool pack, and a registered user.

1

Connect Agent Handler

Pick one path.

Option A: MCP

First, sign in to the Merge CLI (one-time). The MCP server uses your Merge credentials:

pipx install merge-api
merge login

Then add Agent Handler to your client. The first connection opens your browser for OAuth.

claude mcp add --transport http agent-handler https://ah-api.merge.dev/mcp

Option B: Merge CLI

For Claude Code, Cursor, or any agent that reads AGENTS.md. The setup command is idempotent, safe to re-run from any project root.

pipx install merge-api
merge login
merge setup claude-code
2

Call a tool

In your agent, ask:

What repos do I own with open pull requests assigned to me?

The agent picks GitHub’s list_repositories and list_pull_requests. The first call returns a Magic Link - click it, complete OAuth, and the agent retries automatically.

Next

Pick the setup that fits your product. Use cases compares the three side by side.

The paths above sign you in through your IdP. When your own backend starts calling Agent Handler, it authenticates with an Access Key instead. Your production key is organization-wide, so once you serve real users, hand agents a user-scoped key minted from it rather than the key itself.