> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Fluxguard

The Fluxguard connector lets your AI agent act in each user's Fluxguard account. Each user connects their own Fluxguard API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 12 tools.

**Authentication:** API Key
**Categories:** Monitoring
**Tools:** 12: 5 read, 4 write, 3 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=FLUXGUARD)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Fluxguard connection

   In **AgentKit > Connections**, create a Fluxguard connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'fluxguard'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Fluxguard:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'fluxguard_account_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "fluxguard"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Fluxguard:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="fluxguard_account_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Fluxguard credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'fluxguard_account_get',
  toolInput: {},
  connector: 'fluxguard',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="fluxguard_account_get",
    tool_input={},
    connection_name="fluxguard",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `fluxguard_account_get`

Get Account · Read-only

Get your Fluxguard organization's account attributes.
Returns the org's account data as JSON.
Use this to confirm the API key works and to see account-level settings.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `fluxguard_categories_list`

List Categories · Read-only

List all categories in your Fluxguard account.
Returns an object keyed by category ID with each category's name and whether it is for sites or pages.
Use this to find category IDs for fluxguard_page_add.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `fluxguard_page_get`

Get Page · Read-only

Get the monitoring data for one page, identified by its site, session and page IDs.
Returns the page's data, including its URL and capture and change information.
Use this after fluxguard_crawl_start or to review a page added with fluxguard_page_add.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `page_id` (`string`, required): Fluxguard page ID, returned by fluxguard_page_add as pageId. Example: k1l2m3n4o5.
- `session_id` (`string`, required): Fluxguard session ID within the site, returned by fluxguard_page_add as sessionId. Example: f6g7h8i9j0.
- `site_id` (`string`, required): Fluxguard site ID, returned by fluxguard_page_add as siteId. Example: a1b2c3d4e5.

Example input: `{"page_id":"<page_id>","session_id":"<session_id>","site_id":"<site_id>"}`

### `fluxguard_webhook_sample_get`

Get Sample Webhook · Read-only

Get a sample webhook payload built from your account's data, or from sample data for a new account.
Returns the JSON body a webhook would receive.
Use this to see the payload format before creating a webhook with fluxguard_webhook_create.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `fluxguard_webhooks_list`

List Webhooks · Read-only

List the webhooks configured for your Fluxguard organization.
Returns each webhook with its ID and URL.
Use this to find a webhook ID before deleting it.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `fluxguard_category_create`

Create Site Category · Write

Create a new site category with the given name. The API can only create site categories.
Returns the created category, including its ID.
Use the ID in fluxguard_page_add to file new sites under it.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the new site category. Example: Competitors.

Example input: `{"name":"<name>"}`

### `fluxguard_crawl_start`

Start Crawl · Write

Start a crawl of a monitored session now, so Fluxguard captures its pages and checks them for changes.
Returns the crawl request result.
Use this to check for changes outside the session's schedule. Read results with fluxguard_page_get.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `session_id` (`string`, required): Fluxguard session ID within the site, returned by fluxguard_page_add as sessionId. Example: f6g7h8i9j0.
- `site_id` (`string`, required): Fluxguard site ID, returned by fluxguard_page_add as siteId. Example: a1b2c3d4e5.

Example input: `{"session_id":"<session_id>","site_id":"<site_id>"}`

### `fluxguard_page_add`

Add Page · Write

Add a web page to Fluxguard for change monitoring, either into an existing site and session or into a new site.
Returns the siteId, sessionId and pageId of the added page.
Pass site_id and session_id to add to an existing site; otherwise a new site and session are created and the category and nickname options apply.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `url` (`string`, required): URL of the page to monitor. Example: https://example.org/pricing.
- `categories` (`array`, optional): For a new site only: IDs of the categories to put the site in. Get IDs from fluxguard_categories_list. Example: ["cat_123", "cat_456"]
- `category_id` (`string`, optional): For a new site only: ID of a single category to put the site in. Example: cat_123.
- `category_name` (`string`, optional): For a new site only: name of a single category to put the site in. Example: Competitors.
- `session_id` (`string`, optional): Existing session (within site_id) to add the page to. Send together with site_id. Example: f6g7h8i9j0.
- `site_id` (`string`, optional): Existing site to add the page to. Send together with session_id; when set, the category and nickname options are ignored. Example: a1b2c3d4e5.
- `site_nickname` (`string`, optional): For a new site only: nickname for the site. Example: Acme pricing.

Example input: `{"url":"<url>"}`

### `fluxguard_webhook_create`

Create Webhook · Write

Create a webhook so Fluxguard POSTs change notifications for monitored pages to your URL.
Returns the ID of the new webhook.
Use fluxguard_webhook_sample_get to see the payload format first.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `url` (`string`, required): URL that receives the webhook POSTs. Example: https://example.com/hooks/fluxguard.

Example input: `{"url":"<url>"}`

### `fluxguard_page_delete`

Delete Page · Destructive

Permanently delete one monitored page and all of its captured versions.
Returns the deletion result.
Use fluxguard_site_delete to remove a whole site instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `page_id` (`string`, required): Fluxguard page ID, returned by fluxguard_page_add as pageId. Example: k1l2m3n4o5.
- `session_id` (`string`, required): Fluxguard session ID within the site, returned by fluxguard_page_add as sessionId. Example: f6g7h8i9j0.
- `site_id` (`string`, required): Fluxguard site ID, returned by fluxguard_page_add as siteId. Example: a1b2c3d4e5.

Example input: `{"page_id":"<page_id>","session_id":"<session_id>","site_id":"<site_id>"}`

### `fluxguard_site_delete`

Delete Site · Destructive

Permanently delete a site with all of its sessions, pages and captured versions.
Returns the deletion result.
Use fluxguard_page_delete to remove a single page instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `site_id` (`string`, required): Fluxguard site ID, returned by fluxguard_page_add as siteId. Example: a1b2c3d4e5.

Example input: `{"site_id":"<site_id>"}`

### `fluxguard_webhook_delete`

Delete Webhook · Destructive

Delete a webhook so Fluxguard stops sending to its URL.
Returns the deletion result.
Get the webhook ID from fluxguard_webhooks_list.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `id` (`string`, required): ID of the webhook to delete, from fluxguard_webhooks_list. Example: wh_8f2a1c.

Example input: `{"id":"<id>"}`

## Related

Other Monitoring connectors ([all 48](/agentkit/connectors/?category=monitoring)):

- [Datadog](/agentkit/connectors/datadog/): Scalekit connector, API key, 105 tools
- [1Password](/agentkit/connectors/onepassword/): Scalekit connector, Access token, 4 tools
- [Malwarebytes](/agentkit/connectors/malwarebytes/): Scalekit connector, Service account, 74 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
