How to Connect SEOLint to Claude as an MCP Server
MCP (Model Context Protocol) lets Claude use external tools natively, the same way it can read files or search the web. This guide shows you how to add SEOLint as an MCP server so Claude can scan any URL for SEO issues directly from a conversation, without you ever opening a browser.
What Claude gets access to
Once connected, Claude has three new tools available in every conversation:
| Tool | What it does |
|---|---|
scan_website | Scan a URL: returns structured issues with severity and fix prompts |
get_scan | Fetch a previous scan result by ID |
list_scans | List recent scans for your account |
Step 1: Get your API key
Sign up at seolint.dev/pricing. Your API key is generated instantly on the dashboard. No forms, no waiting. It looks like sl_live_xxxxxxxxxxxx.
Step 2: Add to Claude Desktop
Open your Claude Desktop config file. On Mac it lives at ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows: %APPDATA%\Claude\claude_desktop_config.json. Add the following block:
{
"mcpServers": {
"seolint": {
"type": "http",
"url": "https://seolint.dev/mcp",
"headers": {
"Authorization": "Bearer sl_live_YOUR_KEY_HERE"
}
}
}
}Restart Claude Desktop. You should see “seolint” in the tools panel.
Or add to Claude Code
If you use Claude Code in the terminal, run this once:
claude mcp add --transport http seolint \ https://seolint.dev/mcp \ --header "Authorization: Bearer sl_live_YOUR_KEY_HERE"
The server is now available in every Claude Code session in this project.
Step 3: Ask Claude to scan
Open a new conversation and ask Claude naturally. Some examples:
“Scan https://mysite.com and tell me what SEO issues to fix.”
“Scan my homepage and apply the fixes to the codebase.”
“What changed in the SEO score since last week? Check the last two scans.”
“Scan https://mysite.com/blog/my-post and give me the H1 and title tag fix.”
When Claude Code has access to your repo, it can apply the fixes directly, not just describe them.
What Claude sees
Each issue in the scan result includes a fix_prompt field. Each one is a ready-to-use LLM instruction Claude can execute immediately:
{
"id": "missing-h1",
"severity": "critical",
"title": "Missing H1 tag",
"fix_prompt": "Add a single <h1> tag to this page containing the primary keyword. The page is about [topic]. Place it as the first heading inside the <main> element."
}Claude reads this structure natively and can execute the fix in Cursor or Claude Code without any additional prompting from you.
FAQ
What is an MCP server?
MCP (Model Context Protocol) is an open standard that lets AI assistants like Claude connect to external tools and data sources. When you add SEOLint as an MCP server, Claude gains the ability to call scan_website() as a native tool, no copy-pasting URLs into a browser needed.
Does this work with Claude Code as well as Claude Desktop?
Yes. Claude Code supports MCP servers via the `claude mcp add` command. Once added, you can ask Claude Code to scan your site from the terminal or from within a Cursor session.
What plan do I need?
All paid plans include MCP server access. The Solo plan (€19/month) covers 10 scans and is enough for most founders managing their own site.
Can Claude automatically apply the SEO fixes it finds?
Yes. When Claude has access to your codebase (via Claude Code or Cursor), it can read the scan results and apply the fixes directly. Each issue in the API response includes a structured fix_prompt field designed for this workflow.