How to connect ChatGPT to Semrush

Copy your Semrush API key, connect it in Ryze AI, add one MCP URL to ChatGPT as a custom MCP server, then ask about domains, keywords, competitors and backlinks.

Your MCP URL
https://connector.get-ryze.ai/mcp

Copies the link and opens ChatGPT Plugins, where you select the plus button and Add custom MCP server. See the steps

See pricing

By Ira Bodnar, Ryze AI · Updated · Test record: no calls run

Quick answer

The main way to connect ChatGPT to Semrush is the Ryze AI connector. Copy the API key from your Semrush account, paste it on the Semrush card in Ryze AI, then in ChatGPT open Plugins, add a custom MCP server with the URL https://connector.get-ryze.ai/mcp and OAuth, sign in to Ryze AI and start a new conversation. OpenAI lists custom MCP servers for Business and Enterprise/Edu workspaces, and read and fetch only on Pro. Semrush also documents its own ChatGPT app, covered under the three ways below.

  1. In Semrush open Subscription info, go to the API units tab and copy the API key
  2. In Ryze AI open Integrations, click Connect on Semrush, paste the key and click Continue
  3. In ChatGPT open Plugins, add a custom MCP server named Ryze AI with the URL and OAuth
  4. Sign in to Ryze AI, allow the workspace, install the plugin and type @ in a new conversation

ChatGPT to Semrush at a glance

FactDetail
Main way to connectThe Ryze AI connector: one hosted MCP address that ChatGPT on the web adds under Plugins as a custom MCP server and then installs as a plugin
Server addresshttps://connector.get-ryze.ai/mcp
Sign-inYour Semrush API key is saved in Ryze AI, then ChatGPT signs in to Ryze AI through OAuth. OpenAI says ChatGPT cannot present custom API keys, so the key never goes into ChatGPT
Semrush tools1: semrush__read, a read-only tool for Semrush Analytics API reports, project lists and Position Tracking reports
Can it change SemrushNo. The only Semrush tool reads, so ChatGPT cannot create or edit Position Tracking campaigns through it
What it costs in SemrushEvery call draws on your own Semrush API-unit balance. Ryze AI credits do not pay for it
Other data in the same chatThe same address serves the other Ryze AI platforms you have connected in the workspaces you allow
ChatGPT plan neededBusiness or Enterprise/Edu for full MCP, per OpenAI's help article. Pro gets read and fetch permissions. Free, Go and Plus are not named there
Ryze AI priceSEO Starter is $129 per month with a 3-day free trial. The tool also runs on Paid Ads at $89 per month. Adding the connector is free; the tool needs an active plan or trial
Semrush's own option for ChatGPTAn official Semrush app for ChatGPT that signs in to Semrush with OAuth, listed on Semrush's developer docs and MCP page
Last testedNo call to Semrush and no step inside ChatGPT was run for this guide

Before you start

  • A ChatGPT plan with custom MCP support. OpenAI's help center says custom MCP server connections and full MCP support are available for ChatGPT Business and Enterprise/Edu on ChatGPT web. Pro users can connect custom MCP servers with read and fetch permissions only. The article does not mention Free, Go or Plus. On Business only admins and owners can create and publish plugins for custom MCP servers.
  • A Semrush plan with API access. Ryze AI asks for one value, the API key, found in Semrush under Subscription info, API units tab. The key needs a Semrush plan with API access, and each call uses API units on that account. Check the API units tab before you start.
  • A Ryze AI workspace on a plan or free trial. SEO Starter ($129 per month, 3-day free trial) suits Semrush because the data is SEO data. The Semrush tool also works on Paid Ads ($89 per month, 7-day free trial). Connecting is free; without a plan or trial the connector can only list workspaces and connect platforms.

How to connect ChatGPT to Semrush

