Keytomic MCP

Keytomic MCP brings Keytomic, the end-to-end AI SEO agent, to your AI assistant and connects it to your Keytomic workspace. Use it in Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini CLI, Windsurf, and other remote MCP clients. Ask questions about your Google Search Console data, run SEO audits of your site, read the fixes, do keyword research, plan your content calendar, write and edit articles, and generate their hero images, all in the chat.

The Keytomic MCP server URL is:

https://app.keytomic.com/mcp

The server is a remote MCP server over Streamable HTTP. You sign in with your Keytomic account. You do not need an API key, and you do not install software. Keytomic is also a connector in the Claude directory.

This repository has no code. It gives the installation steps for each client. For more information, go to keytomic.com/mcp.

Keytomic: the end-to-end AI SEO agent

Keytomic is the AI SEO agent that runs the whole SEO cycle for your site, for Google and AI search:

1. Research: finds the keywords and topics that your customers search for on Google and in AI search.

2. Write: plans your content calendar and writes on-brand articles with images.

3. Publish: publishes to your site and gets your pages indexed.

4. Monitor: tracks your rankings, your Search Console data, and how often AI search mentions your brand.

5. Improve: refreshes content that loses traffic, finds technical issues, and finds backlink opportunities.

One platform does the work of a keyword tool, an AI writer, a publishing workflow, and a rank tracker: AI SEO automation from the first keyword to the next ranking gain. Plans start at $99/month, or $79/month when you pay yearly, with a free trial. See pricing.

Keytomic MCP brings this agent into your AI assistant. The sections below show how to connect it and what it can do in the chat.

Related MCP server: ActableSite MCP

Install

Claude

Keytomic is a connector in the Claude directory.

1. Open Keytomic in the Claude directory.

2. Click Connect to Claude, sign in to Keytomic, and approve.

You can also add Keytomic as a custom connector:

1. Open Customize > Connectors.

2. Click + Add, then Add custom connector.

3. Name it Keytomic and paste the server URL https://app.keytomic.com/mcp. Click Continue.

4. Examine the authentication settings that Claude found. Click Continue, then click Add.

5. Click Connect, sign in to Keytomic, and approve.

The AI SEO with Keytomic plugin for Claude adds the same server and four skills: SEO audits, Search Console review, workspace setup, and the content calendar with keyword research, articles, and hero images.

ChatGPT

Full MCP support in ChatGPT is available only on the ChatGPT Business, Enterprise, and Edu plans. Use ChatGPT on the web. On a Business plan, an admin or owner adds the server. Developer mode is not necessary.

1. Go to Plugins.

2. Click +, then click Add custom MCP server.

3. Type the name Keytomic.

4. In Connection, paste https://app.keytomic.com/mcp.

5. Select OAuth for the authentication.

6. Select I understand and want to continue.

7. Click Create as a plugin.

8. Sign in to Keytomic and approve.

9. Install the plugin. In a new chat, type @ and select Keytomic.

Claude Code

Run this command in your terminal:

claude mcp add --transport http --scope user keytomic https://app.keytomic.com/mcp

The --scope user option makes Keytomic available in all your projects on this computer.

Start Claude Code and sign in to Keytomic when it prompts you. You can also run /mcp, select keytomic, and complete the sign-in.

To install the AI SEO with Keytomic plugin with its four skills, run this command:

claude plugin install keytomic --marketplace epicx-labs/keytomic-claude-plugin

Cursor

1. Open Cursor Settings, then MCP, then Add new MCP server.

2. Add this to your mcp.json:

   {
     "mcpServers": {
       "keytomic": {
         "url": "https://app.keytomic.com/mcp"
       }
     }
   }

3. Sign in to Keytomic when Cursor asks.

Codex

1. Add this to ~/.codex/config.toml:

   [mcp_servers.keytomic]
   url = "https://app.keytomic.com/mcp"

2. Restart Codex and sign in to Keytomic when it prompts you.

Gemini CLI

1. Add this to ~/.gemini/settings.json:

   {
     "mcpServers": {
       "keytomic": {
         "httpUrl": "https://app.keytomic.com/mcp"
       }
     }
   }

2. Restart Gemini CLI and sign in to Keytomic when it prompts you.

Windsurf

1. Open the Cascade panel, click the MCPs icon, then Configure.

2. Add this to mcp_config.json:

   {
     "mcpServers": {
       "keytomic": {
         "serverUrl": "https://app.keytomic.com/mcp"
       }
     }
   }

3. Refresh and sign in to Keytomic when Windsurf asks.

Other remote MCP clients

