# Visualping — how to use (mcp.ai)

Connect your Visualping account and use 9 tools for productivity straight from your AI agent. Connect with your own API key. Visualping monitors web pages for visual, text, and content changes and sends alerts when detected changes match configured criteria.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_visualping?ms=1787293680000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `visualping_bulk_create_monitors`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/visualping`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/visualping/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/visualping/bulk/create/monitors` — Create two or more active monitors with shared detection settings. Each monitor starts checking immediately and may consume monitoring credits; use only when workspace bulk import is enabled.
  - body: { mode?: string, interval: string, monitors: object[], workspace_id: integer, initialize_without_baseline?: boolean }
- `POST https://api.mcp.ai/api/visualping/create/monitor` — Create a monitor in a workspace. Visualping immediately performs an initial check, which uses monitoring capacity or credits.
  - body: { url: string, crop?: object, mode?: string, active?: boolean, interval: string, keywords?: string, selector?: string, description?: string, notification?: object, workspace_id: integer }
- `POST https://api.mcp.ai/api/visualping/delete/monitor` — Permanently delete one monitor from its Visualping workspace.
  - body: { job_id: integer, workspace_id: integer }
- `POST https://api.mcp.ai/api/visualping/describe/account` — Return the connected Visualping account, organization, workspaces, plan limits, balances, and monitor counts. Use this first to resolve a workspace ID for write operations.
- `POST https://api.mcp.ai/api/visualping/get/monitor` — Get a monitor's configuration, check history, and detected changes in one response.
  - body: { job_id: integer, workspace_id?: integer }
- `POST https://api.mcp.ai/api/visualping/launch/monitor/checks` — Immediately launch checks for one or more active monitors, consuming or reserving monitoring credits. Use Preflight Monitor Checks first to confirm credit requirements.
  - body: { job_ids: integer[], workspace_id: integer, restart_schedule?: boolean }
- `POST https://api.mcp.ai/api/visualping/list/monitors` — List and filter monitors visible to the connected workspace, returning one page and a continuation cursor.
  - body: { event?: string, active?: boolean, search?: string, sort_by?: string[], page_size?: integer, date_range?: string, next_cursor?: string, workspace_id?: integer, date_range_start?: string, monitoring_modes?: string[] }
- `POST https://api.mcp.ai/api/visualping/preflight/monitor/checks` — Estimate the credits required to check one or more active monitors without launching a check or changing their schedules.
  - body: { job_ids: integer[], workspace_id: integer }
- `POST https://api.mcp.ai/api/visualping/update/monitor` — Partially update a monitor's core URL, schedule, detection, state, or notification settings. Only explicitly supplied mutable fields are sent. The response reports impact and estimated consumption rat
  - body: { url?: string, crop?: object, mode?: string, active?: boolean, job_id: integer, interval?: string, keywords?: string, selector?: string, description?: string, notification?: object, workspace_id: integer }

## Example prompts
- "What can I do in Visualping?"
- "Show me a summary of my Visualping account"

## More
- Page: https://mcp.ai/visualping
- Agent spec (llms.txt): https://mcp.ai/visualping/llms.txt
- Postman collection: https://mcp.ai/visualping/postman.json