Two steps happen in Semrush and Ryze AI, four in ChatGPT. The connector URL is the same for every user.

  1. Copy the API key in Semrush

    In Semrush open Subscription info and go to the API units tab. Copy the API key and keep it out of chats and documents, because anyone who holds it can spend your API units.

  2. Connect Semrush in Ryze AI

    In the Ryze AI app open Integrations, click Connect on the Semrush card, paste the key into API key and click Continue. One workspace holds one Semrush key.

  3. Open Plugins in ChatGPT and add a custom MCP server

    On ChatGPT web go to chatgpt.com/plugins. Developer Mode does not need to be on first, though account and workspace policies still apply. Select the plus button, then Add custom MCP server.

  4. Enter the name, URL and OAuth

    Enter the name Ryze AI and, optionally, a description. Under Connection, put the public URL https://connector.get-ryze.ai/mcp in the Server URL field. For authentication choose OAuth. Review the risk warning and select I understand and want to continue.

  5. Create the plugin and sign in to Ryze AI

    Select Create as a plugin and review the discovered tools. Complete the Ryze AI sign-in when ChatGPT asks, choose the workspaces ChatGPT can reach and click Allow connection. OpenAI's pages give no fixed moment for that sign-in: some plugins ask during install, and the OAuth flow can also start at the first tool call.

  6. Install it and start a new conversation

    Open the plugin in your personal plugins and select the plus button to install it. Start a new conversation, type @ and select Ryze AI. Ask your first question, for example: Which organic keywords does the domain I name rank for in the US database, and which organic competitors does it have?

The Ryze AI Semrush guide covers the Semrush side of the connection, and the Ryze AI ChatGPT guide covers the ChatGPT side. OpenAI documents the Plugins flow in its connect a plugin guide and on its Add custom MCP server page, both checked November 14, 2026.

Older custom app path and workspace publishing

The Ryze AI help center documents an older custom app path. OpenAI's current flow is the Plugins page above, so use these steps only if your workspace still shows Apps in Settings.

  1. Open Settings, Apps, Advanced settings and turn on Developer mode.
  2. Click Create app.
  3. Name it Ryze AI, enter https://connector.get-ryze.ai/mcp as the MCP server URL (keep Server URL, not Tunnel) and choose OAuth.
  4. Tick I understand and want to continue, then click Create.
  5. Click Sign in with Ryze AI, log in, choose workspaces and click Allow connection.
  6. Start a new chat.

OpenAI's help article words the older path its own way: Workspace settings (admins and owners) or personal settings (authorized members), Apps, Create; enter the endpoint, choose the authentication, run Scan Tools and approve the OAuth prompt during the scan, then Create. A draft app marked Dev appears under Settings, Apps, Enabled Apps. OpenAI's pages read on November 14, 2026 mention no Advanced settings page or Developer mode toggle for this, so use the Plugins steps when your screens differ.

Business and Enterprise/Edu publishing

On Business and Enterprise/Edu an admin or owner connects and tests Ryze AI first. To publish it for the workspace, go to Admin Console, select the workspace, then Plugins, Manage Legacy Apps, Drafts and Publish, and review the safety warnings. Enterprise/Edu admins can use Configure Actions and Configure Access before publishing. Members then find the published app under Settings, Plugins. The plugin can also be shared from its more options menu with Share plugin, which needs the Share plugins permission.

ChatGPT limits to know

These ChatGPT limits come from OpenAI's help center and developer pages and the Ryze AI help center:

  • Custom MCP servers cannot be connected on mobile. Use ChatGPT web.
  • Pro connects custom MCP servers with read and fetch permissions. Semrush reads are the kind of call that level is meant for, but no Pro account was used for this guide, so the result there is untested.
  • After an admin approves a connection for a workspace, ChatGPT uses a frozen snapshot of its tools. Changes apply only after an admin refreshes and publishes an update.
  • Deep research can use custom apps for read and fetch actions only.
  • ChatGPT treats any tool without the readOnlyHint annotation as a write action and asks before running it by default. Whether the Ryze AI Semrush tool carries that annotation was not checked, so expect a confirmation prompt on the first call.
  • Picking Ryze AI with @ applies to that one message. Mention it again when a follow-up needs fresh Semrush data.

ChatGPT and custom MCP servers: the facts in one table

