# PilotDeck Docs: for AI agents > Setup guides and the MCP server reference for PilotDeck, a growth platform for SEO, GEO and AI visibility. Last content change: 2026-11-12 ## What this site is PilotDeck researches what a business's buyers search and ask, writes content for it, publishes approved content and tracks visibility in search and in AI answers. This site explains how to connect PilotDeck to search data, a website, social accounts and AI assistants. Drafts wait for approval by default. ## How to read this site - Every page has a Markdown copy at its own URL plus `.md`. Read those instead of the HTML. - Home page and index of every guide: `https://docs.pilotdeck.co/index.md` - Category overview: `https://docs.pilotdeck.co/.md`, for example `https://docs.pilotdeck.co/ai-assistants.md` - Guide: `https://docs.pilotdeck.co//.md`, for example `https://docs.pilotdeck.co/ai-assistants/claude.md` - The web page is the same URL without `.md`. Link people to the web page. - Sections are anchors on the web page, such as `https://docs.pilotdeck.co/ai-assistants/claude#s1`. In the Markdown each heading has the same anchor just above it, such as ``, and steps read `## Step 1: ...`. - Every guide below in one file: `https://docs.pilotdeck.co/llms-full.txt` ## Use PilotDeck from an AI agent PilotDeck runs a remote MCP server. It gives an agent access to one PilotDeck site, and it is the supported way for an agent to work with PilotDeck. - Server URL: `https://api.pilotdeck.co/mcp` - Transport: Streamable HTTP, `POST` only, stateless, JSON responses - Sign-in: OAuth 2.1 with PKCE and dynamic client registration. Discovery starts at `https://api.pilotdeck.co/.well-known/oauth-protected-resource`, and a `401` from the server points to it. - Token: a person can create one in PilotDeck under Settings > Integrations, then send `Authorization: Bearer ` - Access: one user and one site per connection - Plans: every plan. A workspace with no active plan gets `402`. - Limit: 60 tool calls a minute per token, 20 calls in one batch An agent can: - Read the plan with its reasons, briefs, verified facts, drafts, AI visibility, competitors and usage - Check a draft against the site's rules and verified facts - Save an edited draft as a new version - Edit the brand profile - Add or change tracked AI questions - Set the competitors to research while that review is open - Give feedback on social posts An agent cannot: - Publish, approve or delete content - Change billing, the publish mode, draft handling, connections or tokens - Reach another site or another account Reference and endpoints: - [PilotDeck MCP server reference](https://docs.pilotdeck.co/ai-assistants/mcp-server.md): Every tool with its inputs, scopes, limits, sign-in details and error codes - [Connect Claude to PilotDeck](https://docs.pilotdeck.co/ai-assistants/claude.md): Sign in from Claude, no token - [Connect an AI agent with an MCP token](https://docs.pilotdeck.co/ai-assistants/mcp-token.md): Claude Code, Cursor and other MCP clients - [MCP server endpoint](https://api.pilotdeck.co/mcp): POST only. Needs a token or OAuth sign-in. - [OAuth protected resource metadata](https://api.pilotdeck.co/.well-known/oauth-protected-resource): RFC 9728 discovery - [OAuth authorization server metadata](https://api.pilotdeck.co/.well-known/oauth-authorization-server): RFC 8414 discovery - [OpenAPI description](https://docs.pilotdeck.co/openapi.json): The MCP endpoint and OAuth endpoints only. MCP clients do not need it; it is for tools that read OpenAPI. ## All Markdown files by category ### Publish modes - [Publish modes overview](https://docs.pilotdeck.co/publish-mode.md): Choose how approved content reaches your site: we manage it end to end with Clone, publish to your CMS, or copy it yourself. - [Clone mode](https://docs.pilotdeck.co/publish-mode/clone.md): Clone mode connects your repository and hosting so articles, SEO fixes and new pages are applied and deployed for you. See access needed, workflow and limits. - [CMS mode](https://docs.pilotdeck.co/publish-mode/cms.md): CMS mode publishes approved articles straight to your existing CMS. See the workflow, supported platforms, connection methods, draft or live policy and limits. - [Copy mode](https://docs.pilotdeck.co/publish-mode/copy.md): Copy mode prepares every article for you to paste into your own site. No access is needed. See the workflow, download contents, benefits and limits. ### Search & analytics - [Search & analytics overview](https://docs.pilotdeck.co/search-console.md): Connect the data sources that feed the PilotDeck engine. Google Search Console is the only required connection. - [Connect Google Search Console to PilotDeck](https://docs.pilotdeck.co/search-console/google-search-console.md): Authorise Google Search Console so PilotDeck can read rankings and clicks. The only required connection. ### CMS connection - [CMS connection overview](https://docs.pilotdeck.co/cms-connection.md): Link your website platform so approved articles are created in your CMS without copy and paste. - [Connect Webflow to PilotDeck](https://docs.pilotdeck.co/cms-connection/webflow.md): Generate a Webflow Site API token, paste it to load your real Collections, map one to each kind of content and verify the integration. - [Connect WordPress to PilotDeck](https://docs.pilotdeck.co/cms-connection/wordpress.md): Install the PilotDeck Connector plugin, paste one Integration Key in PilotDeck, choose a publish mode and verify posts arrive in WordPress. - [Connect Webhook to PilotDeck](https://docs.pilotdeck.co/cms-connection/webhook.md): Send each approved article as a signed JSON POST to your own endpoint, route each kind of content to its own URL, verify the HMAC signature and test the link. - [Connect Ghost to PilotDeck](https://docs.pilotdeck.co/cms-connection/ghost.md): Create a Ghost Custom Integration, connect its Admin API key in PilotDeck, map a tag to each kind of content and verify the integration. - [Connect Wix to PilotDeck](https://docs.pilotdeck.co/cms-connection/wix.md): Create a Wix API key, find your site ID, connect both in PilotDeck, map an existing Blog category to each kind of content and verify. - [Connect Shopify to PilotDeck](https://docs.pilotdeck.co/cms-connection/shopify.md): Create a custom app in Shopify, copy its Admin API access token, map a blog to each kind of content and verify the integration. - [Connect Notion to PilotDeck](https://docs.pilotdeck.co/cms-connection/notion.md): Create a Notion internal integration, share a database with it, map each kind of content to a database and publish articles as pages. ### Social connections - [Social connections overview](https://docs.pilotdeck.co/social-connections.md): Connect a social scheduling tool so PilotDeck can share what you publish, and choose which accounts each site uses. - [Connect Publer to PilotDeck](https://docs.pilotdeck.co/social-connections/publer.md): Create a Publer API key, connect it with your Workspace ID in PilotDeck and send social posts to Publer as drafts you release yourself. - [Connect Buffer to PilotDeck](https://docs.pilotdeck.co/social-connections/buffer.md): Create a Buffer API key, connect it in PilotDeck, check your channels and see how approved posts reach Buffer as drafts. - [Connect Postiz to PilotDeck](https://docs.pilotdeck.co/social-connections/postiz.md): Create a Postiz API key, connect it in PilotDeck, pick the accounts a site uses and check that posts arrive in Postiz as drafts you release. - [Choose which social accounts a site uses](https://docs.pilotdeck.co/social-connections/account-mapping.md): Choose which connected social accounts each PilotDeck site publishes to. ### AI assistants - [AI assistants overview](https://docs.pilotdeck.co/ai-assistants.md): Connect an AI assistant such as Claude to one PilotDeck site, so you can review your plan, check drafts and track AI visibility in a chat. - [Connect Claude to PilotDeck](https://docs.pilotdeck.co/ai-assistants/claude.md): Connect Claude to one PilotDeck site to review your plan and drafts, check a draft against your rules and track AI visibility from a chat. - [Connect an AI agent with an MCP token](https://docs.pilotdeck.co/ai-assistants/mcp-token.md): Create a PilotDeck token in Settings and add it to Claude Code, Cursor or another MCP client to work with one site. - [PilotDeck MCP server reference](https://docs.pilotdeck.co/ai-assistants/mcp-server.md): Every tool, ability, limit and error code of the PilotDeck MCP server, plus how sign-in and tokens work, for people building or debugging an AI agent. ## Planned guides (no page yet) - Connect Bing Webmaster Tools - Connect ChatGPT to PilotDeck - Connect Google Analytics 4 - Connect Google Business Profile - Connect Hootsuite ## PilotDeck - [PilotDeck](https://pilotdeck.co): Marketing site: what PilotDeck is and what it does - [PilotDeck app](https://app.pilotdeck.co): Where customers sign in and work. Not for crawling. - [Sign up](https://app.pilotdeck.co/signup) - [Pricing](https://pilotdeck.co/pricing) - [Contact](https://pilotdeck.co/contact) - [Support email](mailto:support@pilotdeck.co) ## Optional - [All guides in one file](https://docs.pilotdeck.co/llms-full.txt): Large. Use it only when you need the whole site. - [Instructions for AI agents](https://docs.pilotdeck.co/agents.txt): This index plus what an agent can and cannot do - [Changelog](https://docs.pilotdeck.co/changelog.md): Important documentation updates by date, with a link to each page - [Sitemap](https://docs.pilotdeck.co/sitemap.xml) - [PilotDeck product summary](https://pilotdeck.co/llms.txt): Features, plans and pricing from the marketing site - [Product changelog](https://pilotdeck.co/changelog): PilotDeck releases, as opposed to documentation changes