MCP Tool Reference
Discover all Screpy MCP tools for projects, crawls, rankings, AI Visibility, backlinks, disavows, and Search Console.
Screpy MCP exposes the tools below to an authorized AI client. Follow setup and OAuth authentication before using them. REST API keys do not authenticate MCP.
Select accessible data first
Call list_projects before using a project, then pass its project_uid. For crawl data, call list_crawls and keep the returned crawl_uid with that same project. Use IDs, domains, and hashes returned by tools instead of constructing them.
Responses include context, data, pagination, and warnings. When a result includes next_cursor, pass it as cursor with the same selectors and limit to continue. Each client's tool schema lists the exact required and optional arguments. Project access and plan eligibility are checked on every call.
Only request a write when you intend to change your project. Tools with a confirm argument require explicit confirmation of that exact action before confirm=true is sent. Additions may consume plan allowances; deletions may remove stored history.
Account
Related REST reference: Account.
| Tool | Purpose |
|---|---|
get_account_context | Return the authenticated member's available project count and current product access context. Use this only to understand the current account. |
get_plan_usage | Return current usage and remaining allowance for features that MCP actions may consume. |
Projects
Related REST reference: Projects.
| Tool | Purpose |
|---|---|
list_projects | List projects the authenticated member can access. Use this first when a project has not been identified. |
get_project_overview | Return a high-level SEO and crawl overview for one selected project. Do not use for page-level records. |
compare_projects | Compare summary metrics for two to five accessible projects. Use this for project-level comparison, not individual page inspection. |
create_project | Create a new Screpy project for a supplied domain. This may consume crawl capacity and requires explicit confirmation. |
update_project_settings | Update allowed settings for one selected project. Use only for explicit configuration changes. |
delete_project | Remove one selected project from your active Screpy dashboard. Requires explicit confirmation. |
Crawls and comparisons
Related REST reference: Crawls and comparisons.
| Tool | Purpose |
|---|---|
list_crawls | List crawl runs for one project so a specific crawl can be selected for analysis. |
get_crawl_status | Return the current state and progress of one crawl. Use this after starting a crawl or while waiting for results. |
start_crawl | Start a new crawl for one project. Requires explicit confirmation because it may consume plan allowance. |
get_crawl_summary | Return crawl-level totals, health indicators, and issue counts for one completed crawl. |
compare_crawls | Compare two selected crawls from accessible projects and return metric deltas. |
Crawl data
Related REST reference: Crawl data.
| Tool | Purpose |
|---|---|
get_on_page_overview | Return on-page audit metrics for one crawl. Use this before drilling into pages, links, or images. |
list_pages | List pages from one crawl using structured filters. |
get_page_details | Return detailed crawl data for one exact page in a selected crawl. |
list_quick_wins | List Quick Wins opportunities for one project from search performance, crawl analysis, or connected traffic analytics. |
list_links | List link records from one crawl using structured filters. |
get_link_sources | List pages that link to one specified destination URL within a selected crawl. |
list_images | List image records from one crawl using structured filters. |
get_image_sources | List pages that reference one selected image in a crawl. |
Health
Related REST reference: Health.
| Tool | Purpose |
|---|---|
list_core_web_vitals | Return available Core Web Vitals results for one project. Use this for performance metrics, not crawl page data. |
get_uptime_summary | Return uptime status and recent incidents for one project. |
Search Console and Index Status
Search Console and Index Status are MCP-only surfaces; the REST API does not expose matching endpoints. See the Search Console guide.
| Tool | Purpose |
|---|---|
get_search_console_connection | Check Search Console availability and the selected property for a project before querying performance. |
get_search_console_overview | Get first-party Search Console totals and daily trend, or hourly trend for the 24h preset. |
query_search_console_performance | Query project Search Console clicks, impressions, CTR, and position by up to three dimensions with filters and pagination. |
compare_search_console_periods | Compare Search Console performance for two periods with the same property, search type, and filters. |
inspect_search_console_url | Inspect one URL under the selected Search Console property using the version in Google index, not a live URL test. |
get_index_status_audit | Read the latest existing Screpy crawl-based Index Status audit for one project. Does not start an audit. |
list_index_status_urls | List inspected URLs from the latest existing Index Status audit, with index, coverage, and URL filters. |
AI Visibility
Related REST reference: AI Visibility.
| Tool | Purpose |
|---|---|
get_ai_visibility_options | Get AI Visibility engines, locales, frequency, last analysis time, and prompt usage for a project. |
get_ai_visibility_overview | Get stored AI Visibility trends, recent mentions, top sources, competitor ranking, and share of voice. |
list_ai_visibility_mentions | List stored AI Visibility mentions with optional prompt search, platform, brand, and cursor filters. |
get_ai_visibility_answer | Get one project-scoped completed AI Visibility answer with mentioned brands, sentiment statements, and citations. |
list_ai_visibility_prompts | List tracked AI Visibility prompts with optional search, market, brand, and cursor filters. |
get_ai_visibility_prompt_activity | List stored answers or citations for one project-scoped AI Visibility prompt. |
list_ai_visibility_sources | List stored AI Visibility citation sources grouped by domain or page URL. |
get_ai_visibility_source_activity | List stored citations or prompts for one AI Visibility source domain or page URL hash. |
add_ai_visibility_prompts | Add 1 to 20 AI Visibility prompts for one market. Requires explicit confirmation because it consumes plan capacity. |
delete_ai_visibility_prompt | Delete one project-scoped AI Visibility prompt. Requires explicit confirmation. |
Rank Tracker
Related REST reference: Rank Tracker.
| Tool | Purpose |
|---|---|
get_rank_tracker_options | Get supported Rank Tracker countries, languages, devices, frequencies, and segment rule options. |
get_rank_tracker_overview | Get Rank Tracker summary metrics, 30-day visibility, position distribution, plan usage, and frequency. |
list_rank_tracker_keywords | List Rank Tracker keywords with device, search, segment, unmatched, sorting, and cursor filters. |
get_rank_tracker_keyword | Get one Rank Tracker keyword with up to 30 analyses and stored results for the selected or latest analysis. |
add_rank_tracker_keywords | Add up to 100 Rank Tracker keywords for mobile, desktop, or both. Requires explicit confirmation because it consumes plan capacity and starts initial analysis. |
delete_rank_tracker_keywords | Delete up to 100 project-scoped Rank Tracker keyword IDs, optionally including their matching device variants. Requires explicit confirmation. |
list_rank_tracker_segments | List Rank Tracker segments with match counts, suggestions, and unmatched keyword count. |
preview_rank_tracker_segment | Preview Rank Tracker segment rules without saving them. Returns match, average position, overlap, and example keywords or URLs. |
create_rank_tracker_segment | Create a Rank Tracker segment only when the user explicitly asks to save these rules. |
update_rank_tracker_segment | Update a project-scoped Rank Tracker segment only when the user explicitly asks to save the changes. |
delete_rank_tracker_segment | Delete one project-scoped Rank Tracker segment. Requires explicit confirmation. |
Backlinks and disavows
Related REST reference: Backlinks and disavows.
| Tool | Purpose |
|---|---|
get_backlink_options | Return eligible project and added competitor targets and supported backlink input options. |
get_backlinks_overview | Read backlink profile summary, history, top anchors, referring domains, and linked pages for the project or an added competitor. |
list_backlinks | List backlinks with source and destination URLs, anchors, authority, risk, follow status, and dates. Use next_cursor with unchanged selectors. |
list_referring_domains | List referring domains with authority, link counts, risk signals, and first-page summary. |
list_referring_domain_backlinks | Read one full source domain's live backlinks for an eligible target, or lost/broken backlinks for the project domain. |
get_backlink_gap | Compare the project with one added competitor. Return domains linking to the competitor but not the project, plus comparison history. |
list_lost_backlink_domains | List source domains with lost backlinks to the project. Read individual links with list_referring_domain_backlinks and status lost. |
list_broken_backlink_domains | List source domains with broken backlinks to the project. Read individual links with list_referring_domain_backlinks and status broken. |
list_disavows | Read the selected project's disavow entries, notes, dates, totals, and continuation cursor. |
add_disavows | Add up to 100 domains or URLs to the project's disavow export list with an optional note. Requires explicit confirmation. Does not submit to Google. |
delete_disavow | Remove one project-scoped disavow entry from the export list. Requires explicit confirmation. Does not submit to Google. |
export_disavows | Return an authenticated resource link to a Google-compatible disavow text page. Follow next_cursor and concatenate all pages to obtain the complete file. |
export_backlink_table | Export the current page of one backlink analysis or disavow table as CSV or XLSX. Return an authenticated resource link and next_cursor, never silently export the full dataset. |
Research an added competitor's backlinks
- Call
list_projectsand select the project's UID. - Call
get_backlink_optionswith thatproject_uidto retrieve eligible targets and competitor IDs. - Call
list_backlinkswith the sameproject_uidand atargetdomain returned by options. Useget_backlinks_overviewfor the profile orlist_referring_domainsfor source domains. - Continue through
next_cursorwithout changing the target or other selectors.
To research a new domain, add it as a competitor to the project in the dashboard first. An arbitrary domain is not accepted. target is the domain being researched; domain on list_referring_domain_backlinks is a full referring domain returned by a source list.
get_backlink_gap compares the project with one added competitor_id. Lost and broken analyses use only the project's domain. The source-domain detail tool accepts status values live, lost, or broken; the last two are restricted to the project. See the Backlinks API workflow and Backlinks dashboard guide.
Export backlinks and manage disavows
export_backlink_table returns an authenticated resource link to one page of CSV or XLSX data. Keep the dataset and selectors unchanged when continuing with next_cursor. export_disavows also exports one page at a time; concatenate the text pages for a complete list. Resources recheck project access and feature eligibility when read.
add_disavows and delete_disavow require confirmation and change only the project's export list. They do not submit anything to Google. Review the Disavow guide before changing entries. The REST disavow text export downloads the complete project list in one request.
Understand feature-specific limits
- Rank Tracker: keyword details include up to 30 history records and the selected or latest stored results. Use the REST history endpoints to paginate through the full history. MCP does not provide ranking file export, live searches, or manual reanalysis.
- AI Visibility: tools read stored results and manage prompts.
get_ai_visibility_prompt_activityusesactivityset toanswersorcitations.get_ai_visibility_source_activityusessource_typeset todomainorurl, the returned domain or page URL hash assource_value, andactivityset tocitationsorprompts. File export, prompt suggestions, and manual reanalysis are not available. Useupdate_project_settingsfor frequency or engine selection. - Search Console: call
get_search_console_connectionfirst. Performance rows may omit lower-volume queries or pages. URL inspection describes Google's indexed version, not a live test or indexing request. - Index Status: tools read the latest existing audit; they do not start or refresh one.
Continue with example prompts or troubleshooting. The REST API reference documents HTTP integrations separately.