Fresh 2026

Quickstart

End-to-end Agent Handler quickstart with two paths: Merge CLI or raw MCP. Connect from Cursor, Claude Code, or any MCP client; make a real tool call against GitHub.

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

Pick one path.

Option A: Merge CLI

Recommended 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

merge setup cursor

merge setup agents-md

Option B: MCP

Use this for clients without a merge setup target (Windsurf, VS Code), or to configure MCP yourself. The first connection opens your browser for OAuth.

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

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "agent-handler": {
      "url": "https://ah-api.merge.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "agent-handler": {
      "serverUrl": "https://ah-api.merge.dev/mcp"
    }
  }
}

Add to .vscode/mcp.json (workspace) or via MCP: Open User Configuration:

{
  "servers": {
    "agent-handler": {
      "type": "http",
      "url": "https://ah-api.merge.dev/mcp"
    }
  }
}

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.