MCP server: connect Claude, ChatGPT and more

Add SEOmator to the AI tool you already use, so the tool can read your projects and run SEOmator tools through MCP (Model Context Protocol).

Before you start

You need a SEOmator account in at least one organization.
Find your tool’s setup line: in the sidebar, click MCP. The MCP clients section on the Integrations page lists each supported tool with its URL or command and a Copy button.

The Integrations page with a Copy button on each MCP client row and the Connected apps list

The server URL is:

https://api.seomator.com/mcp

Add SEOmator to your tool

Claude
ChatGPT
Claude Code
Cursor
VS Code

Copy the URL

On the Integrations page, click Copy in the Claude row.

Add a connector

In Claude, add a custom connector with this URL.

Copy the command

On the Integrations page, click Copy in the Claude Code row.

Run it

Run the command in your terminal:

claude mcp add --transport http --scope user seomator https://api.seomator.com/mcp

In Claude Code, run /mcp and sign in to SEOmator.

Approve

Approve the connection in your browser.

Another MCP client that supports remote servers can use the same URL.

Approve the connection

When you sign in from your tool, SEOmator opens an Authorize page in your browser.

Check the account

Check the email you’re signed in with. To use a different account, click Use another account.

Choose the organization

Under Organization, choose the organization the tool may use. A connection works with one organization only.

Allow it

Read what the tool can do, then click Allow. To refuse, click Deny.

The tool is connected and shows under Connected apps on the Integrations page. It stays connected while you use it. A connection can read the organization’s projects, reports and AI answers. If it also asks to make changes, it can change projects, prompts and competitors, as your role allows.

Connect with an API key

Scripts and tools that can’t sign in through the browser can use an organization API key instead.

Create a key

Create a key on the API keys page.

Point the client at the key endpoint

Set the client’s server URL to https://api.seomator.com/mcp/key.

Send the key

Send the key in the x-api-key header, or as Authorization: Bearer <key>.

The client can now use SEOmator tools with the key’s access. A read-only key can only use read tools.

Try it

Copy a prompt into your tool to check the connection with your own data. Everything your tool can do is listed in MCP tools.

In my SEOmator project, how often do ChatGPT, Google AI Mode and Gemini name my brand, and how does that compare with my competitors?

Which domains and pages do the AI answers in my SEOmator project cite most?

MCP tools

Once your AI tool is connected, it works in SEOmator through these tools. You don’t call them by name: ask a question and the tool picks the ones it needs. The agent inside SEOmator uses the same tools. Read tools work with every connection. Write tools need a connection you allowed to make changes, or a Read and write API key, and a role that allows the change. What each role can do: Members.

Read tools

Tool	What it returns
List projects `list_projects`	The projects the connection can open, newest first.
Get project `get_project`	One project.
AI visibility report `get_visibility_report`	How often ChatGPT, Google AI Mode and Gemini name each tracked brand, with the counts behind each metric.
Sources of AI answers `get_cited_sources`	The domains or pages the answers read and cite, by site or page type, or by day, week, assistant, topic or prompt.
List collected AI answers `list_answers`	The answers, newest first, with the brands each one names, its source and citation counts and the start of its text.
Read one AI answer `get_answer`	The full text of one answer, the brands it names in order, and its sources.
List tracked brands `list_brands`	Your own brand and your competitors, with their aliases and domains.
List suggested competitors `list_brand_suggestions`	Up to 20 brands the answers name that you don’t track yet, with how many answers name each and one quote.
List tracked prompts `list_prompts`	The prompts asked every day, newest first.
Read one tracked prompt `get_prompt`	One prompt’s text, intent, topic and status, and whether it names your brand.
List topics `list_topics`	The topics your prompts are grouped under.
List Google keywords `list_keywords`	The Google searches the project follows, with monthly volume, your Google position and ranking URL, and Search Console clicks.
Query Google Search Console `query_search_console`	Clicks, impressions, CTR and average position, grouped by query, page, country, device, search appearance or date.
Inspect a URL in Google `inspect_url`	Whether one page is indexed and why not, its last crawl, and the canonical Google chose against the one the page declares.
List submitted sitemaps `list_sitemaps`	The sitemaps in Search Console, when Google last read them, how many URLs they list, and their warnings and errors.

The last three tools need Search Console connected to the project: Connect Google Search Console.

Write tools

Tool	What it changes
Track a new prompt `create_prompt`	Adds a prompt that is asked every day from now on.
Edit a tracked prompt `update_prompt`	Changes a prompt’s text, intent or topic.
Stop tracking a prompt `archive_prompt`	Stops asking a prompt. Its past answers stay in the reports.
Track an archived prompt again `reactivate_prompt`	Asks an archived prompt again from the next run.
Add a topic `create_topic`	Adds a topic to group prompts under.
Rename a topic `rename_topic`	Renames a topic. Its prompts and reports stay the same.
Track a brand `create_brand`	Starts tracking a brand, as a competitor by default, with its domains and aliases.
Edit a tracked brand `update_brand`	Changes a brand’s name, aliases or domains.
Track a suggested competitor `accept_brand_suggestion`	Tracks a suggested brand as a competitor.
Hide a suggested competitor `dismiss_brand_suggestion`	Hides a suggested brand.

When a tool starts tracking a brand or changes its name or aliases, SEOmator recounts it in your past answers.

A prompt added over your plan’s daily allowance runs on credits. What it costs: Plans and credits.

If it doesn’t work

The page says “This consent link is not valid”: start the connection again from your tool.
The page says to create an organization first: create one in SEOmator, then connect again.
The tool lost access: it may have been disconnected or unused for too long. See Integrations, then connect it again.

Integrations

See and disconnect the apps you approved.

API keys

Create keys for scripts and MCP clients.

AI SEO Agent

Ask the same questions inside SEOmator.

Metrics

What the numbers in a visibility report mean.

Get started

Set up tracking

Read your reports

Agent and AI tools

Manage your organization

MCP server: connect Claude, ChatGPT and more

Before you start

Add SEOmator to your tool

Approve the connection

Connect with an API key

Try it

MCP tools

Read tools

Write tools

If it doesn’t work

Integrations

API keys

AI SEO Agent

Metrics

​Before you start

​Add SEOmator to your tool

​Approve the connection

​Connect with an API key

​Try it

​MCP tools

​Read tools

​Write tools

​If it doesn’t work

​Related

Integrations

API keys

AI SEO Agent

Metrics

Before you start

Add SEOmator to your tool

Approve the connection

Connect with an API key

Try it

MCP tools

Read tools

Write tools

If it doesn’t work

Related