Get started
Last updated: October 9, 2025
What is Agent Handler?
Merge's Agent Handler enables companies to securely connect their agents to third-party tools using MCP, while managing and monitoring tool interactions. The platform offers:
Comprehensive authentication management for connected tools
A Connector Studio for building and maintaining custom integrations and tools
Preconfigured security rules you can toggle on or off, plus support for fully customizable rules
Detailed logging and real-time alerts for security violations
An evaluation suite to make sure that your Connectors are high-quality and provide a consistent experience for your customers
View your first Tool Pack
To help you get started, we've generated a test Registered User and a starter Tool Pack, “My first Tool Pack”. A Tool Pack is a collection of Connectors and tools that are available for use by your users. They are used to define what tools are available for your agent to call via MCP.
This Tool Pack includes a few example tools to demonstrate how Agent Handler works: Wikipedia, Weather, and GitHub.
Connect to the MCP server for local testing
Choose your preferred IDE or assistant and configure the Agent Handler MCP server. Make sure the IDE is using Node.js 20 or higher.
Select a Registered User
Registered Users indicate who or what is talking to the agent, and how we isolate what credentials are available to make authenticated tool calls. When you created your Agent Handler account, we created a test Registered User for you! This User has already been authenticated to use Wikipedia, Weather, and GitHub, and will automatically populate the MCP Server configuration with the necessary AUTH_TOKEN to use those Connectors.
Test Wikipedia and Weather Connectors
The Weather and Wikipedia Connectors each have tools you can leverage in your queries. To test Weather, try the following. This query uses the get_hourly_forecast and geocode_location tool calls to generate the output.
What's the weather forecast in San Francisco for the next 4 days?
To test Wikipedia, try the following. This query uses the random_articles tool call to generate the output.
Give me a list of trivia questions and answers, based on random Wikipedia articles.
Use the GitHub Connector
The Wikipedia and Weather Connectors work without authentication, but most Connectors require it. Let’s try GitHub.
Authenticate the GitHub Connector with a Personal Access Token (PAT). Your credentials are securely stored and linked to the default test Registered User. Learn how to create and manage a GitHub PAT.
After authenticating, refresh your MCP configuration. You should now see about 75 GitHub tools available in your Tool Pack!
Test the GitHub Connector
Try these queries in your chat to verify your GitHub Connector integration.
What repositories do I have access to and what open PRs do I own in those repositories?
Have more questions?
Feel free to reach out to support@merge.dev if you have any questions. If you'd like to see a demo and speak with sales, you can get in touch with them here.