How to add SEO Score API to ChatGPT
In ChatGPT on the web, open Plugins, choose Add custom MCP server, paste https://seoscoreapi.com/mcp and pick OAuth. ChatGPT sends you to seoscoreapi.com to sign in and approve, then you type @ in a chat and pick SEO Score API. ChatGPT cannot send API keys, so sign-in is the only way in.
Once it is connected, ChatGPT can run SEO Score API's tools for you: SEO audits with 80+ checks, GEO and AI-visibility checks, ADA / WCAG accessibility audits, AI citation tracking, site crawls and Deep Audits, all on your own plan.
Set it up
- Open Plugins. In ChatGPT on the web, go to chatgpt.com/plugins.
- Add the server. Select the + button, then Add custom MCP server.
- Name it and paste the URL. Name: SEO Score API. Description (optional): SEO, GEO and ADA accessibility audits for any URL. Under Connection, enter the server URL
https://seoscoreapi.com/mcp. - Choose OAuth. Under authentication, choose OAuth. Review the risk warning and select I understand and want to continue, then Create as a plugin.
- Sign in and approve. Install the plugin. ChatGPT opens seoscoreapi.com: sign in with an email link, Google or GitHub (or create a free account) and click Allow.
- Use it in a chat. Start a new conversation, type @ in the prompt box and select SEO Score API, then ask for an audit.
The config
https://seoscoreapi.com/mcpCustom MCP servers depend on your ChatGPT plan and, in a workspace, on what your admin allows. If you don't see Add custom MCP server, your plan or workspace doesn't offer it yet.
After we add tools, open the plugin in ChatGPT Plugins and select Refresh to pull the new list.
Prompts to try first
Swap in your own URL. The plan column says who can run each one.
| Ask | Tool | Plan |
|---|---|---|
| Audit https://example.com and list the top 5 fixes, most important first. | audit | Free key |
| How well can AI assistants read https://example.com? Run an AI readability check. | ai_readability | Free key |
| Score the conversion of https://example.com/pricing and tell me what is costing sign-ups. | conversion | Free key (full fix list on paid plans) |
| Is https://example.com visible to ChatGPT and AI search? Run a GEO audit. | geo_audit | Basic ($15/mo) and up |
| Check https://example.com for ADA / WCAG 2.1 AA issues and list the critical ones with fixes. | accessibility_audit | Paid plans, from Starter ($5/mo) |
| Generate an llms.txt file for example.com. | llms_txt | Any key |
| Crawl example.com and show me the broken pages, redirects and orphan pages. | crawl_site | Pro ($39/mo), Ultra or a Deep Audit credit |
| Track whether ChatGPT, Gemini, Perplexity and Claude mention Acme when people ask for an SEO tool. Build starter prompts, create a citation tracker and run it. | create_citation_tracker | Starter ($5/mo) and up |
| Run a Deep Audit on https://example.com and list the high-severity findings. | deep_audit | Pro ($39/mo), Ultra or credits |
Troubleshooting
There is no option to add a custom MCP server
Custom MCP servers are not on every ChatGPT plan, and workspace permissions apply. Ask your workspace admin, or use SEO Score API from an assistant that is on this list, such as Codex or Claude.
ChatGPT asks for an API key or header
It doesn't support them for custom servers. Choose OAuth and sign in with your SEO Score API account instead.
ChatGPT doesn't use the tools
Type @ and pick SEO Score API in that chat, and name the task plainly: "Run an SEO audit on https://...".
The tools are listed but every call fails with an authentication error
Listing tools needs no key; running one does. Check the key starts with ssa_, that the header reads exactly Authorization: Bearer ssa_... (one space after Bearer) or X-API-Key: ssa_..., and that the key was not rotated in your dashboard since.
A tool says it needs a higher plan
Some tools are on paid plans only (GEO audits from Basic, accessibility audits and citation trackers from Starter, crawls and Deep Audits from Pro). The message names the plan; your free audits keep working.
A tool says you have used this month's audits
The free plan includes 20 audits a month. The message gives the reset date and a one-click upgrade.
FAQ
Does SEO Score API work in ChatGPT?
Yes. Add https://seoscoreapi.com/mcp as a custom MCP server in ChatGPT Plugins, choose OAuth and sign in to your SEO Score API account.
Can I paste my API key into ChatGPT?
No. ChatGPT does not present custom API keys to MCP servers, so you connect by signing in. The account you sign in with decides your plan and allowance.
Is it free?
Yes, to start. A free SEO Score API key includes 20 audits a month and needs no card. GEO audits, accessibility audits, citation tracking, crawls and Deep Audits need a paid plan; plans start at Starter ($5/mo). Every tool call uses your plan's allowance exactly as the REST API does.
Do I need to install anything?
No. The server is hosted at https://seoscoreapi.com/mcp, so you add a URL, not a program. If your assistant only runs local servers, the same tools are in the open-source npm package: npx -y seoscoreapi-mcp with SEO_SCORE_API_KEY set.
API key or sign-in: which should I use?
Either works. Assistants that let you set a request header can send your key as Authorization: Bearer ssa_... or X-API-Key: ssa_.... Assistants with MCP sign-in open seoscoreapi.com, you sign in with an email link, Google or GitHub (or create a free account), approve, and you are done. Listing the tools works without either; running one needs one of them.
What can't it do?
It does not download PDF reports (a tool result is text; the audit tool returns the same data), it does not change account settings such as auto-reload, and it cannot create, upgrade or rotate keys. Those stay in your dashboard.
Other assistants
Claude · Claude Code · Cursor · VS Code / GitHub Copilot · Gemini CLI · Codex · Windsurf / Devin Desktop · Copilot Studio
Questions? Email aaron@seoscoreapi.com. See every AI assistant guide, all integrations and the API docs.