TopicDetail
MenuPlugins (chatgpt.com/plugins), the plus button, Add custom MCP server. No config file for web chats; the desktop app's MCP servers setting belongs to the Codex host
Address fieldServer URL under Connection, written with its /mcp path. The other choice there, Tunnel, is meant for private servers
TransportsSSE and streaming HTTP. The web form takes no local command
AuthenticationThree choices: OAuth, No authentication, or OAuth or no authentication. OpenAI's auth guide says ChatGPT cannot present custom API keys, and no OpenAI page shows a header field in the form
OAuth flowAuthorization code with PKCE (S256). A 401 reply with a WWW-Authenticate header is enough for ChatGPT to find the sign-in details
Staying signed inOpenAI asks sign-in providers to issue refresh tokens and advertise offline_access. The Ryze AI server metadata lists the refresh token grant but no offline_access scope, and how long ChatGPT keeps the sign-in was not tested
ApprovalWrite actions ask first by default. You can have ChatGPT remember approve or deny for one tool until the conversation ends. The permission settings offer Always ask, Allow read actions and Allow low-risk actions
PlanFull MCP on Business and Enterprise/Edu, read and fetch on Pro. The pricing page marks Developer mode (beta) Yes for Plus, Pro, Business and Enterprise without defining it or naming MCP, so it is no promise of Plus access
Who adds itBusiness: admins and owners only. Enterprise/Edu: also members an admin grants Create plugins with MCPs, a permission that is off by default on Enterprise
New toolsRefresh the connection in Plugins and open a new conversation. A workspace-published server keeps a frozen tool snapshot until an admin republishes it
Where it is managedSettings, Plugins, then the plugin: its connected accounts with Reconnect and Disconnect. Admins work in Admin console under the workspace's Plugins page

Sources: OpenAI help article on custom MCP servers, Add custom MCP server, plugin authentication, app permissions, plugins in ChatGPT, MCP in ChatGPT, ChatGPT pricing. Checked November 14, 2026.

Other clients in brief

The same URL works in other MCP clients. Semrush is connected once in Ryze AI, so the API key stays where it is.

Claude

Open Customize, Connectors, click + Add, choose Add custom connector, name it Ryze AI and enter https://connector.get-ryze.ai/mcp. Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise plans, with one custom connector on Free. Then click Connect, allow the workspace and start a new chat. The Claude guide linked under related guides has the full walkthrough for Semrush.

Claude Code

Run the command below, then type /mcp inside Claude Code, select ryze and sign in. Claude Code needs a Pro, Max, Ultra, Team, Enterprise or Console account.

claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope user

Cursor

Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project), then sign in on the Ryze AI page when Cursor asks.

{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }

Semrush access and API units

Semrush access comes from the API key you save in Ryze AI, and ChatGPT reaches Semrush only through it. Three things decide what ChatGPT can see and spend.

Which key
The one you pasted on the Semrush card. One Ryze AI workspace holds one Semrush key, and another Semrush account can live in another workspace. To switch keys, click View on the card, disconnect with the trash icon and connect again.
What the key spends
Your Semrush API units. Treat the key like a password, because whoever holds it can use your balance. Disconnecting the card in Ryze AI cuts ChatGPT off from Semrush.
Who can install in ChatGPT
On Business only admins and owners can create and publish a custom MCP plugin. On Enterprise/Edu admins and owners can, and admins can grant other members permission through RBAC.

What the connection uses on the Semrush side

The Ryze AI connection uses a Semrush API key, not an OAuth sign-in with scopes. This table lists what the connection uses and where each item comes from.

ItemWhat it coversSource
API keyAuthorizes each request and bills it to your account's API-unit balance. Found under Subscription info, API units tabRyze AI Semrush guide
Plan with API accessRequired before the key works. Without it Ryze AI cannot read dataRyze AI Semrush guide
API-unit balanceEvery call draws on it. At zero, SEO API reports return ERROR 132 and only you can top it up in SemrushSemrush API units page
Regional databaseDomain and keyword reports are requested for one regional database, such as US or UKRyze AI Semrush guide

Semrush's own MCP server is a separate connection. Semrush's docs say it signs in with OAuth by default, or takes an Authorization: Apikey header, and that its Projects API access is read only. None of that applies to the Ryze AI connection, which uses only the key you saved.

Outside this connection: creating or editing Position Tracking campaigns, because the tool only reads. Domain, keyword and backlink reports come back as CSV text that ChatGPT parses, and each report type needs its own parameters.

Sources: Semrush MCP server docs, Semrush API units balance, Ryze AI Semrush guide. Checked November 20, 2026.

Removing access

To remove access, click View on the Semrush card in Ryze AI and disconnect with the trash icon. In ChatGPT, open Settings, Plugins, select Ryze AI and choose Disconnect from the more options menu beside the account. OpenAI's pages disagree on whether uninstalling a plugin also ends its connection, so disconnect first and uninstall afterwards. On Business and Enterprise/Edu an admin removes a published app from the workspace.

What ChatGPT can do in Semrush

