Surfer SEO MCP server for your AI

Read the SEO Content Score, 0 to 100, with status and calculated_at.

Read recommended length and structure from top-ranking pages: word_count, plus characters, headings, paragraphs and images.

Everything needed to write a page in one short answer: scores, length, terms, topics, facts and competitors.

List the ranking pages behind the guidelines: url, title, position, score, domain_score, and included (whether the page counts toward the guidelines).

List the terms to use: the main keyword first, then prominent terms from competitors and custom terms.

List topics and questions to cover, from Google's People Also Ask, competitor headings and custom additions.

Include or exclude terms, or add your own.

Include or exclude topics, or add your own.

Create a Content Editor for a keyword.

Create a Content Editor for a keyword and wait for it to be ready.

Delete a Content Editor and its document.

Read the document inside a Content Editor as Markdown (default) or HTML: pass format=html for HTML ready for a CMS.

Read one Content Editor: state (scheduled, executing, completed, failed), main and secondary keywords, content_score (total, seo, ai_search), target word count, template, voice, notes, meta title and description, sharing links, and the status of its outline, AI article, Auto-Optimize run and guidelines.

List Content Editors in one workspace, one page at a time.

Replace the whole document in a Content Editor.

Replace a document and wait for its new SEO and AI Search scores.

Change a Content Editor's settings: notes, custom_instructions (up to 5000 words), use_brand_knowledge, custom_voice_id, and surfer_template or custom_template_id (not both).

List the workspace's own content templates, one page at a time.

List Surfer's built-in templates: id, name, description.

Start writing an AI article in a Content Editor.

Start an AI article and wait for it, returning the text when it finishes.

Read an AI article's state and settings.

List the workspace's custom writing voices, one page at a time.

Start a SERP Analyzer query for a keyword.

Read the ranking pages of a finished SERP Analyzer query, as rows: position, url, state, and word, keyword, heading, image and page speed counts, up to the top 50 pages.

List the workspace's SERP Analyzer queries from the last month: id, state, created, location, keyword.

Read the AI Search guidelines: facts found in search results and in AI engines (Google AI Overviews and AI Mode, Gemini, OpenAI, Perplexity) with their sources, the AI Search score, and factors showing which facts the draft covers and how its introduction does.

Read the AI Search score, 0 to 100, with status (ready, loading, calculating, error, unavailable), calculated_at and factors.

Read how brands appear in AI answers for a project and date range.

Read which sources AI answers cite for a project and date range, and the brands they mention.

Read one Auto-Optimize run.

List the workspace's AI Tracker projects.

Run Auto-Optimize on a Content Editor.

On a signed-in connection, run any Surfer tool by name, including ones added after connecting.

Start an Audit of a live page against a keyword.

Estimate how likely a text is to be AI-written.

Search the location names Surfer accepts.

Read an Audit by id.

Read the outline Surfer built from the search results, as Markdown (default) or HTML.

Rewrite a text so it reads more naturally while keeping its meaning, and get the new text back.

On a signed-in connection, list Surfer's live tool set with parameter schemas.

List the workspaces in this Surfer organization: id, name, type, state, location and connected Search Console site.

Read all of a Content Editor's SEO guidelines at once: score, structure, competitors, terms, topics and questions.

Read a short status of the SEO guidelines: status, score, can_load_more_competitors, load_more_status.

Ask Surfer to load more competitors from the search results, in the background.

Choose which competitors count, then Surfer recalculates the guidelines.

Set your own targets.

List Content Editors across every workspace in the organization, newest first by default, one page at a time.

Create a content template from an example of the structure you want.

Permanently delete a content template.

Read one content template, including its reference text.

Same as surfer_update_content_template, under the PUT method Surfer also documents.

Change a content template's name, reference_text (at least 200 words) or default flag.

Create a custom voice from a sample of the writing style.

Permanently delete a custom voice.

Read the outline of the editor's active AI article as Markdown (default) or HTML.

Read one custom voice, including its reference text.

List the AI articles generated for a Content Editor, with each one's id and state.

Same as surfer_update_custom_voice, under the PUT method Surfer also documents.

Send an edited outline and let the AI article carry on writing.

Change a custom voice's name, reference_text (at least 200 words) or default flag.

Start several SERP Analyzer queries at once.

Read the prominent words and phrases of a finished SERP Analyzer query, as rows: term, pages, density and word counts.

Read the most recent Auto-Optimize run of a Content Editor, in any state.

List only the AI Search facts, each with its source urls and where it was cited.

List every location name Surfer accepts, several thousand of them.

List the links that share a Content Editor, by type (edit, comment).

Retry an outline that failed.

Replace a Content Editor's sharing links, so the old ones stop working for everyone.