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

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.