The Ryze AI connector exposes 1 Semrush tool, and it only reads. The Ryze AI facts list it by name from the app source; it was not seen in a live tool list.

ToolTypeWhat it does
semrush__readReadRuns a read-only Semrush Analytics API request: domain overview, organic keywords, organic competitors, keyword overview, backlinks overview, referring domains, anchors and backlinks. It also lists projects and reads Position Tracking reports.

The only Semrush tool is a read tool, so the connector changes nothing in Semrush. In ChatGPT, OpenAI says tools without the readOnlyHint annotation count as write actions and need confirmation by default, and you can expand a tool call to see its full input and output. The Ryze AI chat has its own Tool approvals picker, which starts on Skip all approvals.

Limits in numbers

LimitWhat the source says
API-unit balanceEvery call spends units from your own balance. At zero, SEO API, Trends API, Position Tracking and Site Audit requests return ERROR 132, and the Projects API and Local API return a 403
Per-line reportsCharged by the rows returned, so a long keyword list costs more than a short one. When the balance runs short, Semrush returns only the lines it can pay for
Fixed-cost reportsCharged per request, such as the backlinks overview
Empty resultsA request that returns no data uses no units
Historical dataCosts more than a regular data request
Balance checkFree, in Subscription info under API units, or through a free API call
Capping rowsSemrush suggests the display_limit parameter to restrict returned rows and control cost
Units with MCP plansSemrush's MCP page says a minimum of 50,000 MCP API units come with a plan and reset every monthly billing cycle. That figure is for Semrush's own MCP server, not for the key in Ryze AI
ChatGPT sideOpenAI states no number for tools per server or servers per account, and says each MCP server adds context to messages and uses more of your usage limit
Ryze AI connectionOne Semrush key per workspace connection, and up to 20 workspaces per ChatGPT connection

Sources: Semrush API units balance, Semrush MCP page, Semrush MCP server docs. Checked November 20, 2026.

No call to Semrush was run for this guide, so there is no table of tested calls here. The limits above are the figures Semrush and OpenAI publish.

First 3 prompts to run

Each answer comes from your own Semrush account, so this page describes what comes back instead of showing sample numbers. Name the domain and the regional database in the message, and remember that each report spends API units.

1. Keywords a domain ranks for

@Ryze AI List the top 20 organic keywords for the domain I name in the US database, with position, search volume, CPC and URL.

Tools used: semrush__read

What comes back: An organic keywords read for that domain with the columns you asked for. Capping the rows keeps the unit cost down, and nothing in Semrush changes.

2. Organic competitors

@Ryze AI Which domains compete with the domain I name in organic results, and how do their keyword counts compare?

Tools used: semrush__read

What comes back: The organic competitors list as Semrush returns it, with ChatGPT's plain-words comparison.

3. A backlink profile

@Ryze AI Give me the backlinks overview with Authority Score for the domain I name, then its top referring domains and most common anchors.

Tools used: semrush__read

What comes back: A backlinks overview, then referring domain and anchor reads, each a separate request that spends units.

Replace the domain and database with your own. If you are unsure which regional database fits, name the country. ChatGPT chooses the request parameters itself, so ask for the columns and row count you need.

10 jobs to hand to ChatGPT

Ten jobs to give ChatGPT, each with the tool behind it. Pick Ryze AI with @ in the message that needs Semrush data. None was run for this page; they follow the tool description.

JobAsk ChatGPTToolWorks on the default connection
Domain overviewGive me the domain overview for this site in the US database.semrush__readYes
Ranking keywordsWhich organic keywords does this domain rank for, with position and traffic?semrush__readYes
Organic competitorsWhich domains compete with this one in organic results?semrush__readYes
Keyword researchFor this list of phrases, give volume, CPC and competition in the UK database.semrush__readYes
Backlinks overviewRead the backlinks overview and Authority Score for this domain.semrush__readYes
Referring domainsWhich domains link to this site?semrush__readYes
Anchor textsWhat anchors point at this domain most often?semrush__readYes
Individual backlinksList backlinks that point at this domain.semrush__readYes
Projects and Position TrackingList my Semrush projects, then read the Position Tracking report for one campaign.semrush__readYes, reports only
Create a tracking campaignSet up a new Position Tracking campaign.NoneNo. The tool only reads

3 ways to connect ChatGPT to Semrush

