Seobility MCP: Connect your AI assistant to your Seobility data (Beta)

πŸ§ͺ New feature in Beta stage: expect bugs and report them to us, please.

Work with your SEO data right inside your favourite AI assistant! Instead of using the Seobility application and pasting report data into your AI chat, you can simply connect Seobility directly to your AI assistant. From there, you can chat with your Seobility data in plain language and get answers and insights based on your projects, rankings, and Seobility's SEO tools and data.

πŸ“£ New: You can now connect the Seobility MCP by signing in with your Seobility account. No API key to copy and paste: add the server to your AI assistant, allow access in Seobility, and you're ready to go.

This guide explains what the Seobility MCP does, what you can use it for, and how to set it up step by step.

ℹ️ Please note: the Seobility MCP is currently in Beta stage. This means that we are still polishing the feature and you might encounter bugs. Please report those bugs to us! This helps us finalize the feature as fast as possible.

What is the Seobility MCP?

MCP stands for Model Context Protocol. It's a standard way for AI assistants to securely connect to outside tools and data. In plain terms: it's the bridge that lets your AI assistant reach into your Seobility account and work with your data.

The Seobility MCP connects MCP-compatible AI assistants (for example Claude, Claude Code, ChatGPT, Cursor, or Codex) to your Seobility account. Once it's set up, you stay in your AI assistant and describe what you want, and the assistant does the rest:

  • You ask a question in everyday language.
  • The assistant retrieves and analyzes your Seobility data for you.
  • You get answers, summaries, and next steps without switching tools or exporting anything.

Everything stays tied to your own Seobility account, and your usage always stays within your plan's limits.

What can you do with it?

Once the Seobility MCP is connected, you can simply ask your assistant questions and let it work out the right steps on its own. A few examples:

Check your rankings: Get your latest positions across Google and in AI Overviews from your Ranking Monitoring, no need to open a report.

"Where does my website rank for 'seo check' in Google Germany?"
"Give me today's rankings for my project [name]."

Run a Website Audit: Start a crawl and have the most important technical and on-page issues explained back to you, so you know what to fix first.

"Start a crawl for my project [name] and list the top issues."
"Which website audit optimization would benefit [URL] the most?"

Do a quick SEO check on any page: Run a fresh check on a single URL and get clear, plain-language feedback.

"Run an SEO check on this landing page: [URL]."

Keep an eye on your competitors: Track how your competitors are performing and get a heads-up when something meaningful changes. For alerts, your AI client needs to be able to run the request automatically on a schedule.

"Tell me if [competitor] gained or lost visibility this week."

Automate your SEO reporting: Turn your data into reports in the tools you already use, like Google Docs or Notion. This requires your AI client to be connected to those tools.

"Create the monthly SEO report for my project [name]."

Ready to go further?

The real value shows when you let your assistant chain several steps together in a single request. For example:

Check for which keywords [URL] ranks in positions 4 to 20, identify content gaps against the top 3 ranking pages, and recommend what to do with the page content of the pages with the most potential.

Compare my rankings this month against last month and summarize the biggest movements for my project [name].

Find the pages with the most technical issues in my latest crawl and tell me what to fix first.

ℹ️ Ready-made workflows: Don't want to write prompts like these yourself? Use our free skills library (see below).

Your AI assistant can also add to your Seobility data, for example by adding keywords to a project. It can read your data, add to it and change project settings, but it can't delete anything from your account.

πŸ’‘ Good to know: The Seobility MCP helps you work with your SEO data faster, but it doesn't fix issues on its own, unless you set it up to do so. It gathers your data, explains it, and hands you clear next steps, but you stay in control of what happens next.

What you need to get started

  • A Seobility account on a paid plan. The Seobility MCP is currently available on the Premium, Professional and Agency plans. Your plan determines how many credits you have for data and live analysis.
  • An MCP-compatible AI assistant, such as Claude, Claude Code, ChatGPT, Cursor, or Codex.

ℹ️ Token efficiency: we recommend Claude Code or Cursor to improve token efficiency. Both save bigger responses to a file and read from it selectively, instead of processing all of it directly.

Two ways to connect

  • Sign in with your Seobility account (recommended): Your AI assistant sends you to Seobility, you allow access, and you're connected. If you aren't logged in to Seobility yet, you log in first. There's no API key to create or store. This works with Claude, Claude Code, and ChatGPT.
  • API key: You create a personal API key in Seobility and add it to your AI assistant's settings. Use this if your assistant doesn't support signing in, or if you prefer working with a key, for example in a config file.

Both ways give your assistant exactly the same access: the same plan, the same credits, the same tools.

πŸ’‘ Tip: You can also send your AI assistant this page and ask it to help you set up the MCP.

Option 1: Sign in with your Seobility account

1. Add the Seobility MCP to your AI assistant

In your AI assistant, add a new MCP server (some tools call it a "connector") with this URL:

https://api.seobility.net/mcp

Then start the connection. Here's where to find this in the most common tools:

Claude (web & desktop app)

  1. Settings β†’ Customize β†’ Connectors β†’ + Add β†’ Add custom connector.
  2. Name Seobility, Remote MCP server URL https://api.seobility.net/mcp, then click Continue.
  3. Keep the default settings and click "Add".
  4. Click "Connect" on the new Seobility connector.

On Team and Enterprise plans, an Owner adds the connector once. Each team member then clicks Connect and signs in with their own Seobility account.

ChatGPT

  1. Settings β†’ Security and login β†’ Developer mode β†’ switch on.
  2. Plugins β†’ Create app.
  3. Name Seobility, MCP Server URL https://api.seobility.net/mcp, Authentication OAuth.
  4. Tick "I understand and want to continue" and click "Create".

