# Serpier MCP

> Connect Claude, ChatGPT, Cursor, VS Code, or Claude Code to Serpier so an assistant can search the marketplace, fill your cart, follow orders, and read monitoring.

Source: https://docs.serpier.com/mcp

The Serpier MCP server lets an AI assistant such as Claude, ChatGPT, Cursor, or Claude Code work in your Serpier account: search the [Marketplace](https://docs.serpier.com/marketplace), fill your [cart](https://docs.serpier.com/cart), follow [orders](https://docs.serpier.com/orders), and read your [Publication Tracker](https://docs.serpier.com/publication-tracker) and [AI visibility](https://docs.serpier.com/ai-visibility) data. Claude and ChatGPT sign in with OAuth on any plan. Other clients use a personal access token. For scripts and integrations without an assistant, use the [REST API](https://docs.serpier.com/rest-api).

## Server URL

Every client uses the same URL:

```text
https://app.serpier.com/api/mcp
```

The transport is streamable HTTP. There is nothing to install on your machine.

## Choose how to sign in

- **OAuth** (Claude and ChatGPT): you sign in to Serpier in the browser and allow access. The client keeps the token, and you never paste a key. Works on any plan.
- **Personal access token** (Cursor, VS Code, Claude Code, and other clients): the client sends your token in the `x-api-key` header. Creating a token needs the Enterprise API entitlement; see [Create a personal access token](https://docs.serpier.com/account-settings#create-a-personal-access-token). Tokens start with `srpr_`.

## Connect Claude

1. In Claude, go to **Settings** > **Connectors** and select **Add custom connector**.
2. Name it Serpier and paste the server URL. Leave the detected OAuth settings as they are and select **Add**.
3. Sign in with your Serpier account and allow access.
4. Enable the connector in a new chat before you ask Claude to use your account.

## Connect ChatGPT

1. Add a custom app in ChatGPT with the server URL.
2. Select **Authenticate**, sign in to Serpier, and allow access.

The app is ready when you return to ChatGPT. ChatGPT cannot place orders or open the billing portal; finish those in Serpier.

## Connect Claude Code

Replace the token in this command, then run it:

```bash
claude mcp add --transport http serpier https://app.serpier.com/api/mcp --header "x-api-key: srpr_YOUR_TOKEN"
```

## Connect Cursor or VS Code

Add this server to your MCP configuration and replace the token:

```json
{
  "mcpServers": {
    "serpier": {
      "type": "http",
      "url": "https://app.serpier.com/api/mcp",
      "headers": {
        "x-api-key": "srpr_YOUR_TOKEN"
      }
    }
  }
}
```

If your organization has API access, **Connect AI agents (MCP)** on the **Personal access tokens** card in [Settings](https://app.serpier.com/account/settings) also has **Add to Cursor** and **Add to VS Code** buttons.

## Connect other clients

Any client that supports remote MCP can use the server URL. If it takes an API key, send your token as `x-api-key`. This command registers the server with that header:

```bash
npx add-mcp https://app.serpier.com/api/mcp --header "x-api-key: srpr_YOUR_TOKEN" -n serpier -g -y
```

## Which organization the assistant works in

With OAuth, the **Connect Serpier** screen asks which organization and team to allow when you belong to more than one. The assistant stays on that organization and team until you connect again.

![The Connect Serpier screen with the Allow access button](https://docs.serpier.com/docs-assets/mcp-allow-access.webp "Allowing access lets the client read your account and place orders that spend budget.")

With a personal access token, the assistant uses the organization and team that are active on your account.

## What the assistant can do

- Search the Marketplace and see which content products you can order.
- Read and change the cart, and place an order.
- Read and create projects, read orders, and fill in the brief on an order.
- Read the Publication Tracker and add publications to it.
- Set up AI visibility monitoring, manage tracked prompts, and start runs.
- [SEO Performance](https://docs.serpier.com/seo-performance) is not on the MCP server yet. Ask [Navi](https://docs.serpier.com/navi) about your rankings, keywords, and backlinks instead.
- Open the billing portal.

> Placing an order spends your organization's budget, and AI visibility runs use [Navi credits](https://docs.serpier.com/billing#navi-credits). Review what the assistant proposes before you confirm.

## Stop access

Serpier receives each tool call and returns the result to the client you connected. To stop new calls, disconnect the client, or delete the personal access token in Settings. The [privacy policy](https://serpier.com/privacy-policy) describes the data a tool result can include.

## Related

- [REST API](https://docs.serpier.com/rest-api.md)
- [Settings](https://docs.serpier.com/account-settings.md)
- [Billing](https://docs.serpier.com/billing.md)
- [Navi](https://docs.serpier.com/navi.md)