ChatGPT on the web reaches an MCP server at a public address or inside an installed plugin, and its form takes no local command. Three ways to Semrush fit that. This guide treats the first, the Ryze AI connector, as the main way: your Semrush key stays inside Ryze AI, ChatGPT needs one address and an OAuth sign-in, and the tool only reads. The other two come from Semrush's own pages, read on November 20, 2026, and none of the three was run from inside ChatGPT.

WayRuns whereSetup for ChatGPTWhat it reaches in SemrushPrice
Ryze AI connector (the main way)Hosted by Ryze AI, one address for every userSave the Semrush key in Ryze AI, then Plugins, Add custom MCP server with https://connector.get-ryze.ai/mcp and OAuth, then installYour key's account, through 1 read tool for domain, keyword and backlink reports, project lists and Position Tracking reportsSEO Starter is $129 per month with a 3-day free trial; Semrush API units are billed by Semrush
Semrush's official ChatGPT appHosted by SemrushSemrush's developer docs say Account, Settings, Apps, pick Semrush, Connect, Continue, then approve access and tag @Semrush. Semrush's MCP page words it as Plugins, Semrush, Install plugin, Continue, approve. Both pages were open on the same daySEO API, Trends API and the read-only methods of Projects API v3, per SemrushNeeds a Semrush One Starter or Pro+ plan, or SEO Classic Pro or Guru; the app uses units from your Semrush subscription with no extra ChatGPT fee, per Semrush
Semrush's general MCP serverSemrush's hosted server at https://mcp.semrush.com/v2/mcp, streamable HTTP onlyAs a custom MCP server in ChatGPT with OAuth, the documented default. Semrush's other choice, an Authorization: Apikey header, has no matching field in the form as OpenAI describes it. Not run for this guideThe same SEO API, Trends API and read-only Projects API coverage as Semrush's app, per SemrushSame plans and units as the app. Adding a custom MCP server needs a ChatGPT plan that allows it

The two Semrush pages describe the ChatGPT app differently, one through Settings, Apps and one through Plugins. OpenAI replaced the App Directory with the Plugin Directory on July 9, 2026, so the Plugins wording may be the newer one, but that is a guess and neither route was tried.

Options that do not fit ChatGPT

  • Pasting a Semrush API key into ChatGPT. OpenAI's authentication guide says ChatGPT cannot present custom API keys, and the custom MCP form offers OAuth, no authentication, or both. A key has to live on the server side, which is why the Ryze AI connector stores it.
  • The Semrush API called from your own code. It is the API behind the Ryze AI tool, but it connects scripts, not a ChatGPT chat. Every request spends API units the same way.
  • Setups Semrush lists for other clients. Semrush's docs also name Claude, Claude Code, Microsoft Copilot, Cursor, VS Code, Perplexity, Lovable and Notion. Those are different clients with their own steps.

Which one to pick

Ryze AI is the best way to connect ChatGPT to Semrush when you want one address and one sign-in for several marketing platforms, with one caveat: Semrush's own app and server are the maker's connection and cover its report families under your Semrush login, while the Ryze AI connector has 1 read tool. Pick Semrush's app when ChatGPT should use Semrush alone and your plan is on Semrush's list. Pick the Ryze AI connector when the key should stay in a workspace you control and the same ChatGPT plugin should reach the other Ryze AI platforms. You can install both, and both draw on your Semrush API units.

Sources: Semrush MCP server docs, Semrush MCP page, Ryze AI Semrush guide. Checked November 20, 2026.

ChatGPT, Semrush and MCP: dates that matter

DateWhat happened
June 4, 2025ChatGPT's release notes carry their earliest entry on custom connectors over MCP: a remote server was required and the connectors ran in deep research only.
October 17, 2025OpenAI began a beta of full MCP support with developer mode for Business, Enterprise and Edu: read and write connectors that admins publish.
December 18, 2025The ChatGPT app directory launched and connectors were renamed apps.
June 12, 2026App permission controls arrived: people choose when connected apps ask for permission, and Business and Enterprise admins set workspace and per-app rules.
July 9, 2026In ChatGPT the Plugin Directory took the place of the App Directory, and app connections already in place carried on.
September 17, 2026ChatGPT plugins can hold more than one connected account, on all plans.
October 1, 2026Business and Enterprise owners and admins gained plugin management in Admin console, with the older Apps page behind Manage Legacy Apps.
November 20, 2026Semrush's developer docs and MCP page both list ChatGPT as a supported client with setup steps. Neither page shows a launch date for the ChatGPT app.