Claude Code

Run this command in your terminal:

claude mcp add --transport http seobility-mcp https://api.seobility.net/mcp

Then start Claude Code, run /mcp, select seobility-mcp and choose Authenticate.

Using a different AI assistant? If it supports signing in to MCP servers, it works the same way: add the URL and follow the login prompt. If it doesn't, use Option 2.

2. Log in to Seobility (only if needed)

Your AI assistant opens Seobility in your browser. If you're already logged in to Seobility, you skip this step and go straight to Step 3.

If you aren't, you first see a login page. It's the same login you know from the Seobility app. You need an existing Seobility account for this, as you can't create a new account during sign-in.

3. Allow access

Seobility now asks whether your AI assistant may use your account and lists what it will be able to do:

  • Read your projects, keywords, rankings, and backlinks
  • Run SEO checks and other tools, and change project settings
  • Use your account's MCP credits

Click Allow access. If your plan doesn't include the MCP yet, you'll see a note with an option to upgrade instead.

You're then taken back to your AI assistant. Depending on the tool, you may land on its connector settings, which look different in every tool. That's it: the Seobility MCP is ready to use in your chats.

πŸ’‘ Good to know: Your AI assistant never sees your Seobility password. It only receives access that Seobility issues for this one connection, and it renews that access in the background, so you don't have to log in again every time.

Option 2: Connect with an API key

1. Get your Seobility API key

Open the Account Settings > MCP tab in Seobility and create your personal API key there. Copy it and keep it somewhere safe, you'll paste it into your AI client in the next step.

If you took part in the closed beta, the API key we emailed you back then still works, so you can reuse it or generate a fresh one in the MCP tab.

Having problems or need help? Contact our support team and we'll help you out.

2. Add the server to your AI client

Pick the option that matches your setup, and replace <your-api-key> with the key from Step 1.

Option A - Config file (Claude Code, Cursor):

Add the server to your client's MCP configuration file (for Claude Code, this is .mcp.json). In Cursor, leave out the "type": "http" line. Your key is sent as a request header:

{
"mcpServers": {
"seobility-mcp": {
"type": "http",
"url": "https://api.seobility.net/mcp",
"headers": {
"X-Seobility-Authorization": "<your-api-key>"
}
}
}
}

Option B - Command line (Claude Code):

claude mcp add --transport http seobility-mcp "https://api.seobility.net/mcp" --header "X-Seobility-Authorization: <your-api-key>"

Option C - Codex:

Codex reads MCP servers from ~/.codex/config.toml. This file is shared by Codex in the ChatGPT desktop app, the Codex CLI and the IDE extension. Add this block, then restart Codex:

[mcp_servers.seobility-mcp]
url = "https://api.seobility.net/mcp"
http_headers = { "X-Seobility-Authorization" = "<your-api-key>" }

Connecting Claude (web & desktop app) or ChatGPT? Use Option 1, it's the easiest way for both.

3. Keep your API key secure

Your key works like a password. Don't paste it into shared chats, tickets, or screenshots, and don't commit it to a public code repository. If it's ever exposed, contact support so we can reset it.

Verify the connection

In an interactive Claude Code session, run /mcp. The seobility-mcp server should appear as connected and list its tools. In Claude, enable the connector in a chat via "+" β†’ "Connectors". In other clients, look for Seobility in your list of connected tools. In Codex, /mcp shows your connected servers.

If it doesn't connect:

  • Signed in with your account: Check that you logged in with the Seobility account that has the MCP in its plan, and that you clicked Allow access. If you closed the browser window before that, simply start the connection again.
  • Connected with an API key: Check that your key was copied in full (no extra spaces), that you used the correct endpoint (https://api.seobility.net/mcp), and that your Seobility plan includes MCP access.

Manage your connected AI assistants

In Account Settings > MCP, you can see which AI assistants are connected to your account via sign-in, since when, and when they were last used. You can also disconnect an assistant there at any time. It then no longer has access to your Seobility account.

Use ready-made workflows: the Seobility skills library

Skills are ready-made instructions that tell your AI assistant how to handle a specific SEO task with your Seobility data, step by step. You ask a simple question and get a clear, structured result. Our free library has six of them:

  • Project setup check: which settings to change so your project shows the whole picture
  • Weekly check-in: what changed in your rankings, backlinks, audit and uptime this week
  • Ranking opportunities: keywords close to the top 3 or top 10, and how to close the gap
  • Competitor gap: why the pages above you rank better, and what you could improve
  • Audit triage: which Website Audit issues to fix first, ranked by impact and effort
  • Findings to tickets: ready-to-paste tickets for your developer, plus a checklist for what you can fix yourself

πŸ‘‰ Get the skills and the setup guide on GitHub

How credits work

The Seobility MCP runs on credits that are included with your plan. Every time your assistant works with your data, it uses some of that allowance. This works the same way, no matter whether you connected by signing in or with an API key.

During the beta, you get higher credit limits so you can explore the MCP and try out workflows without running low too quickly:

  • Premium: 40,000 credits per month
  • Professional: 100,000 credits per month
  • Agency: 200,000 credits per month

Credits keep the MCP fair: they're there so no single account can overload our live tools. The beta limits are generous on purpose, so you have plenty of room to experiment. If you run into your limit during the beta, let us know.

To get the most out of your credits, ask focused questions, so your assistant only makes the requests it actually needs.

Further down the line, extra MCP credits will also be available as an add-on, on top of your plan's monthly allowance.

More resources

Need more help?

  • πŸ“© Reach our support team anytime at [email protected].
  • πŸ’¬ Share your feedback! As a beta user, your input directly helps us to improve the Seobility MCP.

Thanks for experimenting with the MCP. πŸ’™