
Create a VisualPing monitoring job. Requires url, workspaceid. Optional: description, interval, selectors, labels. Use listworkspaces to find workspace_id.
Get a monitoring job by ID. Returns job details including url, status, interval, selectors, and last check results.
List monitoring jobs with optional filters. Supports pagination via pagetoken. Filter by workspaceid, status, or url pattern. Use listworkspaces to find workspaceid.
Update a monitoring job. Can modify url, description, interval, selectors, labels, or active status.
Delete a monitoring job permanently. Cannot be undone. Use get_job to verify job exists first.
Get the authenticated user's profile including user_id, email, name, and account details.
Validate VisualPing credentials. Verifies credentials during setup.
List available workspaces. Use to find workspace_id required for creating jobs. Returns workspace names, IDs, and job counts.

In an mcp.json file, add the configuration below, and restart Cursor.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5 "headers": {
6 "Authorization": "Bearer yMt*****"
7 }
8 }
9 }
10}
11Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.
Make sure Claude is using the Node v20+.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "yMt*****"
14 }
15 }
16 }
17}Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.
Learn more in the official documentation ↗
1{
2 "mcpServers": {
3 "agent-handler": {
4 "command": "npx",
5 "args": [
6 "-y",
7 "mcp-remote@latest",
8 "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9 "--header",
10 "Authorization: Bearer ${AUTH_TOKEN}"
11 ],
12 "env": {
13 "AUTH_TOKEN": "<ah-production-access-key>"
14 }
15 }
16 }
17 }In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".
You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.
Learn more in the official documentation ↗
1{
2 "inputs": [
3 {
4 "type": "promptString",
5 "id": "agent-handler-auth",
6 "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7 "password": true
8 }
9 ],
10 "servers": {
11 "agent-handler": {
12 "type": "stdio",
13 "command": "npx",
14 "args": [
15 "-y",
16 "mcp-remote@latest",
17 "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18 "--header",
19 "Authorization: Bearer ${input:agent-handler-auth}"
20 ]
21 }
22 }
23}It's an MCP server that connects your agents to VisualPing's website monitoring platform via tools. Your agents can invoke these tools to create and manage monitoring jobs, check the status of tracked pages, update alert configurations, and more.
VisualPing offers an official MCP server, but you can also use one from a third-party platform, like Merge Agent Handler.
The use cases naturally depend on the agent you've built, but here are a few common ones:
Here are some of the most commonly used tools:
create_job: sets up a new monitoring job for a specified URL, with options for check frequency, alert threshold, and notification settings. Use this when an agent needs to start tracking a new page as part of a monitoring or intelligence workflowget_job: retrieves the current status and configuration of a specific monitoring job, including the last detected change. Call this when an agent needs to check whether a monitored page has updated before triggering a downstream actionlist_jobs: returns all active monitoring jobs in the account, optionally scoped by workspace. Useful for agents that need to audit what pages are being tracked or surface jobs that haven't triggered recentlyupdate_job: modifies an existing job's settings, such as check frequency, monitored region, or alert conditions. Good for workflows that adjust monitoring intensity based on business events, like increasing frequency during a product launch or contract renewal perioddelete_job: removes a monitoring job from the account. Use this when an agent is decommissioning tracking for pages that are no longer relevant or cleaning up stale jobs on a schedulelist_workspaces: returns all workspaces in the account along with their metadata. Helpful when an agent needs to scope a new job to a specific team or project workspace before creating itConnecting VisualPing through Merge Agent Handler instead of building your own integration or using a lightweight alternative gives you several practical advantages:
You can take the following steps:
1. Create or log into your Merge Agent Handler account and navigate to Tool Packs (collections of connector tools scoped to a specific use case).
2. Create a new Tool Pack, then find and enable the VisualPing connector. Pick the tools that match your workflow: create_job and update_job are essential for any agent that manages monitoring jobs, while list_jobs and get_job cover read-only auditing and status checks.
3. Add a Registered User inside the Tool Pack. This is the identity context under which your agent operates. Merge generates a unique MCP URL scoped to this user once it's created.
4. From the Registered User detail page, authenticate VisualPing by entering your API credentials. Merge stores and manages those credentials going forward.
5. Copy the MCP URL from the Tool Pack detail page and generate an API key from Settings. You'll need both to connect your agent.
6. Add the MCP server to your agent or IDE using the MCP URL and API key. Your VisualPing tools are now accessible through that endpoint.
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now