Sources: ChatGPT release notes, ChatGPT Business release notes. Checked November 14, 2026.

How this guide was tested

No call was run for this guide. No Semrush key was connected for a test, and nothing was added inside ChatGPT. The page rests on the Ryze AI facts file and help center, OpenAI's pages as read on November 14, 2026, and Semrush's pages as read on November 20, 2026.

What was runWhat came back
Calls to SemrushNone. No Semrush key was connected, so no Semrush call was run.
The Semrush tool nameTaken from the Ryze AI app source. It was not seen in a live tool list.
The steps inside ChatGPTNone run. No custom MCP server was added in ChatGPT and nobody signed in from it.
Semrush's own app and serverRead from Semrush's developer docs and MCP page. Not connected.

Not run for this guide: every step inside ChatGPT, on any plan, and every call to Semrush. Which of Semrush's two ChatGPT setup paths is current was not checked in ChatGPT either. With no key connected there is no table of tested calls and no error message copied from a test, so the errors section quotes documented answers instead.

Semrush errors and fixes

These answers are documented by Semrush and have not been triggered through the Ryze AI connector. The connector passes along what Semrush returns, and OpenAI says you can expand a tool call in ChatGPT to read it.

AnswerWhat it meansWhat to ask ChatGPT
ERROR 132Semrush returns it for the SEO API, Trends API, Position Tracking and Site Audit when your API units are used up.Nothing, until you top up units in Semrush. Ryze AI credits cannot pay for them.
HTTP 403 from the Projects APISemrush returns a 403 instead of ERROR 132 for the Projects API and Local API when units run out.Add units in Semrush, then ask again for the project list.

Other problems

ChatGPT will not let me add a custom MCP server
Your plan or role may not allow it. OpenAI lists full custom MCP on Business and Enterprise/Edu, with only admins and owners creating plugins on Business. Ask an admin or owner, or check workspace policies.
The Semrush tool is missing in ChatGPT
ChatGPT keeps a snapshot of the tool list. If you connected Semrush in Ryze AI after adding the server, open it in Plugins and select Refresh (OpenAI), or remove it, add it again and start a new chat (Ryze AI help center). On Business and Enterprise/Edu an admin must refresh and publish an update.
ChatGPT says a subscription is required
The Semrush tool needs an active Ryze AI plan or free trial. Without one the connector can only list workspaces and connect platforms.
The key is rejected when connecting
The Semrush plan may have no API access, or the key was copied in part. Copy the full key from Subscription info, API units tab.
A report returns no rows
The domain may have no data in that regional database. Try another database.
The wrong Semrush account is connected
The key decides the account. Click View on the Semrush card in Ryze AI, disconnect with the trash icon and connect again with the other key.
The one-time connection link is refused
If you asked the Ryze AI agent in ChatGPT to connect Semrush, the link is valid once and for 24 hours, and it is refused while Semrush is already connected in the workspace. Change keys in the Ryze AI app.

Terms on this page

MCP
The Model Context Protocol. ChatGPT on the web uses it to call tools on remote servers such as the Ryze AI connector.
Plugin
What a custom MCP server turns into in ChatGPT after Create as a plugin. You install it, then pick it with @. Older OpenAI pages call the connection an app or a connector.
API units
The balance Semrush charges for API calls. It belongs to your Semrush account, and Ryze AI credits do not pay it.
Regional database
The country index a Semrush keyword or domain report reads from, such as US or UK.
Authority Score
Semrush's domain score, returned with the backlinks overview.
Position Tracking
Semrush's rank-tracking campaigns. Ryze AI reads their reports and does not create or edit them.
readOnlyHint
A tool annotation ChatGPT reads. A tool without it is treated as a write action and asks for confirmation by default.

Sources: MCP and plugins in ChatGPT, Semrush API units balance. Checked November 14, 2026.

Sources

OpenAI pages checked November 14, 2026, Semrush pages checked November 20, 2026. OpenAI's help center answers scripted requests with HTTP 403, so its articles were read in a browser on the pack date. No connector test was run for this guide.

Frequently asked questions

How do I connect ChatGPT to Semrush?

