Install the RankSurge plugin for Codex

The RankSurge plugin bundles RankSurge MCP and all ten 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 shekhu10/RankSurge
codex plugin add ranksurge@ranksurge
codex mcp login ranksurge

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

Codex connects RankSurge MCP at https://app.openseo.so/mcp and enables ten skills:

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

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

codex plugin marketplace upgrade openseo

Reload or restart Codex if the updated skills are not available. For other installation methods, see Agent setup and skill updates.

Remove

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 ranksurge again.

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

codex mcp logout ranksurge
codex mcp login ranksurge

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.