---
title: "MCP server"
source: "https://docs.palt.io/mcp-server"
---

# MCP server

palt.io runs an MCP server, so AI assistants can manage your docs in conversation: "push the spec in this repo to my payments project", "write a quickstart page", "make 2.1.0 the default".

```
https://www.palt.io/api/v1/mcp
```

It authenticates with an API key as a bearer token, like the REST API. Step-by-step setup for Claude Code, Cursor, VS Code, Claude Desktop, Codex, Gemini CLI and Devin Desktop (formerly Windsurf) is at [palt.io/mcp](https://www.palt.io/mcp).

## Claude Code

```bash
claude mcp add --transport http palt https://www.palt.io/api/v1/mcp \
  --header "Authorization: Bearer $PALT_API_KEY"
```

## Cursor and other clients

Add a server with the URL above and the header `Authorization: Bearer pk_live_…`. For clients configured with JSON:

```json
{
  "mcpServers": {
    "palt": {
      "url": "https://www.palt.io/api/v1/mcp",
      "headers": { "Authorization": "Bearer pk_live_…" }
    }
  }
}
```

## Tools

| Tool | What it does |
| --- | --- |
| `whoami` | The account, plan, limits and usage |
| `list_projects`, `get_project` | Your documentation projects |
| `create_project`, `update_project` | Create a project; change its name, description and branding |
| `list_specs`, `get_spec` | Spec versions; optionally the full OpenAPI document |
| `push_spec` | Import a spec from text or a URL, or replace a version |
| `update_spec` | Publish, unpublish or make a version the default |
| `delete_spec` | Delete a version |
| `list_pages`, `get_page` | Guide pages and their markdown |
| `write_page` | Create or replace a page from markdown |
| `delete_page` | Delete a page |

`delete_spec` and `delete_page` are marked destructive, so clients that ask before risky actions will ask.