Surfer SEO MCP. Run deep audits and score content, right from the prompt.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Surfer SEO connects your AI agent to professional content optimization tools. It lets you run deep SERP audits, check live content scores, and extract high-ranking keyword guidelines—all without leaving your chat window or IDE.
Use it to audit a URL with `create_seo_audit` or generate an editor draft using `create_content_editor`.
What your AI agents can do
Create content editor
Starts an asynchronous query to build a new Content Editor draft using specified keywords and country code.
Create seo audit
Creates an SEO audit job for any live URL, requiring the full address and target keyword.
Create serp analyzer
Starts a query to identify core ranking factors based on a given search term.
Creates an SEO audit for a specific URL, identifying structural content gaps and ranking deficits.
Initializes a Content Editor draft based on target keywords, country code, and desired writing parameters.
Retrieves the current optimization score for any content draft you've started using get_content_score.
Runs a SERP Analyzer to map out common ranking factors and prominent NLP terms used by top competitors.
Lists all existing SEO audits (list_seo_audits) or Content Editor sessions (list_content_editors) in your account.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Surfer SEO MCP Server: 10 Tools for SEO Analysis
These tools allow your AI client to perform advanced content audits, analyze competitor search results, and manage structured writing workflows programmatically.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Surfer SEO on Vinkius019d760fcreate content editor
Starts an asynchronous query to build a new Content Editor draft using specified keywords and country code.
019d760fcreate seo audit
Creates an SEO audit job for any live URL, requiring the full address and target keyword.
019d760fcreate serp analyzer
Starts a query to identify core ranking factors based on a given search term.
019d760fget audit details
Retrieves the final, specific details for an SEO audit that was previously run.
019d760fget content editor details
Pulls the full content and usage guidelines associated with a Content Editor draft query.
019d760fget content score
Checks the current optimization score for any active content editor entry, showing its structural quality.
019d760fget prominent terms
Extracts high-value NLP terms from a completed SERP analysis job, giving you specific keywords to use.
019d760fget serp results
Fetches the raw search results data generated by the SERP Analyzer for detailed review.
019d760flist content editors
Shows a list of all Content Editor queries currently stored in your account's history.
019d760flist seo audits
Displays a comprehensive list of every SEO audit that has been performed for your domain.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Surfer SEO, then connect any of our 4,900+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,900+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Surfer SEO. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
The old way: Opening a new browser tab for every metric.
Today, checking content compliance is a multi-tab nightmare. You open the live URL in one tab, run it through an external tool's dashboard in another, copy the word count into Google Docs, and then manually cross-reference missing keywords with a third competitor report. It’s slow, brittle, and you lose context.
With this MCP server, your agent manages that entire process. You just tell it to run `create_seo_audit` on the page. The results—including structural deficits and content scores—show up in one clean response block. You never leave the chat.
Surfer SEO MCP Server: Content Editor Workflow
Before, creating a new optimized draft meant signing up for an editor interface, filling out forms, and hoping the output was what you needed. You had to manually verify if your text hit the required keyword density or score.
Now, use `create_content_editor` to start a structured draft based on keywords. When you're done writing, simply ask for `get_content_score`. It instantly tells you if you hit 75/100 and what specific terms are still missing—no guessing involved.
What you can do with this MCP connector
Surfer SEO MCP Server - Audit & Score Content with AI
You don't gotta jump between ten different tabs or copy-paste data back into a spreadsheet just to run an SEO audit. This server lets your agent handle deep content optimization directly inside your chat window or IDE. It treats your LLM like it’s got the full stack of professional tools, letting you run competitor analysis, check live scores, and build structured drafts—all from one place.
Running Full Site Audits
Need to know what's weak with a page? You start by kicking off an audit for any specific URL. Just tell your agent the full address and the target keyword; it runs that job using create_seo_audit. This initializes an SEO audit job, scanning the site for structural content gaps and ranking deficits against your specified keyword.
Once that initial scan is done, you retrieve the final, detailed breakdown of everything found by calling get_audit_details. That gives you the exact metrics on what's missing from the page to improve its ranking potential.
To keep track of all the work you do, your agent can show you a list of every single SEO audit run for your domain using list_seo_audits.
Generating Structured Drafts and Scores
Want to write something new? You initiate a Content Editor draft. This starts an asynchronous query using create_content_editor, letting you specify the target keywords and even the country code for localization. After that initial setup, your agent fetches all the usage guidelines and the full content parameters associated with that specific draft by calling get_content_editor_details.
Once you have a working draft in place, checking its quality is simple: use get_content_score to pull up the current optimization score and see its structural readiness. You can also view all your previous Content Editor sessions—every single writing template you've started—by calling list_content_editors.
Analyzing Competition and SERP Data
If you want to know what top-ranking competitors are doing, first run a query using create_serp_analyzer. You feed it just the search term, and it maps out the common ranking factors based on how Google sees that search. Once that analysis job is done, your agent pulls those insights for you.
It extracts high-value NLP terms—those specific keywords top content uses—with get_prominent_terms. If you want to see the raw data set from the competitor results, you can fetch everything by calling get_serp_results.
Managing Your Workflow History
Your agent keeps track of it all. You never lose a job or forget which audit you ran last month. To get a comprehensive list of every Content Editor query currently stored in your account's history, use list_content_editors. Likewise, to see a definitive record of every SEO audit that’s been performed for your site, just call list_seo_audits.
This whole setup means you can run full audits, generate structured content drafts with real-time quality checks, and map out competitor search results—all without ever leaving the prompt line.
019d760f-4dee-73ed-97e7-134837249b78 
How Surfer SEO MCP Works
- 1 Append the Surfer SEO MCP module to your integrations panel and submit your private
SURFER_KEYfor secure authentication. - 2 Tell your agent what you need. For example: "Run a SERP Analyzer on 'best remote desktop software' targeting the US." The agent calls
create_serp_analyzer. - 3 Once the data is ready, ask the agent to retrieve results. You might use
get_prominent_termsorget_serp_resultsto pull actionable keywords directly into your workflow.
The bottom line is that you tell your agent what SEO problem you have, and it runs the necessary tools sequentially until you get a clean, usable data set back.
Who Is Surfer SEO MCP For?
Content Managers who hate manually checking keyword density; Technical SEO Specialists tired of clicking through dashboard reports at 2 AM. If your job involves turning raw search data into actionable content briefs, this is for you.
Uses create_seo_audit and get_audit_details to systematically compare the top 10 competitor matrix against a domain's performance without leaving the terminal.
Runs create_content_editor to quickly bypass lengthy UI interfaces, getting target keywords immediately into the chat flow for writers.
Programmatically tracks Content Scores and generates structural audits by chaining get_content_score with initial drafts, ensuring content meets density standards.
What Changes When You Connect
- Stop switching tabs. By running
create_seo_auditand getting results withget_audit_details, you keep your entire workflow—from input URL to structural deficit report—inside the chat window. - Drafting doesn't require leaving your agent. Use
create_content_editorto instantly start a new piece, then validate its quality score usingget_content_scorebefore writing a single word. - Competitor data is instant. Instead of manually checking Google for keyword gaps, run
create_serp_analyzerand pull out the exact required terms withget_prominent_terms. - Manage history effortlessly. Need to check last week's work? Use
list_seo_auditsorlist_content_editorsto instantly find all previous jobs by name or date. - Focus on writing, not data entry. These tools pull complex metrics (like word counts and Content Scores) so you only see actionable advice.
Real-World Use Cases
Need a full site audit before publishing?
A content writer needs to check if the new landing page is ready. They ask their agent: "Audit this URL and list any missing NLP terms.". The agent runs create_seo_audit, waits for processing, then uses get_audit_details and get_prominent_terms to return a bulleted list of required keywords directly into the draft.
How do I know if my competitor is beating me on topic coverage?
A marketer wants to benchmark against rivals. They prompt: "Run SERP analysis for 'best CRM software' and give me all the prominent topics." The agent executes create_serp_analyzer, then calls get_prominent_terms to output a structured list of competitive keywords, saving hours of manual research.
I need to draft content but don't know where to start.
A writer starts with the core keyword. They ask their agent to create_content_editor for 'how to invest in stocks'. The agent generates a structured outline and immediately uses get_content_score so the writer knows if the initial draft is hitting the target quality metric.
I need to compare two different articles against each other.
A specialist wants to check two drafts. They first run an audit on Article A using create_seo_audit. Then, they manually paste Article B and ask the agent to run a comparison draft query (create_content_editor), allowing them to see which one has higher potential scores via get_content_score.
The Tradeoffs
Copy/pasting data between tools
Running a SERP analysis, copying the keywords into Excel, then manually writing the article and checking it against Google's free tools.
→
Don't copy anything. Ask your agent to run create_serp_analyzer first. Then, have the agent use get_prominent_terms to extract the data and feed those terms directly into a new draft using create_content_editor.
Forgetting which audit was which
Running five audits throughout the day, then forgetting if the score 72 belonged to the product page or the blog post.
→
Never rely on memory. Use list_seo_audits to see all jobs and grab the specific details you need using get_audit_details, which links everything back to a unique ID.
Asking for optimization without context
Just saying 'Make this better.' The agent has no idea what's wrong with the copy or what keywords are missing.
→
Always run an audit first. Start by asking: "Run create_seo_audit on this URL." Then, use the results to guide your next step: "Now that we see the gaps, create a content editor using these top 3 terms."
When It Fits, When It Doesn't
Use this connector if your job requires turning raw search data (SERP results, competitor keyword lists) into actionable writing tasks. You need the full cycle: Audit -> Keyword Identification -> Drafting/Scoring. Don't use it if you just need a basic word count check or simple grammar proofreading—use a dedicated text editor for that. If your only goal is to generate 5 random keywords, simply using get_prominent_terms might be enough, but if you want the full audit cycle and scoring mechanism, this tool suite handles it all.
Common Questions About Surfer SEO MCP
How do I start the process with Surfer SEO? Do I use `create_seo_audit` first? +
Yes, you should run create_seo_audit first. This establishes a baseline by scanning your URL and tells you exactly what structural or keyword gaps need filling before you write anything.
What's the difference between `get_serp_results` and `get_prominent_terms`? +
get_serp_results gives you the raw, comprehensive data set from the top search results. get_prominent_terms filters that down for you, providing a clean list of the most critical NLP terms you should focus on.
Can I check my content score multiple times? Which tool do I use? +
Yes. You call get_content_score every time you make a significant edit to your draft. It gives real-time feedback, confirming if your changes are pushing the score toward the target.
What if I want to check multiple URLs? +
You'll need to run create_seo_audit for each URL individually and then use list_seo_audits later to review all the reports you ran today.
How can I view all previous audits using `list_seo_audits`? +
The tool lists every SEO audit run in your connected account. It provides a quick summary of the date, target URL, and status for review. After listing them, you use get_audit_details to pull the full results matrix.
If I want to see all my saved Content Editor drafts, which tool should I call? +
Use list_content_editors. This command returns a list of existing editor IDs. You then pass one of those specific IDs into get_content_editor_details to retrieve the full guidelines and content.
What credentials do I need before running `create_seo_audit`? +
You must provide a valid API key, specifically your private SURFER_KEY. The system uses this credential pair to authenticate the audit request against your live Surfer account. Check the provider dashboard for the required key.
If I need to analyze multiple competitor URLs, what is the proper sequence using `create_serp_analyzer`? +
Run create_serp_analyzer for each target URL one by one. You must wait for confirmation that the initial task is running before calling get_serp_results. This ensures you pull data from the correct, most recent analysis run.
Can the agent natively sequence multiple SERP SEO audits concurrently without degradation? +
Yes. Commands natively hook into asynchronous API creations (like create_content_editor). Audits sequence seamlessly provided your API quota from Surfer supports the bulk volume.
What does the Content Score represent? +
The Content Score is a 0–100 rating generated by Surfer's NLP engine. It measures how well your text covers the prominent terms, word count targets, and structural guidelines extracted from top-ranking pages for your target keyword.
Which Surfer SEO plan is required for API access? +
API access is available on the Scale AI and Enterprise plans. You can generate your API key from the Surfer dashboard under your account settings once subscribed to an eligible plan.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.