Each client that supports remote MCP servers can use the same URL: https://app.keytomic.com/mcp. Use Streamable HTTP as the transport and OAuth as the authentication.

Requirements

• A Keytomic workspace on a paid plan or in a trial. If the workspace has no active plan, or if it is still in Onboarding, the tools return an error with a link to Keytomic.

• A role in the workspace that gives the permission for the action. Each tool needs a workspace permission for its action. If your role does not give the permission, the tool returns the permission_denied error.

• A Google Search Console property connected to the site, for the Search Console tools. The other tools do not need it.

What this server does

• SEO Audits: start an audit of a site, follow it to the end, and read the findings by category, with the affected pages and the recommended fix.

• Search Console insights: find the top, new, improving, and declining queries and pages, low-hanging fruits, keyword cannibalization, zombie pages, and question queries.

• Search Console data: run Search Analytics queries, inspect URLs, and read, submit, and sync sitemaps.

• Workspace setup: read a site's brand profile, settings, author profiles, Usage Limits, and integrations. Edit the brand profile, the article settings, the indexing settings, and the author profiles.

• Content calendar: read the topics planned for a site and their scheduled days, and read the number of keyword searches left for the site. Edit a topic, add topics from keywords or from a title, and start a content calendar run and follow it.

• Articles: write the article of a calendar topic, read it with its SEO fields and its Markdown text, edit it, and generate a new hero image for it. In clients that support MCP Apps, such as Claude and ChatGPT, the article and the hero image show in the chat. When your connection can edit content, you can edit the title and the text of the article in the chat and save them, or select text and ask the assistant to change it.

• Keyword research: get related keywords for a seed keyword, with search volume, difficulty, competition, CPC, and the monthly trend.

MCP tools

Most tools spend no credits. These tools can use the credits of the site:

All members of the site share these credits. get_keyword_search_usage gives the keyword searches that are left, and get_usage gives each Usage Limit. start_content_calendar, generate_article, and generate_hero_image first return a plan and start nothing. The plan gives the counts before the call. The tools start the work only when you call them again with confirm set to true. If a generate_hero_image call with confirm times out, read the article with get_draft before you call again. The image can still finish, and a second call uses a second Blog Hero Credit.

add_keywords_to_calendar uses no keyword search. The daily automation writes the article of each new topic on its scheduled day, and that article counts then. For add_keywords_to_calendar and create_calendar_topic, the site must have articles left this month, or Article Credits, for the new topics.

Some workspaces can open only some calendar topics for now. For these workspaces, the content calendar tools return only the topics that they can open.

Limits and errors

• Each user can make 60 tool calls each minute in one workspace. When you go above the limit, the tool returns the rate_limited error with retryAfterSeconds.

• A tool error is a JSON object with an error code and a message. Errors that you can correct in Keytomic also give a link.

The table gives the errors about access, limits, and connections. Tools also return errors for an input that is not correct.

The content calendar and article tools also return these errors:

Security model

• You sign in with your Keytomic account through OAuth, and you select one workspace. The server reads and writes only the data of that workspace.

• The connection is a Connected App. Keytomic asks for these MCP Scopes: workspace:read, workspace:write, audit:read, audit:run, gsc:read, gsc:write, content:read, and content:write. On the consent page, you can clear a scope that you do not want to give.

• The content:write scope lets the AI assistant do actions that can use credits: keyword searches, new topics, content calendar runs, articles, and hero images. Keytomic reports the credits that each action used.

• The edit tools of the workspace and content areas also need the read scope of their area, and submit_sitemap also needs gsc:read.

• If the Connected App does not have a scope, the server refuses the tools that need it with an HTTP 403 insufficient_scope response. This occurs when you cleared the scope on the consent page, or when you connected Keytomic before the content scopes were available. Your client shows an authorization or insufficient scope error, sometimes with the text "Keytomic needs approval". This error is not the permission_denied tool error, and a role change does not correct it. The other tools continue to operate. To correct it:

  1. Sign in to Keytomic again in your client and approve all the scopes. In Claude Code, run /mcp, select keytomic, and sign in again.

  2. If the error continues, open the Keytomic MCP page in Keytomic and click Disconnect on the row of the app under Connected apps. Then connect Keytomic again and approve all the scopes.

• You can disconnect the Connected App at any time on the Keytomic MCP page in Keytomic, under Connected apps.

Report vulnerabilities with the process in SECURITY.md.

Links

• Keytomic MCP

• Keytomic in the Claude directory

• AI SEO with Keytomic, the plugin for Claude

• Keytomic

• Privacy policy

• Support: hi@keytomic.com

• Security policy

• License