Audit any site from your AI assistant
DidYouSEO is an AI SEO agent that runs inside Claude, ChatGPT, and Cursor over MCP. Run a 30+ point technical SEO audit, pull a ranked fix list, and use free SEO tools - right in the chat.
What your AI agent can do
The MCP server turns DidYouSEO's SEO engine into tools your assistant can call on its own, so the work happens where you already work.
Run audits from your assistant
Ask in plain language and your assistant calls DidYouSEO to run a 30+ point technical SEO audit on any URL - no tab-switching, no dashboard.
Pull a prioritized fix list
Get back the critical and warning issues with the reason each one matters and how to fix it, so your assistant can reason over what to fix first.
Track sites and scores
Sign in and let your assistant list the sites in your account, add new ones, and pull the latest SEO score for a whole site or a single page.
Free SEO tools on any URL
Inspect meta tags, robots.txt, structured data, SERP appearance, Core Web Vitals, Open Graph, and hreflang - the free tools need no account.
What you can do in your assistant
Every DidYouSEO tool is one message away. Here are workflows you can run - just type the prompt.
“Run an SEO audit on https://example.com/pricing, then give me the top 3 things hurting the score and how to fix them.”
calls run_seo_audit
“Is https://example.com blocking search engines in its robots.txt? Explain any problems in plain English.”
calls check_robots_txt
“Preview how https://example.com/blog/my-post would look in Google, and suggest a better title tag and meta description.”
calls serp_preview
“List the sites in my DidYouSEO account and show the latest score for each.”
calls list_sites · get_site_score
“Validate the structured data on https://example.com and tell me what's missing.”
calls validate_schema
“Check the Core Web Vitals for my homepage and explain what's slowing it down.”
calls check_core_web_vitals
Connect DidYouSEO to your assistant
Point any OAuth-capable MCP client at the remote server. It discovers the sign-in automatically and prompts you before sending any tool requests.
Endpoint URL
- 1
Open your assistant's connector settings
In Claude, go to Settings → Connectors. Cursor and other MCP clients have an equivalent custom-connector option.
- 2
Add DidYouSEO as a custom connector
Paste the endpoint URL https://didyouseo.com/mcp and give it a name like DidYouSEO.
- 3
Sign in with your DidYouSEO account
A browser sign-in opens automatically (OAuth) - there are no API keys to copy or rotate. The free tools work without an account.
- 4
Ask for an audit in plain language
Your assistant discovers the tools on its own. Asking it to audit a URL is enough to trigger a scan and pull the results back.
Prefer to call it directly? The same audit data is available over the REST API. For clients that only support local servers, use the npx @didyouseo/mcp bridge.
Why run an audit from an agent, not a dashboard
A dashboard shows you everything; an agent answers one question and acts on the answer. Over MCP, your assistant receives the actual audit results as structured data it can filter, sort, and reason about - so there's no export step between finding an issue and fixing it, and the same context that spots a schema problem can draft the corrected markup.
A good rule: let the agent read, sort, and draft, and keep the deciding and verifying for yourself. Always run drafted structured data through a validator before it goes live.
Works with any MCP-compatible assistant
MCP is an open standard, so DidYouSEO plugs into the assistants you already use - and any new one that adopts the spec.
AI SEO agent & MCP FAQ
What is an AI SEO agent?
An AI SEO agent is an AI assistant - like Claude, ChatGPT, or Cursor - that can run SEO tasks for you by calling tools. With DidYouSEO's MCP server connected, your assistant can run a technical SEO audit, pull a ranked list of issues, check scores, and use free SEO tools, all from the chat without opening a dashboard.
How do I connect DidYouSEO to Claude or ChatGPT?
Add a custom connector in your assistant's settings and paste the endpoint https://didyouseo.com/mcp. A browser sign-in opens automatically to link your DidYouSEO account - there are no API keys to manage.
Do I need a DidYouSEO account to use the MCP server?
The free SEO tools (meta tags, robots.txt, schema, SERP preview, Core Web Vitals, Open Graph, hreflang) work on any URL without an account. The account tools - running audits, managing sites, and pulling saved scores - require signing in, which happens securely in-flow via OAuth.
Which tools does the DidYouSEO MCP server expose?
Thirteen tools: run an SEO audit, get a past audit, list and register sites, get a site or page score, and seven free URL tools - analyze meta tags, check robots.txt, validate structured data, preview SERP appearance, check Core Web Vitals, and inspect Open Graph and hreflang tags.
Does using DidYouSEO over MCP cost extra?
No. The MCP server uses the same account and plan limits as the rest of DidYouSEO - the free plan works, and account tools count against your normal plan limits. There is no separate charge for connecting over MCP.
Give your assistant SEO superpowers
Sign up free, connect the MCP server, and run your first audit from inside your assistant.