Integrations · MCP client
Register SEOBolt as an MCP server in Codex CLI and let Codex audit the site, patch the repository from the fix plan, and verify with a fresh crawl.
Available on Pro or Business · 7-day free trial
In SEOBolt, open Dashboard → Settings → API Keys and create a key (sk_live_…), then export SEOBOLT_API_KEY=sk_live_YOUR_KEY in your shell.
Add this to ~/.codex/config.toml. Codex reads the Bearer token from the SEOBOLT_API_KEY environment variable.
[mcp_servers.seobolt]
url = "https://seobolt.app/mcp"
bearer_token_env_var = "SEOBOLT_API_KEY"Same tools, runs locally with Node.js:
codex mcp add seobolt --env SEOBOLT_API_KEY=sk_live_YOUR_KEY -- npx -y mcp-server-seoboltStart codex and run /mcp to confirm seobolt and its tools are listed.
| MCP tool | What it does |
|---|---|
| seo_projects | List all SEO projects with health scores and stats |
| seo_audit | Get the SEO audit (health score, page count, issues summary) for a project |
| seo_issues | Get detailed SEO issues with fix recommendations, grouped by type, with affected URLs |
| seo_start_crawl | Start a new SEO crawl for a project. |
| seo_fix_plan | Get the full prioritized fix plan for a project: every site-wide issue with a ready-to-apply code snippet and the affected URLs. |
| seo_fix_suggestions | Get specific code fix suggestions with HTML snippets for a particular page URL |
| seo_content_score | Score a page's SEO optimization for a target keyword. |
| seo_compare | Compare two pages head-to-head on SEO metrics. |
| seo_get_checkout_url | Get a checkout URL to upgrade to a paid plan. |
| seo_domain_rating | Get the Domain Rating (DR) for any domain. |
| seo_keyword_difficulty | Check how hard it is to rank for a keyword. |
| seo_content_gap | Find topics that competitors rank for but you don't. |
| seo_link_prospects | Find domains that link to competitors but not to you. |
| seo_gsc_content_opportunities | Find keywords a site ALREADY ranks for in Google Search Console but does not target on-page — the highest-ROI content play. |
| seo_gsc_reality | Explain WHY a site's top pages do (or don't) get traffic — fuses each page's real GSC numbers (impressions/clicks/position) with a live on-page crawl and returns an honest per-page verdict plus a single headline naming the true growth bottleneck (on-page hygiene vs. authority/rank vs. snippet/CTR). |
| seo_gsc_prune_candidates | Find pages worth pruning from a connected Google Search Console property: 0 clicks and <50 impressions over the window (default 90 days). |
| seo_gsc_repoint | Find pages whose top Google Search Console query is not reflected in the live title/H1 (connected GSC + live crawl). |
| seo_gsc_cannibalization | Find keyword cannibalization in a connected Google Search Console property: queries where 2+ URLs of the site each get at least 10% of the query's impressions. |
| seo_gsc_secondary_keywords | List every query a page already ranks top-10 for in a connected Google Search Console property, grouped by overlap, with a suggested title (≤60 chars) covering the top 2-3 secondary queries. |
| seo_brand_mentions | Brand Radar: find pages that mention your brand or domain without linking to you (unlinked mentions = easy link requests). |
| seo_find_contact | Find how to contact a website for outreach: emails published on the page and on the same site's /contact, /contact-us, /about and /write-for-us pages (mailto links, visible text, Cloudflare-protected addresses), plus its contact page / contact form URL. |
| seo_ai_citations | AI citation check (GEO): ask an AI engine with live web search (OpenAI Responses API + web_search) up to 10 buyer prompts and report, per prompt, whether your domain is cited, whether your brand is mentioned, which other domains are cited, and an answer excerpt. |
MCP access is included on Pro ($49/mo) and Business ($99/mo). Both start with a 7-day free trial. The API key comes from Dashboard → Settings → API Keys.
Both expose the same tools. The remote endpoint (https://seobolt.app/mcp) needs nothing installed. The npx package (mcp-server-seobolt) runs locally over stdio and needs Node.js.
seo_fix_plan returns each issue with a code snippet and the affected URLs. A coding agent can apply those to your repository; you deploy, then seo_start_crawl and seo_audit confirm the score went up.
The key is sent only to seobolt.app as a Bearer token. Keep the config file out of version control and revoke the key in Settings if it leaks.