Copy your API key from Semrush under Subscription info, API units tab, open Integrations in Ryze AI, click Connect on the Semrush card and paste it. Then on ChatGPT web open Plugins, select the plus button, choose Add custom MCP server, enter the name Ryze AI and the URL https://connector.get-ryze.ai/mcp, choose OAuth, create the plugin, sign in, allow the workspace, install it and type @ in a new conversation.

Is there a Semrush connector for ChatGPT?

Yes. Semrush's developer docs and MCP page describe an official Semrush app for ChatGPT that signs in to Semrush with OAuth, and Semrush's docs list ChatGPT among its supported clients. The Ryze AI connector at https://connector.get-ryze.ai/mcp is a separate path with 1 read-only Semrush tool.

What is the Semrush MCP URL for ChatGPT?

Semrush's own server is https://mcp.semrush.com/v2/mcp, over streamable HTTP, with OAuth by default. The Ryze AI connector URL is https://connector.get-ryze.ai/mcp. Pick one per plugin, and use OAuth in ChatGPT's form either way.

Which ChatGPT plan do I need?

OpenAI's help center says custom MCP server connections and full MCP support are available for Business and Enterprise/Edu on ChatGPT web. Pro can connect custom MCP servers with read and fetch permissions only. The article does not mention Free, Go or Plus. Semrush's pages name no ChatGPT plan for its own app.

Can I paste my Semrush API key into ChatGPT?

No. OpenAI's authentication guide says ChatGPT cannot present custom API keys, and the custom MCP form offers OAuth, no authentication or both. With the Ryze AI connector the key is saved on the Semrush card in Ryze AI and ChatGPT signs in to Ryze AI through OAuth.

Can ChatGPT change anything in Semrush?

Not through the Ryze AI connector: its only Semrush tool reads, so it cannot create or edit Position Tracking campaigns. Semrush says the Projects API methods in its own MCP server are read only as well.

What does ChatGPT see in Semrush?

Domain overview, organic keywords with position, volume, CPC, URL and traffic, organic competitors, keyword overview for a list of phrases in a regional database, a backlinks overview with Authority Score, referring domains, anchors and backlinks, plus project lists and Position Tracking reports.

Does it use my Semrush API units?

Yes. Every call draws on your own Semrush API-unit balance, and Ryze AI credits do not pay for it. Semrush charges per-line reports by the rows returned, charges fixed-cost reports per request and charges nothing for an empty response. Historical data costs more.

What happens when my Semrush API units run out?

Semrush returns ERROR 132 for the SEO API, Trends API, Position Tracking and Site Audit, and a 403 for the Projects API and Local API. Only you can top up units in Semrush.

Do I need a Semrush subscription with API access?

Yes. The API key from Subscription info, API units tab, needs a Semrush plan with API access. Semrush's own ChatGPT app and MCP server list Semrush One Starter and Pro+ and SEO Classic Pro and Guru among the qualifying plans.

Why are the Semrush tools missing in ChatGPT?

ChatGPT keeps the tool list from when the server was added. Open the server in Plugins and select Refresh, or remove it, add it again and start a new chat. On Business and Enterprise/Edu an admin has to refresh and publish an update.

Does it work on the ChatGPT mobile app?

Not for setup: OpenAI says custom MCP servers cannot be connected on mobile, so add Ryze AI on ChatGPT web. Whether the plugin can be used from the mobile app once it exists is a question OpenAI's pages leave open.

Can I connect more than one Semrush account?

One Semrush key per Ryze AI workspace. A different key can live in another workspace, and one ChatGPT connection can cover up to 20 workspaces. To switch keys inside a workspace, click View on the card, disconnect and connect again.

Can one MCP server give ChatGPT Semrush and ad platform data?

The Ryze AI connector uses one address for every platform connected in the workspaces you allow, so one plugin in ChatGPT can reach Semrush beside the other platforms you have connected. Semrush's own server serves Semrush data only.

How much does it cost?

Connecting is free, but the tool needs an active Ryze AI plan or free trial. SEO Starter is $129 per month with a 3-day free trial, Paid Ads is $89 per month with a 7-day free trial and Agency is $279 per month. Annual billing takes 30% off the first year. Semrush bills its API units separately.

Connect Semrush to ChatGPT

SEO Starter is $129 per month with a 3-day free trial, and the Semrush tool also works on Paid Ads at $89 per month with a 7-day free trial. Annual billing takes 30% off the first year.

Semrush MCP server

Need help? Read the Ryze AI ChatGPT guide or email Ryze AI support.