MCP

Connect On-Page to your AI agent with a single command.

Your MCP Connector

Your API Key

Preparing your MCP key...

Connect your agent

Generate an install key in step 1 — your snippet will appear here ready to copy.

Start scanning

Once connected, ask your agent to scan any page. Example: "Scan https://yoursite.com and suggest SEO improvements"

Need help? Read the docs or manage your API keys.

Disclaimer: On-Page.ai does not control AI models, AI providers, or search engines. Any recommendations produced by your AI agent should be reviewed before implementation; you are responsible for website changes and resulting SEO outcomes.

Try It Now

Copy one of these prompts into your agent after connecting

“Scan https://yoursite.com for the keyword "keyword" and show me the most important missing entities I should add.”

“Run a deep scan on https://yoursite.com/blog/guide for "keyword" and build a competitor gap action plan.”

“Find the best internal pages to link to https://yoursite.com/product and suggest natural anchor placements.”

“Classify the content at https://yoursite.com/about — what topical categories does it cover?”

Available Tools

What your agent can do once connected

Classify page or text

Lightweight topical categorization for a URL or raw text block. Returns the top 3 categories in customer-safe format.

classify_text0.2 credits

Default SEO scan for recommendations

Best default scan for ranking diagnostics, missing entities, internal linking, and actionable on-page fixes.

scan_page2 credits

Lite SEO scan (quick)

Quick scan focused on entity coverage and competitor cohort analysis — ideal for fast audits and bulk workflows.

scan_page_lite1.5 credits

Run deep SEO scan

50% deeper competitor analysis than Standard scans with 15 competitors, plus an optional SERP-speed benchmark of your page against the top 3 ranking competitors.

scan_page_deep3 credits

Your agent also has access to check_credits, wait_for_job, check_job, and get_job_result for async workflow management.

Recommended Workflows

Common scan-to-action patterns your agent can follow

scan_page -> wait_for_job -> optimize missing entities with minimal sentence edits

scan_page -> wait_for_job -> turn internal_linking recommendations into an internal linking plan

scan_page -> wait_for_job -> improve vague sub-headlines with high-priority entities

scan_page -> wait_for_job -> review who/what/where/how authority gaps

scan_page_deep -> wait_for_job -> build a competitor gap action plan

scan_page_deep -> wait_for_job -> compare serp_speed_benchmark vs top 3 competitors and prioritize page-experience fixes

Scans are asynchronous and typically take 30 seconds to 3 minutes. Your agent uses wait_for_job automatically to poll for results.

Credit Costs

Per-request costs for each tool

classify0.2 credits

scan_lite1.5 credits

scan2 credits

scan_deep3 credits

Your agent can check the balance with check_credits before starting. Manage billing

FAQ

Common questions about the On-Page MCP connector

What is MCP?

Model Context Protocol (MCP) is an open standard that lets AI agents connect to external tools. Once connected, your agent can run SEO scans, extract entities, and optimize content without leaving the conversation.

Which AI agents are supported?

Claude Code, OpenAI Codex, VS Code (Copilot), Cursor, Windsurf, and Cline. Any MCP-compatible client can connect using the HTTP transport.

How long do scans take?

Standard and deep scans are asynchronous. They typically take 30 seconds to 3 minutes depending on server load. Your agent handles the waiting automatically.

What languages are supported?

English is the only officially supported language. You are free to try French, Spanish, and German, but they are unsupported and results may vary.

My connection isn't working

Make sure your API key is correct and has not been revoked. The MCP server URL is https://api.on-page.ai/mcp with HTTP transport. Check that your agent is sending the Authorization: Bearer header.

How do I uninstall the MCP connector?

For Claude Code or OpenAI Codex, the easiest option is usually to ask the AI agent to remove the connector from its own MCP configuration. Paste this prompt into the client where you installed On-Page SEO, then let the agent update its MCP settings.

Copy prompt

Remove the on-page-seo MCP connector

How do credits work?

Each tool call costs a set number of credits (e.g., 2 credits for a standard scan). Your agent can check the balance with check_credits before starting. Visit the Billing page to top up.

Can I rotate or revoke my API key?

Yes — go to the API Keys page to delete an existing key and create a new one. Update the key in your agent configuration after rotating.