# Connect Spiral to your agent

> Spiral is an AI writing agent that learns your voice and writes in it. Connect it to your AI agent or coding assistant over MCP and your agent can draft, edit, and humanize text in your style, and manage your writing styles, workspaces, and drafts.

Spiral exposes a remote **MCP** (Model Context Protocol) server. Add it to any MCP-capable client. There is **no API key to paste**: the first connection opens a browser to sign in to Spiral and authorize access via OAuth.

- **MCP server URL:** https://api.writewithspiral.com/mcp/
- **Transport:** Streamable HTTP
- **Auth:** OAuth (browser sign-in on first connect)

Find your client below. If it is not listed, use the "Any MCP client" section.

## Claude Code

Run this in your terminal (or paste it to Claude Code directly):

```bash
claude mcp add --transport http --scope user spiral https://api.writewithspiral.com/mcp/
```

After you authorize in the browser, Spiral's tools become available. If they do not appear in your current session, restart Claude Code — a server added mid-session is sometimes only picked up on the next start.

## Claude (claude.ai web or desktop)

Spiral is not in Claude's connector directory, so searching for it there will not find it — add it as a custom connector:

1. Open Claude, then go to **Settings → Connectors → Add custom connector**.
2. Set **Name** to `Spiral` and **Remote MCP server URL** to `https://api.writewithspiral.com/mcp/`.
3. Press **Connect** and follow the steps on the consent screen.

Or open the add-connector screen directly (Name and URL prefilled):

https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Spiral&connectorUrl=https%3A%2F%2Fapi.writewithspiral.com%2Fmcp%2F

## Cursor

One-click install (opens Cursor and prefills the server):

cursor://anysphere.cursor-deeplink/mcp/install?name=spiral&config=eyJ1cmwiOiJodHRwczovL2FwaS53cml0ZXdpdGhzcGlyYWwuY29tL21jcC8ifQ==

Or create/edit `~/.cursor/mcp.json` manually:

```json
{
  "mcpServers": {
    "spiral": { "url": "https://api.writewithspiral.com/mcp/" }
  }
}
```

## VS Code

Run:

```bash
code --add-mcp '{"name":"spiral","type":"http","url":"https://api.writewithspiral.com/mcp/"}'
```

## Codex

Run in your terminal:

```bash
codex mcp add spiral --url https://api.writewithspiral.com/mcp/
codex mcp login spiral
```

Or add it to `~/.codex/config.toml` (then run `codex mcp login spiral`):

```toml
[mcp_servers.spiral]
url = "https://api.writewithspiral.com/mcp/"
```

## ChatGPT

Custom connectors require **Developer mode** (web, on a paid plan). Turn it on under **Settings → Connectors → Advanced**, then click **Create**:

1. **Name:** `Spiral`
2. **MCP server URL:** `https://api.writewithspiral.com/mcp/`
3. **Authentication:** OAuth

Then connect and authorize access.

## Any MCP client

Add a remote, Streamable HTTP MCP server pointing at `https://api.writewithspiral.com/mcp/` using your client's normal mechanism for remote MCP servers. The first connection opens a browser to sign in to Spiral and authorize access over OAuth; there is no API key to paste.

## Plans & access

Setup and read tools work on any Spiral account — checking readiness, listing styles, workspaces, sessions, and drafts, and reporting voice status and quota.

The three writing tools — `spiral_generate_writing`, `spiral_personalize_text`, and `spiral_humanize_text` — require a paid Spiral plan. On a free account the first writing call returns a short message with a checkout link instead of a draft. When you see that, share the link with the user so they can subscribe — don't retry the call, it will keep returning the same paywall until they do. Call `spiral_check_quota` to read the current plan and remaining usage before you start.

## After you connect

Your agent gains tools to write, personalize, and humanize text in your voice, and to manage your writing styles, workspaces, and drafts. Try asking it to draft a post in your voice, rewrite something to sound like you, or build a writing style from a few samples.

- Open Spiral: https://app.writewithspiral.com/
- About Spiral: https://writewithspiral.com/
- Agent manifest: https://writewithspiral.com/llms.txt
- Questions: hi@writewithspiral.com