> For the complete documentation index, see [llms.txt](https://docs.statuspal.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.statuspal.io/next/developers/mcp.md).

# MCP

Connect Claude, ChatGPT, Cursor, or any MCP-compatible AI assistant to StatusPal Next and manage your status pages, services, incidents, and webhooks in plain language with just your API key.

StatusPal Next provides a hosted **MCP server** that lets AI assistants such as Claude, ChatGPT, Cursor, and any other [MCP](https://modelcontextprotocol.io)-compatible client work with your status pages on your behalf. Once connected, you can ask your assistant to read and manage your status pages, services, incidents, maintenance notices, and webhooks in plain language.

## What you can do

After connecting, your assistant can:

* **Status pages**: list, view, create, update, and delete status pages.
* **Services and containers**: manage the services shown on a page and the containers they belong to.
* **Notices (incidents and maintenance)**: open an incident or schedule maintenance, post timeline updates, edit details, and resolve or close them.
* **Outgoing webhooks**: list, create, update, rotate secrets for, and delete webhooks.
* **Search the API docs**: answer questions about the StatusPal Next API without making any changes.

The server makes authenticated calls to the StatusPal Next API for you. It does not add any AI of its own; all the reasoning happens inside the assistant you already use.

## Before you start

You need a **StatusPal Next API key**. Create one under **Settings** → **API Keys** and copy it somewhere safe; you paste it once during setup. See [API keys](/next/developers/api-keys.md).

That key is the only credential required. The MCP server acts only on what that key has access to.

## The connection URL

There is a single endpoint for every client:

```
https://mcp.next.statuspal.io/mcp
```

How you provide your API key depends on the client:

* **Web assistants** (Claude.ai, ChatGPT, Grok): you paste your key once on a secure login page that appears automatically. There is nothing to configure by hand.
* **Developer and desktop tools** (Claude Code, Cursor, custom clients): you send the key in an `Authorization` header.

Pick your client below.

## Claude (web or Desktop)

1. Open Claude.
2. In the sidebar, click **Customize**, then **Connectors**.
3. Click the **+** button at the top and select **Add custom connector**.
4. Fill the form:
   * **Name**: `StatusPal Next`
   * **URL**: `https://mcp.next.statuspal.io/mcp`
   * Leave the optional OAuth fields empty.
   * Keep **Individual sign-in** enabled.
5. Click **Add**.
6. Open the new **StatusPal Next** connector and click **Connect**.
7. A browser window opens. Paste your StatusPal Next API key and click **Authorize**.
8. Click **Open Claude** or **Open desktop app**, depending on where you use Claude.

Then make sure the connector is enabled in a chat: click the **+** button below the chat input, hover **Connectors**, and check that **StatusPal Next** is on. The StatusPal tools now appear in the tools menu.

## ChatGPT

{% hint style="info" %}
Requires a plan that supports apps and developer mode (Plus, Pro, Business, or Enterprise).
{% endhint %}

1. Open **Settings** → **Apps**.
2. Click **Advanced settings** and enable **Developer mode**.
3. Click **Create app** and fill the form:
   * **Name**: `StatusPal Next`
   * **Connection**: **Server URL**
   * **Server URL**: `https://mcp.next.statuspal.io/mcp`
   * **Authentication**: **Access token / API key**
   * **Header scheme**: **Bearer**
4. Accept each warning and click **Create**.
5. Enter your StatusPal Next API key and click **Connect StatusPal Next**.

The app is now available inside chats.

## Grok

1. Open Grok.
2. In the sidebar, click **Skills and Connectors**, then **Connectors**.
3. Click **New Connector**, then **Custom**.
4. Fill the form:
   * **Name**: `StatusPal Next`
   * **Server URL**: `https://mcp.next.statuspal.io/mcp`
5. Click **Add Connector**.
6. A browser window opens. Paste your StatusPal Next API key and click **Authorize**.

Then make sure the connector is enabled in a chat: click the **+** button next to the chat input, hover **Connectors**, and check that **StatusPal Next** is on.

## Claude Code

Claude Code sends the key directly in a header, so no login page is needed. Run:

```bash
claude mcp add --transport http "StatusPal Next" \
  https://mcp.next.statuspal.io/mcp \
  --header "Authorization: Bearer YOUR_STATUSPAL_API_KEY"
```

Replace `YOUR_STATUSPAL_API_KEY` with your key. After adding it, enable it in the chat: click the **+** button below the input, open **Connectors**, and toggle **StatusPal Next** on.

## Codex for VS Code

1. Open Codex in VS Code and open **Codex Settings**.
2. Click **MCP servers**, then **Add server**, and fill the form:
   * **Name**: `StatusPal Next`
   * **Transport**: **Streamable HTTP**
   * **URL**: `https://mcp.next.statuspal.io/mcp`
   * Leave the bearer token and headers empty.
3. Click **Save**.
4. In the server list, click **Authenticate**. A browser window opens. Paste your StatusPal Next API key and click **Authorize**.
5. Make sure the server is enabled, then click **Restart extension**.

## Cursor and other developer clients

Any MCP client that supports **Streamable HTTP** with a custom header works the same way. Point it at:

```
https://mcp.next.statuspal.io/mcp
```

and add the header:

```
Authorization: Bearer YOUR_STATUSPAL_API_KEY
```

Browser-based custom clients also need their origin allow-listed for CORS. Contact StatusPal support if you're building one.

## Example prompts

Once connected, ask in natural language:

* "Configure a new status page with services: API, Web Console, Support Portal and regions: EU, US, Asia."
* "List my StatusPal status pages."
* "What services are on the *Production* page, and what's their current status?"
* "Open an incident on the *API* page: we're investigating elevated error rates."
* "Post an update: the issue is identified, a fix is rolling out now."
* "Mark the incident as resolved."
* "Schedule maintenance on the *Database* service for this Sunday 02:00 to 04:00 UTC."
* "Create an outgoing webhook pointing at <https://example.com/hooks/statuspal>."

The assistant asks for confirmation before anything that changes or deletes data.

## Privacy and security

* Your API key is never stored on our servers. For web assistants it is encrypted inside the connection token your client holds; for header-based clients it is only ever sent on the request. It is used solely to call the StatusPal Next API on your behalf.
* The server never logs your key or authorization headers.
* The assistant only has access to what your API key can access. Delete the key in **Settings** → **API Keys** at any time to cut off access immediately.

## Troubleshooting

| Problem                                    | Fix                                                                                                                                                                           |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Connector won't authorize                  | Check the URL is exactly `https://mcp.next.statuspal.io/mcp`. For web clients, complete the login page; for header clients, confirm the `Authorization: Bearer <key>` header. |
| "Tools not available" in chat              | Enable the connector via the **+** button and the **Connectors** toggle.                                                                                                      |
| Calls fail with an auth error              | Your API key may be invalid or deleted. Create a fresh one in **Settings** → **API Keys** and reconnect.                                                                      |
| Tools missing after a StatusPal API update | The tool list refreshes when you reconnect. Remove and re-add the connector.                                                                                                  |

Need help? Contact StatusPal support.