> ## Documentation Index
> Fetch the complete documentation index at: https://devs.surferseo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Surfer MCP

> Connect AI tools and agents to Surfer.

Connect your AI assistant to Surfer to write and optimize articles, work with live SEO guidelines and content scores, and explore your brand's visibility in AI answers.

Add Surfer's hosted [Model Context Protocol](https://modelcontextprotocol.io/introduction) server at `https://mcp.surferseo.com/mcp` to your MCP client and sign in with your Surfer account.

Connect with Claude, Claude Code, ChatGPT on the web or desktop, Cursor, VS Code, or Codex. Other clients need Streamable HTTP and OAuth support; see [Quickstart](/mcp/quickstart).

Use the [capabilities overview](/mcp/tools/index) to see what your assistant can read and change. [Skills](/mcp/skills) guide complete workflows such as writing or optimizing an article.

A workspace is a brand or site you manage in Surfer, with its own Search Console property, type, location, and state. Almost every tool takes one.

## Requirements

* A plan that includes MCP; [Credits and limits](/mcp/credits-and-limits#plans-that-include-mcp) lists them.
* An MCP client that supports Streamable HTTP with OAuth. Setup per client is in [Quickstart](/mcp/quickstart).
* Your own Surfer account, with one organization chosen at sign-in. See [Authentication](/mcp/authentication).

<Note>
  Your connection is bound to your account and the chosen organization, across
  every tool; see [What connecting
  grants](/mcp/security#what-connecting-grants).
</Note>

## Next steps

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/mcp/quickstart">
    Choose your client, connect Surfer, and run your first request.
  </Card>

  <Card title="Use cases" icon="lightbulb" href="/mcp/use-cases">
    Example prompts for writing, optimizing, tracking, and reporting.
  </Card>

  <Card title="Skills" icon="wand-magic-sparkles" href="/mcp/skills">
    Built-in workflows and when to use each.
  </Card>

  <Card title="Capabilities" icon="book" href="/mcp/tools/index">
    The content, workspace, and AI Tracker tasks your assistant can perform.
  </Card>

  <Card title="Credits and limits" icon="coins" href="/mcp/credits-and-limits">
    Plans, credits, and the limits that apply to tool calls.
  </Card>
</Columns>

If a client will not connect or a tool call fails, start with [Troubleshooting](/mcp/troubleshooting). For questions these pages do not answer, contact [support@surferseo.com](mailto:support@surferseo.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.