# Fluxguard — how to use (mcp.ai)

Connect your Fluxguard account and use 13 tools for server monitoring straight from your AI agent. Connect with your own API key. Fluxguard is an AI-powered website change detection and monitoring tool that helps businesses track, analyze, and respond to critical changes in web-based data.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_fluxguard?ms=1787296020000`
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. `fluxguard_add_page`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/fluxguard`
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/fluxguard/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/fluxguard/add/page` — Tool to add a new page for monitoring in FluxGuard. This action can: 1. Create a new site with a page (when siteId/sessionId are not provided) 2. Add a page to an existing site (when siteId/sessionId 
  - body: { url: string, siteId?: integer|string, sessionId?: integer|string, categories?: integer|string[], categoryId?: integer|string, categoryName?: string, siteNickname?: string }
- `POST https://api.mcp.ai/api/fluxguard/create/site/category` — Creates a new site category in FluxGuard for organizing monitored websites. Site categories help you group and manage your monitored sites logically (e.g., by environment like 'Production' or 'Staging
  - body: { name: string }
- `POST https://api.mcp.ai/api/fluxguard/create/webhook` — Creates a webhook endpoint registration in FluxGuard to receive real-time notifications when changes are detected on monitored pages. When changes occur, FluxGuard will POST JSON data to your specifie
  - body: { url: string }
- `POST https://api.mcp.ai/api/fluxguard/delete/page` — Permanently deletes a monitored page from FluxGuard along with all its captured snapshots and version history. This is a destructive operation that cannot be undone. Use this when you need to remove a
  - body: { page_id: string, site_id: string, session_id: string }
- `POST https://api.mcp.ai/api/fluxguard/delete/site` — Permanently deletes a monitored site and all associated data including sessions, pages, and captured versions. This operation is idempotent - deleting a non-existent site returns success. Use when you
  - body: { site_id: string }
- `POST https://api.mcp.ai/api/fluxguard/delete/webhook` — Permanently removes a webhook from your FluxGuard account by its ID. After deletion, the webhook will no longer receive notifications about monitored page changes. This operation is idempotent - delet
  - body: { id: string }
- `POST https://api.mcp.ai/api/fluxguard/get/all/categories` — Retrieves all categories defined in your FluxGuard account. Use this tool when you need to: - List all available categories for organizing sites or pages - Get category IDs for use in other operations
- `POST https://api.mcp.ai/api/fluxguard/get/page/data` — Tool to retrieve comprehensive data for a monitored page in FluxGuard. This action fetches detailed information about a specific page including its URL, monitoring status, capture history, and metadat
  - body: { page_id: string, site_id: string, session_id: string }
- `POST https://api.mcp.ai/api/fluxguard/get/sample/webhook` — Tool to retrieve a sample webhook payload. Use when you need to inspect the structure of webhook notifications.
- `POST https://api.mcp.ai/api/fluxguard/get/user` — Retrieves the authenticated FluxGuard account's information as a user profile. Returns details about the current organization's account including ID, status, creation date, and last update timestamp. 
  - body: { user_id?: string }
- `POST https://api.mcp.ai/api/fluxguard/get/webhooks` — Retrieves all configured webhooks for the FluxGuard account. Use this action to list all webhook endpoints that are configured to receive FluxGuard change notifications. Each webhook includes its URL,
- `POST https://api.mcp.ai/api/fluxguard/initiate/crawl` — Tool to initiate a crawl for a session identified by siteId and sessionId. Use when you need to start monitoring a site for changes after adding pages with FLUXGUARD_ADD_PAGE.
  - body: { site_id: string, session_id: string }
- `POST https://api.mcp.ai/api/fluxguard/webhook/notification` — Simulate Fluxguard webhook notification by sending change detection data to your webhook endpoint. Use this tool to test your webhook receiver implementation by sending it a properly formatted Fluxgua
  - body: { secret?: string, payload: object, webhook_url: string }

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

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