Surfer MCP

• Create and fetch Content Editors (keyword, location, device, secondary keywords, templates, custom voices, custom instructions)

• Fetch SEO guidelines and check term, structure, and topic coverage

• Fetch only the missing SEO and AI Search guidelines (terms and facts), not just the full set

• Fetch AI Search (AIO) guidelines — source-attributed facts from the SERP and major AI engines (AI Overviews, AI Mode, Gemini, OpenAI, Perplexity)

• Manage SERP competitors (include/exclude, load more, recalculate guidelines)

• Fetch and regenerate outlines

• Generate full Surfer AI articles, with optional manual outline review

• Add internal and external links to generated Surfer AI articles

• Fetch and update your content in Markdown or HTML

• Re-score content for SEO, AI Search, and total score

• Run Auto-Optimize and track its status

• Get shareable permalinks

• List and fetch your AI Tracker projects

• Pull visibility summaries — mention rate, position in the answer, and presence score per AI model

• View daily visibility trends over time

• Review tracked prompts, grouped by topic

• See cited sources (by domain or URL, per model, with a brand-mention flag)

• List the brands AI answers mention

• Fetch your mention gaps

• Fetch Content Audit pages to optimize

• Fetch Topical Map ideas to write

• Create a workspace from a brand website URL, then list, fetch, and activate workspaces

• Fetch and update brand knowledge

• Create, fetch, update, and delete custom voices

• Create, fetch, update, and delete content templates

• surfer-content-recommendations — Act on Surfer's site recommendations; picks recommendation-led Write or Optimize work and delegates to the relevant skill below.

• surfer-create-content-brief — Build a writer-ready brief with SEO + AI Search guidance, SERP/competitor analysis, structure, terms, and questions (no draft written).

• surfer-create-outline — Generate a SERP-informed article outline without a full draft.

• surfer-manage-content-templates — Create, inspect, update, choose, or delete reusable content templates.

• surfer-optimize-content — Improve an existing article's/page's SEO Score and/or AI Search Score.

• surfer-write-article — Write a brand-new SEO/AI-Search-optimized article or blog post from a keyword or topic.

• Content Editor

  • content_editor__create

  • content_editor__get

  • content_editor__list

  • content_editor__update

  • content__get

  • content__update

  • content_score__get

  • outline__get

  • outline__regenerate

  • permalink__list

• SEO Guidelines

  • seo_guidelines__get

  • seo_guidelines__get_terms_coverage

  • seo_guidelines__update_terms

  • seo_guidelines__update_structure

  • seo_guidelines__update_competitors

  • seo_guidelines__update_topics_and_questions

  • seo_guidelines__load_more_competitors

• AI Search Guidelines

  • ai_search_guidelines__get

  • ai_search_guidelines__list_facts

• AI Article

  • ai_article__generate

  • ai_article__get

  • ai_article__list

  • ai_article__get_outline

  • ai_article__submit_outline

• Auto-Optimize

  • auto_optimize__run

  • auto_optimize__get

• AI Tracker

  • ai_tracker__list

  • ai_tracker__get

  • ai_tracker__get_summary

  • ai_tracker__get_time_series

  • ai_tracker__list_prompts

  • ai_tracker__list_sources

  • ai_tracker__list_brands

  • ai_tracker__get_mention_gap

• Recommendations

  • recommendation__list

  • recommendation__optimize

• Workspace

  • workspace__list

  • workspace__get

  • workspace__create

  • workspace__activate

• Brand

  • brand__get

  • brand__update

• Custom Voices

  • custom_voice__list

  • custom_voice__get

  • custom_voice__create

  • custom_voice__update

  • custom_voice__delete

• Content Templates

  • content_template__list

  • content_template__get

  • content_template__create

  • content_template__update

  • content_template__delete

  • surfer_content_template__list

• Skills

  • skill__list

  • skill__get

1. In claude.ai or the Claude desktop app, open Customize → Connectors and click Add custom connector.

2. Name it Surfer, paste the server URL, and select Continue.

3. Keep the detected authentication settings and click Add.

4. Click Connect next to Surfer and sign in. If you have more than one organization, pick it and select Authorize.

5. In a new chat, enable Surfer under + → Connectors.

Note: Free Claude plans allow one custom connector. On Team and Enterprise plans, an owner adds it under Organization settings → Connectors → Add → Custom, then each member clicks Connect on it in Customize → Connectors.

1. Run this in your terminal. Drop --scope user to add Surfer to the current project only:

   claude mcp add --transport http --scope user surfer https://mcp.surferseo.com/mcp

2. Start Claude Code, run /mcp, select surfer, and choose Authenticate. Sign in with your Surfer account in the browser. If the browser doesn't open, copy the URL Claude Code prints and open it yourself.

1. In ChatGPT, open Settings → Security and login and turn on Developer mode.

2. Go to chatgpt.com/plugins and click +. Name it Surfer, paste the server URL as the server URL, choose OAuth, tick I understand and want to continue, and click Create.

3. On the plugin page, click Connect, then Sign in with Surfer. If you have more than one organization, pick it and select Authorize.

4. In a chat, open the + menu, choose Developer mode, and select Surfer.

Note: Developer mode works on ChatGPT web for Plus, Pro, Business, Enterprise, and Edu accounts. Availability can depend on your workspace policy.

1. Run this in your terminal and sign in with your Surfer account when the browser opens:

   codex mcp add surfer --url https://mcp.surferseo.com/mcp

2. If the browser doesn't open, sign in with:

   codex mcp login surfer

Instead of the command in step 1, you can add this to ~/.codex/config.toml yourself:

[mcp_servers.surfer]
url = "https://mcp.surferseo.com/mcp"

Note: The Codex CLI, the Codex IDE extension, and the ChatGPT desktop app share this config file.

1. Add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project) and save:

json

   {
     "mcpServers": {
       "surfer": {
         "url": "https://mcp.surferseo.com/mcp"
       }
     }
   }

2. Open Customize → MCPs, click Authenticate on the surfer row, and sign in with your Surfer account. The row reads Ready once connected.