> ## Documentation Index
> Fetch the complete documentation index at: https://simplified-webhooks.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Use with AI agents

> Connect Simplified Webhooks to Claude, Cursor, or any MCP client to register webhooks, track usage, and keep an audit log of an agent's Airtable changes.

Simplified Webhooks exposes a remote [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server, so AI agents can manage your webhooks, track record and storage usage, and — most usefully — **keep an audit log of the changes an agent makes to your Airtable data**.

The intended setup is two MCP servers side by side: the **Airtable MCP** (to read and mutate records) and the **Simplified Webhooks MCP** (to log what changed, as a safety net). The agent enables monitoring at the start of a session, does its work through the Airtable MCP, and reviews the logged changes afterward.

<Note>
  This is an **audit layer, not a hard guardrail**. Simplified Webhooks records what changed; it does not sit in front of Airtable and block writes. Use it to review — and, if needed, manually reverse — an agent's changes.
</Note>

## Endpoint

```
https://api.simplified-webhooks.com/mcp
```

The server speaks streamable HTTP. Add it as a **remote MCP server** in any client that supports them.

## Authentication

You can connect in two ways:

<CardGroup cols={2}>
  <Card title="OAuth (recommended)" icon="key">
    Clients that support OAuth (Claude, Cursor) discover the sign-in flow automatically. You approve access once on a consent screen and can revoke it anytime under **Connected apps** in your [profile settings](https://www.simplified-webhooks.com/profile-settings).
  </Card>

  <Card title="API key" icon="terminal">
    For headless or CI agents, send a Simplified Webhooks API key as a bearer token: `Authorization: Bearer sk_...`. Create keys in your [profile settings](https://www.simplified-webhooks.com/profile-settings).
  </Card>
</CardGroup>

Either way, the agent acts as **you** and can only see your own data. Connect your Airtable account first (via OAuth or a personal access token) in the dashboard — the MCP tools use that same connection.

## Adding the server

<Tabs>
  <Tab title="Claude">
    In Claude, open **Settings → Connectors → Add custom connector**, then paste the endpoint URL. Claude walks you through the OAuth consent screen. Once connected, the Simplified Webhooks tools appear in your conversations.
  </Tab>

  <Tab title="Cursor">
    Add the server to your MCP configuration:

    ```json theme={null}
    {
      "mcpServers": {
        "simplified-webhooks": {
          "url": "https://api.simplified-webhooks.com/mcp"
        }
      }
    }
    ```

    Cursor prompts you to authorize on first use.
  </Tab>

  <Tab title="API key client">
    For a client that sends a static token, configure the endpoint with an `Authorization: Bearer sk_...` header. No consent screen is involved.
  </Tab>
</Tabs>

## What the agent can do

The tools mirror the [public API](https://www.simplified-webhooks.com/docs) one-to-one.

| Group                 | Tools                                                                                                                                                  |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Webhooks**          | `list_webhooks`, `register_webhook`, `update_webhook_url`, `delete_webhook`                                                                            |
| **Usage**             | `list_usage_bases`, `add_usage_base`, `update_usage_base`, `run_usage_count`, `get_usage_snapshot_latest`, `list_usage_snapshots`, `remove_usage_base` |
| **Change monitoring** | `get_monitoring_auth_status`, `enable_monitoring`, `list_monitoring_configs`, `list_recent_changes`, `update_monitoring_scope`, `stop_monitoring`      |
| **Airtable lookups**  | `list_bases`, `list_tables`                                                                                                                            |

## The monitoring workflow

Pair the Simplified Webhooks MCP with the Airtable MCP so an agent's edits are logged:

1. **Check permissions** — `get_monitoring_auth_status`. Enabling monitoring creates a Monitoring Base in your Airtable account, which needs write access. If `hasWriteScopes` is false, grant write access in the dashboard under **Change monitoring**.
2. **Enable monitoring** — `enable_monitoring` with your `baseId` and `workspaceId`. When it returns successfully, changes are captured from that moment on.
3. **Do the work** — let the agent read and mutate records through the **Airtable MCP** as usual.
4. **Review** — `list_recent_changes` returns what changed, newest first, filterable by event type, table, record, source, user, and date range. Each entry captures the previous values, so you can see — and manually undo — exactly what happened.

<Tip>
  Ask the agent to enable monitoring **before** it starts editing, then to summarize `list_recent_changes` when it finishes. That gives you a reviewable record of the session.
</Tip>

## Current limitations

* **No one-click revert (yet).** Previous values are captured, but reversing a change is manual today.
* **Account-level access.** An OAuth grant or API key gives an agent access to your whole Simplified Webhooks account; there are no per-tool permission scopes yet.
* **Monitoring is a log, not a lock.** It records changes; it does not prevent them.