RankSurge
Back to Docs

Install the RankSurge plugin for Codex

Add RankSurge MCP and Agent Skills to Codex with one marketplace and one install command.

The RankSurge plugin bundles RankSurge MCP and all nine SEO Agent Skills into one install. This is the preferred way to set up RankSurge in Codex CLI.

Install

Run these commands in your terminal:

codex plugin marketplace add every-app/open-seo
codex plugin add openseo@openseo
codex mcp login openseo

codex mcp login opens a browser to approve the RankSurge connection. If it reports that openseo isn't found, restart Codex first — bundled MCP servers only register after a restart, not immediately after install — then run codex mcp login openseo again.

Codex connects RankSurge MCP at https://app.ranksurge.co/mcp and enables nine skills:

  • SEO Project Setup
  • SEO Coach
  • SEO Audit
  • Keyword Research
  • Keyword Clustering
  • Competitive Landscape
  • Competitor Analysis
  • Local SEO
  • Link Prospecting

Run a skill

Type $ in Codex to see available skills, or ask Codex to run one by name, for example "run seo-project-setup" or "run seo-audit on example.com".

Update or remove

codex plugin marketplace upgrade openseo
codex plugin remove openseo@openseo

Troubleshooting

If the RankSurge MCP server doesn't appear after restart, run /mcp in the Codex TUI to check its status, then run codex mcp login openseo again.

If it still doesn't authenticate, log out first and retry:

codex mcp logout openseo
codex mcp login openseo

If a codex plugin command reports "unrecognized subcommand," run codex plugin --help to see the subcommands your installed version actually supports — they've changed across versions (for example, add/remove, not install/uninstall).

Other clients

This plugin is for Codex CLI. For Claude Code, use the RankSurge plugin for Claude Code instead. For Claude Desktop, Cursor, Codex Desktop, or an API key setup, see Set up RankSurge MCP and Set up RankSurge Agent Skills.