SEO MCP Tools Reference
Explore all 23 SEO MCP tools for account context, projects, crawls, pages, links, images, uptime, and Core Web Vitals.
SEO MCP provides 23 focused tools. Each tool has a bounded job and returns structured data that an AI agent can inspect. The server is designed around discoverable public identifiers, validated filters, and explicit permission checks.
Tool inventory
| Category | Tools |
|---|---|
| Account | get_account_context, get_plan_usage |
| Projects | list_projects, get_project_overview, compare_projects, create_project, update_project_settings, delete_project |
| Crawls | list_crawls, get_crawl_status, get_crawl_summary, get_on_page_overview, compare_crawls, start_crawl |
| Pages | list_pages, get_page_details, list_quick_wins |
| Links | list_links, get_link_sources |
| Images | list_images, get_image_sources |
| Monitoring | get_uptime_summary, list_core_web_vitals |
Required discovery order
Use list_projects before any project tool. Use list_crawls before any crawl-data tool. Never guess a project UID or crawl UID.
list_projects
→ list_crawls(project_uid)
→ get_on_page_overview(project_uid, crawl_uid)
→ list_pages(project_uid, crawl_uid, filters)This order keeps tool calls reproducible and prevents accidental use of internal or stale identifiers.
Pagination and filters
Record tools return bounded pages of results and support cursor pagination. pages, links, and images accept structured filters. Supported operators include:
eq,neqgt,gte,lt,lteincontainsis_null
Use no more than 20 filters in one request. Keep each query focused enough that the returned records answer one clear question.
Read-only and state-changing tools
The analysis surface is read-only. These tools change state:
create_projectupdate_project_settingsdelete_projectstart_crawl
The server instructs agents to avoid them unless the user explicitly requests the action. High-impact operations require explicit confirmation.
Choose a category in the sidebar for fields, examples, and safe prompting patterns.
Related documentation