RankReactorAI
LoginSign Up
Docs

Documentation

RankReactor ChatGPT

Add the RankReactor SEO MCP server to ChatGPT in developer mode. Paste your project API key on the Connect RankReactorAI page.

Every RankReactor plan, including Free, can connect an assistant and create a project API key. Free can generate its one lifetime article through an assistant (the same article as the dashboard). Ongoing generation needs a paid plan. UGC video needs Pro or Ultra.

  • Free includes 1 lifetime article, shared across the dashboard and any assistant. After that article is used, ongoing generation needs a paid plan.
  • Starter is $39/month and includes a 3-day trial.
  • Pro is $79/month.
  • Ultra is $159/month.
  • Read tools work on every plan. Refreshing metrics through an assistant needs Starter, Pro, or Ultra. Queuing a UGC video needs Pro or Ultra.

ChatGPT talks to RankReactor over MCP. The RankReactor app is awaiting approval for the ChatGPT app directory. Until it is listed there, connect it yourself in developer mode.

Which ChatGPT plans can use developer mode

OpenAI’s ChatGPT developer mode guide states that developer mode is available to Plus, Pro, Business, Enterprise, and Education accounts on ChatGPT web. It is a paid ChatGPT plan. Free ChatGPT cannot enable developer mode.

On Business, Enterprise, and Education workspaces, an admin or owner may have to allow developer mode before you see the toggle. Each admin or owner turns it on for their own account.

Enable developer mode and add RankReactor

These steps follow OpenAI’s current developer-mode docs. The MCP URL is https://www.rankreactor.ai/mcp. Choose OAuth when ChatGPT asks how to authenticate.

  1. In ChatGPT, open Settings → Security and login and turn on Developer mode.
  2. Go to ChatGPT Plugins.
  3. Select the plus button. The plus button creates a developer-mode app only after Developer mode is on.
  4. Enter a name such as RankReactor, a short description, and the MCP server URL https://www.rankreactor.ai/mcp (include the /mcp path).
  5. Choose OAuth as the connection method, then create the connection.
  6. When RankReactor opens Connect RankReactorAI, paste the project key from Dashboard → API Key and choose Allow.
  7. Review the tools ChatGPT discovered. Created apps appear under Drafts in app settings.
  8. Start a new chat. Choose Developer mode from the Plus menu and select the RankReactor app for that conversation.

Create a project API key

  1. Sign in and open the project you want the assistant to use.
  2. Open API Key in the dashboard sidebar.
  3. Choose Generate. If a key already exists, choose Regenerate only when you intend to replace it.
  4. Copy the key now. RankReactor shows the full value once.
  5. Paste it on the Connect RankReactorAI page (OAuth) or into the client’s Authorization header.

Available tools

This connection is scoped to one project. Do not ask the assistant to guess another site. Write tools ask for confirmation first.

  • List projects (list_projects) — List the RankReactor project this API key can use. The key is scoped to exactly one project, so the result is that single site. Example: “Which RankReactor site is this connection using?”
  • Get reactor status (get_reactor_status) — Read this site's plan, quotas, and recent article or video activity. Example: “How many articles are left on this project today?”
  • Get metrics (get_metrics) — Read stored search and site health numbers for this RankReactor project. Example: “Show the stored search metrics for this site.”
  • Refresh metrics (refresh_metrics) — Refresh one stored metric for this project (analytics, technical SEO, website audit, or keywords), subject to that metric's plan limit. Confirmation required. Example: “Refresh analytics for this project if that metric is due.”
  • List articles (list_articles) — List generated articles for this RankReactor project. Example: “List the generated articles for this site.”
  • Generate article (generate_article) — Queue an article for this project. Uses the same article limits as the RankReactor dashboard. Confirmation required. Example: “After I confirm, queue an article for the keyword running shoes.”
  • List UGC videos (list_ugc_videos) — List generated short videos for this RankReactor project. Example: “List UGC videos for this project.”
  • Generate UGC video (generate_ugc_video) — Queue a short product video for this project. Uses the same monthly video limits as the RankReactor dashboard. Confirmation required. Example: “After I confirm, queue a short product video about our trail runner.”

Troubleshooting

  • 401, invalid, or revoked key — the server returns 401 when no Authorization header is sent, or when the token is invalid or revoked. Generate a key on the matching project and update the client.
  • Regenerated key — the previous key stops working as soon as you confirm Regenerate. Paste the new key into OAuth consent or the Bearer header.
  • Revoke — Revoke on the API Key page stops the current key immediately. Existing OAuth and header connections are refused until you generate a new key.
  • Wrong project or domain — each key belongs to one project. A domain that names a different site is rejected. Create a key on the project you want, or omit the domain so the keyed site is used.
  • Plan-gated tools — Free can generate its one lifetime article through an assistant; that count is shared with the dashboard. Ongoing article generation needs a paid plan. Refreshing metrics through an assistant needs Starter, Pro, or Ultra. Queuing a UGC video needs Pro or Ultra. Read tools still work on Free.
  • Article limit — Free has one lifetime article across the dashboard and assistants. Paid plans have a daily article cap (UTC). When a paid daily cap is reached, the tool reports that the article limit has been reached and when it resets.
  • Video limit — Pro and Ultra have a monthly UGC video cap (UTC). When it is reached, the tool reports that the monthly video limit has been reached.
  • Metrics cooldown — Starter, Pro, and Ultra can refresh one metric at a time, then wait that metric’s interval. Analytics, technical SEO, and website audit wait 7 days on Starter, 1 day on Pro, and 8 hours on Ultra. Keywords wait 21 / 14 / 7 days. Free does not refresh metrics through the assistant.

ChatGPT-specific notes

  • The RankReactor app is awaiting approval for the ChatGPT app directory. Developer mode is the supported way to connect today.
  • Write tools need confirmation. Expand the tool payload and check the arguments before you allow a generate or refresh call.
  • If ChatGPT cannot connect, confirm Developer mode is on, the URL includes /mcp, and you chose OAuth — not “no authentication”.
  • After you change tools on the RankReactor side, open the connection in ChatGPT Plugins and use Refresh, then start a new conversation.
  • Be explicit in the prompt when several apps are enabled: “Use RankReactor’s list_projects tool.”

Need help?

Email help@rankreactor.ai or reach out on X at @rankreactorai if ChatGPT cannot add the connector or the consent page rejects the key. Include the project domain and which assistant you used.

PreviousOverviewNextClaude

Questions? Email help@rankreactor.ai or reach out on X at @rankreactorai and include your project domain.