{ "id": "07-merge-agent-handler", "slug": "merge-agent-handler", "normalized_name": "merge agent handler", "name": "Merge Agent Handler", "vendor_url": "merge.dev", "category": "mcp-infrastructure", "what_it_does": "Merge's tool-calling platform for AI agents: it wraps hundreds of third-party SaaS applications as pre-built MCP-ready connectors, bundles them into scoped \"tool packs\" per agent, brokers per-end-user authentication, and puts a security gateway, redaction rules and an audit log in front of every tool call.", "ai_features": "None of its own by design. The product is governance and plumbing around somebody else's agent, and the features it sells (tool scoping, data-loss prevention, tool-call logs, audit trail) are controls rather than intelligence.", "mcp_status": "official", "mcp_url": "https://github.com/merge-api/merge-mcp ; https://api.merge.dev/api/v1/tool-packs//registered-users//mcp (docs: https://docs.merge.dev/merge-agent-handler/build/connecting-agents/mcp-integration and https://docs.merge.dev/merge-agent-handler/overview)", "mcp_auth": "api key in an Authorization Bearer header, alongside the identity encoded in the URL itself. The docs are explicit that three values are needed on every connection: the tool pack (what tools), the registered user (whose credentials), and the access key (authorisation). Per-end-user OAuth to each connected application is brokered separately through Merge Link.", "api_gate": "free - the Agent Handler pricing tab publishes a Free tier at \"$0 / month\" that \"Get started for free with 2,000 monthly credits\", with unlimited registered users and unlimited tool packs, then Launch, Pro and Professional tiers, with Enterprise routed to \"Contact sales\". Credits are consumed per tool call.", "revops_role": "The governed alternative to handing an agent a dozen raw vendor MCP servers: one endpoint per user per tool pack, with the audit trail a security review will ask for, which is the difference between a demo and something a RevOps team can put in front of customer data.", "tier": "RESEARCHED", "last_checked": "2026-09-07", "sources": "https://docs.merge.dev/merge-agent-handler/build/connecting-agents/mcp-integration, https://docs.merge.dev/merge-agent-handler/overview, https://www.merge.dev/merge-agent-handler, https://www.merge.dev/pricing/agent-handler, https://github.com/merge-api/merge-mcp", "notes": "CORRECTION TO THE CANDIDATE ROW, and it matters: the address carried in CANDIDATES.md pointed at ah-api-develop.merge.dev, a development host. Merge's own documentation gives the production pattern as https://api.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp, and that is what is recorded above. Verified 2026-09-07 from the docs; no liveness probe result is recorded because the URL is per-tenant and cannot be constructed without a tool pack and a registered user. The docs also document a simplified URL for the \"Agent Handler for Employees\" setup, plus custom MCP servers and custom headers, so a buyer can front their own servers with the same gateway. Merge's own troubleshooting page names the two failure modes worth knowing before a bench test: a 401 on every call usually means the Bearer prefix is missing or the key belongs to the wrong environment, and session-ID mismatches require capturing and reusing the Mcp-Session-Id header. Merge sells three separate products on one brand (Unified, Agent Handler, Gateway) with three separate price lists; only Agent Handler is the MCP product and the $650/month figure that appears in Merge coverage belongs to the Unified API, not to this. 2026-09-07: the Agent Handler endpoint is per-tool-pack and per-user and templated (https://api.merge.dev/api/v1/tool-packs//registered-users//mcp), so no capability harvest can ever enumerate its tools without a customer's tool pack and registered user ids. DO NOT RE-INVESTIGATE the endpoint: the harvestable artifact is the first-party repo https://github.com/merge-api/merge-mcp (GitHub org merge-api, src/merge_mcp/server.py, last push 2025-04-30), recorded here instead.", "mcp_status_bucket": "official", "api_gate_bucket": "free", "mcp_urls": [ "https://github.com/merge-api/merge-mcp", "https://api.merge.dev/api/v1/tool-packs/", "https://docs.merge.dev/merge-agent-handler/build/connecting-agents/mcp-integration", "https://docs.merge.dev/merge-agent-handler/overview" ], "source_urls": [ "https://docs.merge.dev/merge-agent-handler/build/connecting-agents/mcp-integration", "https://docs.merge.dev/merge-agent-handler/overview", "https://www.merge.dev/merge-agent-handler", "https://www.merge.dev/pricing/agent-handler", "https://github.com/merge-api/merge-mcp" ], "source_annotations": [], "vendor_domain": "merge.dev", "display_name": "Merge Agent Handler", "docs_url": null, "jobs": [], "jobs_tagged_by": null, "jobs_tagged_on": null, "github_url": null, "github_stars": null, "github_last_commit": null, "github_archived": null, "github_fetched_on": null, "github_candidates": [ "https://github.com/merge-api/merge-mcp", "https://github.com/merge-api/merge-mcp" ], "docs_digest": null, "docs_last_crawled": null, "submission": null, "mcp_tools": [], "mcp_tool_count": 0, "mcp_tools_evidence": null, "mcp_tools_repo": null, "mcp_tools_repo_party": null, "mcp_catalog_shape": "dynamic", "mcp_catalog_note": "a unified API gateway; its tools are the vendors it wraps, not its own", "mcp_tools_fetched_on": "2026-09-27", "cli_status": "none-found", "cli_party": null, "cli_binary": null, "cli_install": [], "cli_login": null, "cli_commands_seen": [], "cli_docs_url": null, "cli_repo": null, "cli_packages": [], "cli_evidence": null, "cli_checked_on": "2026-09-27", "github_org": "merge-api", "github_org_status": "resolved", "github_org_url": "https://github.com/merge-api", "github_org_evidence": { "rule": "rule 2", "url": "https://github.com/merge-api/merge-mcp", "matched_domain": "merge.dev", "via": "website", "detail": "account website merge.dev has the vendor's domain", "confidence": "strong", "candidates_rejected": [] }, "github_org_repos": 54, "github_org_repos_mcp": 2, "github_org_repos_cli": 0, "github_org_latest_activity": "2026-09-07T20:41:29Z", "github_org_recent_repos": [ { "name": "merge-unified-skills", "url": "https://github.com/merge-api/merge-unified-skills", "kind": "other", "description": "Claude Code skills for the Merge Unified API", "stars": 0, "pushed_at": "2026-09-07", "latest_release": null }, { "name": "react-merge-link", "url": "https://github.com/merge-api/react-merge-link", "kind": "other", "description": null, "stars": 5, "pushed_at": "2026-08-27", "latest_release": "2.4.2" }, { "name": "merge-workforce-dist", "url": "https://github.com/merge-api/merge-workforce-dist", "kind": "other", "description": "Public distribution point for the Merge Workforce desktop client (signed macOS + Windows packages). Downloads are on the Releases page.", "stars": 0, "pushed_at": "2026-08-24", "latest_release": "v0.1.0-preview3" }, { "name": "react-agent-handler-link", "url": "https://github.com/merge-api/react-agent-handler-link", "kind": "other", "description": null, "stars": 0, "pushed_at": "2026-08-14", "latest_release": null }, { "name": "merge-gateway-ai-sdk-provider", "url": "https://github.com/merge-api/merge-gateway-ai-sdk-provider", "kind": "sdk", "description": "Merge Gateway provider for the Vercel AI SDK", "stars": 0, "pushed_at": "2026-08-11", "latest_release": null } ], "github_org_checked_on": "2026-09-08", "mcp_endpoint": null, "mcp_docs_url": null, "endpoint_status": "not-probed", "endpoint_http_status": null, "endpoint_last_probed": null, "endpoint_wall_note": null, "canonical": true, "canonical_id": "07-merge-agent-handler", "also_listed_in": [], "source_file": "07-mcp-infrastructure.md", "source_line": 314, "file_index": 14, "category_num": "07", "category_slug": "mcp-infrastructure", "category_label": "MCP Layer", "heading": "Merge Agent Handler", "missing_schema_fields": [], "extra_fields": {}, "display_rank": 34 }