Connect your AI Agents to VisualPing in minutes

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

How to set up Merge Agent Handler
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}FAQs on using Merge's VisualPing MCP server
FAQs on using Merge's VisualPing MCP server
What is a VisualPing MCP?
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.
How can I use the VisualPing MCP server?
The use cases naturally depend on the agent you've built, but here are a few common ones:
- Competitor pricing surveillance: An agent creates VisualPing jobs for competitor pricing pages and when a change is detected, it parses the diff, compares it against internal pricing data, and sends an alert to the sales and product teams in Slack
- Regulatory and compliance tracking: An agent sets up jobs to monitor terms of service or regulatory guidance pages for specific vendors or government bodies, and when content changes, it creates a review task in Asana or Jira for the legal team
- Target account hiring signals: An agent monitors a prospect company's careers page in VisualPing and when new roles appear, it updates the account record in a CRM and notifies the sales rep that the account may be expanding
- Vendor status page alerting: An agent tracks a critical vendor's status or incident page and when VisualPing detects a change, it opens a ticket in Freshservice and pages the on-call engineer with the detected content diff
What are popular tools for VisualPing's MCP server?
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 workflow
get_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 action
list_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 recently
update_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 period
delete_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 schedule
list_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 it
What makes Merge Agent Handler's VisualPing MCP server better than alternative VisualPing MCP servers?
Connecting VisualPing through Merge Agent Handler instead of building your own integration or using a lightweight alternative gives you several practical advantages:
- Enterprise-grade security and DLP: Merge Agent Handler includes built-in data loss prevention controls that let you block or redact sensitive fields before they reach an agent. For VisualPing, this means you can prevent monitored page content, change diffs, and alert history tied to competitive or sensitive business intelligence from being surfaced beyond the specific agent that needs it
- Managed authentication and credentials: Merge stores and refreshes VisualPing credentials on your behalf. You never pass raw API keys into an agent or rebuild your auth setup when credentials change
- Real-time observability and audit trail: Every tool call against VisualPing is logged: which job was created or queried, what parameters were used, and what came back. That audit trail is available without any custom logging on your end
- Tool Packs and controlled access: Tool Packs let you bundle specific VisualPing tools with tools from other connectors into a single MCP endpoint, scoped to a specific use case. An agent gets exactly the tools it needs, nothing more
How can I start using Merge Agent Handler's VisualPing MCP server?
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.
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now


















