MCP

Use the Pinnate MCP server from Cursor or Claude Code.

Pinnate ships a thin MCP server that wraps the REST API so coding agents can list sites, edit pages, publish, and upload OpenAPI without hand-writing HTTP.

Setup

Create an organization API key
Run the MCP server from the Pinnate app (tools/mcp) with:

PINNATE_API_KEY=sk_…
PINNATE_API_URL=https://app.pinnate.dev

Point your agent (Cursor / Claude Code / etc.) at that MCP server

Typical tools

Tool	Purpose
`list_sites` / `create_site`	Sites
`list_pages` / `get_page` / `create_page` / `update_page` / `delete_page`	Guide pages
`publish_site`	Publish snapshot
`upload_spec`	OpenAPI upload

When to use MCP vs git

Use MCP when	Use git when
Updating a live site quickly	You want PR review
No customer docs remote yet	Docs-as-code is the source of truth
CI needs a one-shot publish	Long-lived editorial workflow

Docs MCP for readers

Published sites already expose llms.txt and per-page .md mirrors for agents and crawlers.

Coming soon — A read-oriented docs MCP endpoint that wraps that surface for tool-calling clients.