The Oncrawl MCP Server connects Oncrawl to AI tools that support the Model Context Protocol (MCP).
It allows you to access your Oncrawl data and run supported actions directly from your AI Assistant.
What is MCP?
The Model Context Protocol (MCP) lets AI tools connect to external data sources and services.
With MCP, your AI Assistant can interact with Oncrawl without manual exports or switching tools.
What is the Oncrawl MCP Server?
The Oncrawl MCP Server is Oncrawl’s MCP endpoint.
It exposes Oncrawl data and features as tools that AI clients can use.
With it, you can:
access workspaces, projects, and crawls
query crawl, crawl-over-crawl, and log data
analyze datasets (aggregations)
retrieve page-level details
run operations like launching crawls or managing projects
The server uses your Oncrawl account and respects your permissions.
Endpoint URL
Why use it?
Use the MCP Server to work faster with Oncrawl data in AI tools.
analyze technical SEO data more easily
speed up investigations and reporting
access insights without navigating multiple reports
combine Oncrawl with other MCP-connected tools
What can you do with it?
Analyze data
run technical SEO audits
find crawl issues and regressions
analyze orphan pages and crawlability
explore log data
Run operations
manage projects and crawl configurations
launch and monitor crawls
create comparisons and exports
Available actions depend on your permissions.
Prerequisites
Oncrawl account
Access to projects and data
MCP-compatible client
Some clients may require specific plans or settings.
Authentication and permissions
The Oncrawl MCP Server uses OAuth authentication with your Oncrawl account.
During setup:
Your MCP client will request access
You will see a consent screen showing which client is requesting access
You will log in to your Oncrawl account
You will approve the requested permissions (scopes)
Important
Always verify the client requesting access before approving
Permissions (scopes) determine what actions can be performed
If you do not grant write permissions, actions (create, update, delete) will not be executed
If you grant full permissions, you are responsible for any actions performed
Some actions (such as deleting projects) may be irreversible.
Getting started
1. Add the MCP server
Use the Oncrawl MCP endpoint:
https://mcp.oncrawl.com/mcp
Add it to any MCP-compatible client (ChatGPT, Claude, Cursor, etc.).
See setup instructions by platform:
2. Authenticate
Sign in with your Oncrawl account when prompted.
Your access and permissions will match your Oncrawl user rights.
3. Start with a simple prompt
Try one of these:
“Show my Oncrawl context”
“List my projects”
“Show my latest crawl”
4. Explore your data
You can now ask questions like:
“Count pages by status code in my latest crawl”
“Find orphan pages”
“Compare my last two crawls”
5. Run actions (if permitted)
Depending on your permissions, you can also:
create a project
launch a crawl
create a crawl configuration
schedule a crawl
Notes
The MCP Server uses standard MCP transport (Streamable HTTP)
MCP availability depends on your AI client and plan
Some platforms require developer mode or admin approval
Always connect only to trusted MCP servers
Behavior such as confirmations may vary depending on the AI client
Next steps
See the full tools reference:
Once connected, you can use the Oncrawl MCP Server as a faster interface for both analysis and operations in Oncrawl.
For advanced use cases, start by:
retrieving your user context
listing available projects or crawls
discovering fields for the relevant dataset
using OQL to refine your queries