RomeoSEO

Access your SEO plan, keyword research and Google Search Console results, and manage SEO work through your AI assistant.

View on romeoseo.com

Hosted MCP Server

npx add-mcp 'https://app.romeoseo.com/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Ask in plain words. Romeo does the SEO part.

Your AI app picks the right Romeo tool and answers with your own data: your Google results, your plan and Romeo's research.

  1. 01 Which of my pages lost visitors from Google this month? Romeo reads your Google Search Console data and lists the pages that dropped, with their numbers.

  2. 02 What is Romeo working on for my website this week? Romeo shows your SEO plan: what is running now, what comes next and what is waiting for you.

  3. 03 Find me 5 new article ideas and add the best one to my plan. Romeo shares ideas from his keyword research, or starts new research, then adds the one you pick to your plan.

  4. 04 Start today's article. I'll ask you later if it's ready. Romeo starts writing. It usually takes 10 to 20 minutes; ask again and your AI app checks whether it is done.

  5. 05 How did the articles Romeo wrote last month do on Google? Romeo shows what he wrote and improved in that time, and how those pages did on Google.

  6. 06 Move Thursday's article to Monday. Romeo moves the task on your plan's calendar and tells you if another task swapped places with it.

  7. 01 Copy the address Copy the RomeoSEO address: https://app.romeoseo.com/mcp

  8. 02 Add it to your AI app Add it as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code or Codex.

  9. 03 Sign in and allow it Sign in to RomeoSEO and choose what the app may do: See and work, or See only.

  10. 04 Check it works Start a new chat, pick RomeoSEO and ask it to list your websites. Then ask about your Google results, plan and research.

https://app.romeoseo.com/mcp

Paste it wherever your AI app asks for a connector or MCP server address.

Use RomeoSEO to check my connection and list my websites. Don't start any research or tasks.

Ask it in a new chat with RomeoSEO picked. It only reads, so it starts nothing.

  1. Open.
  2. Choose Add custom connector, name it RomeoSEO and paste the address.
  3. Choose Connect and sign in to RomeoSEO.

Using a script or an automation tool that cannot sign in? Create a personal key under AI apps in RomeoSEO and send it as Authorization: Bearer <key>.

It can do the work, right up to a draft.

Connected with See and work, an AI app can do most of what you do in RomeoSEO. Anything it sends to your website arrives as a draft or a pull request.

From your AI app, Romeo can

  • See your websites, your SEO plan and every task
  • Read your Google stats and Google Search Console reports
  • Show Romeo's keyword ideas and page improvement research
  • Check keywords: monthly US searches, difficulty and who ranks on Google
  • Start new research and start tasks
  • Add article ideas to your plan, and move or skip tasks
  • Send finished articles to your website as drafts or pull requests

Work started from an AI app counts toward the same daily limits as work started in RomeoSEO.

Romeo cannot

  • Publish a page live. From an AI app, articles arrive as a draft or a pull request.
  • Change your billing or your plan.
  • Delete anything: websites, tasks or your account.
  • Change anything at all, when you connect it with See only.

You stay in control of every connection.

  • Only apps you allow

    An AI app only reaches your account after you sign in to RomeoSEO and allow it. You see the app's name and what it will be able to do first.

  • See only, if you prefer

    Choose See only and the app can look at everything but change nothing. See and work also lets it start research and tasks.

  • Disconnect any time

    Every app you connect is listed under AI apps in RomeoSEO. Disconnect one and it loses access straight away.

  • Keys are shown once

    Personal keys for scripts are shown once, when you create them. RomeoSEO stores only a scrambled fingerprint, so nobody can read a key back.

Before you connect.

Is this a Google Search Console MCP?

Yes. Once your Search Console is connected to RomeoSEO (read-only), your AI app can read your Search Console clicks, searches and pages live through Romeo, plus keyword data (monthly US searches, difficulty and who ranks on Google) and your Romeo plan and research. It needs a RomeoSEO plan, and the 3-day free trial counts. There is no Google Cloud project, API key or service account to set up: you sign in to RomeoSEO and allow the app.

Do I need a paid plan?

Using Romeo from AI apps is included on every RomeoSEO plan, including the 3-day free trial. Some AI apps only let you add custom connectors on their own paid plans, so check yours.

Which AI apps work?

Claude, ChatGPT, Cursor, VS Code, Claude Code and Codex, plus any other app that can connect to a remote MCP server and sign in. Scripts and automation tools that cannot sign in can use a personal key instead.

Can it publish to my website?

From an AI app, Romeo can send a finished article to your website as a draft or a pull request, never as a live page. You publish the draft or merge the pull request when it suits you. An AI app also cannot change your billing or delete anything.

Do I need an AI app to chat with Romeo?

No. Chat with Romeo is built into RomeoSEO on every plan, including the trial: ask about your site in plain English and Romeo answers from your pages, Search Console, plan and research, and suggests articles and fixes you add to your plan in one click. Romeo in AI apps is for when you would rather ask from Claude, ChatGPT or Cursor.

Is my data safe?

An AI app only gets in after you sign in and allow it, and you can give it See only. You can disconnect any app at any time from AI apps in RomeoSEO. The AI app sees the answers Romeo sends it, so its own privacy terms cover those.

What does MCP mean?

MCP stands for Model Context Protocol. It is a standard way for AI apps to use other apps, so Claude or ChatGPT can ask RomeoSEO for your data, or ask Romeo to start work, without you copying anything between them.

Fixes for the usual hiccups.

My AI app answers without my RomeoSEO data

RomeoSEO is not connected in that chat yet. Open your AI app's connector, app or MCP settings, choose Connect next to RomeoSEO and sign in. Then start a new chat, pick RomeoSEO (type @ in ChatGPT and Codex) and ask it to list your websites.

Codex says it could not load RomeoSEO's connection details

Add RomeoSEO to Codex as an MCP server instead of a ChatGPT app: open Settings, then MCP servers, choose Add server, pick Streamable HTTP, paste the RomeoSEO address and sign in. Or run the two Codex commands above.

The sign-in window never opens

Allow pop-ups for your AI app and try Connect again. In Codex and Claude Code, the sign-in opens in your browser, so check for a new browser tab.

It connected, but there are no websites

The connection works. Add your website in RomeoSEO first, then ask your AI app again. If you work on a teammate's account, sign in with the email they invited.

Sign-in keeps failing

Remove RomeoSEO from your AI app, add it again with the address above and sign in once more. You can also disconnect the old connection under AI apps in RomeoSEO.