Use MCP with full access

Use up to 30 scoped tools across an eligible paid account for Search Console, linked GA4, Technical SEO audits, Generative AI imports, SEO planning data, and optional write permissions.

Product guide · Updated October 2026

Understand full MCP access

Eligible paid access lets an owner or member approve up to 11 scopes for the selected CrawlRaven account. A paid grant is not pinned to one free-preview site and is not subject to the free preview’s 20-call daily allowance. It remains bound to one client, user, and account. Most tools only read data. Three write scopes change one record at a time without further approval, and annotations:write only proposes note changes that the same user approves in CrawlRaven.

ScopeWhat it provides
websites:readWebsite IDs, names, lifecycle state, activation, and full-workspace access.
search_performance:readOverview, daily totals, bounded Query and Page results, page-query mapping, and imported Generative AI snapshots.
opportunities:readPersisted opportunities, Priority, evidence, recommended actions, and the prioritized SEO plan.
targets:readDurable target plans, intended URLs, groups, status, imported research fields, and target-to-page alignment.
annotations:readActive manual notes, Google updates, and opportunity milestones from the timeline.
analytics:readBounded reports from the GA4 property already linked to the website.
technical_seo:readStored Technical SEO audits, findings, and comparisons. It cannot start audits.
opportunities:writeResolve, ignore, snooze, or reopen one opportunity at a time, without further approval.
targets:writeAdd a target keyword, assign its intended page, or change its priority, without further approval.
notes:writeCreate, update, archive, or restore manual notes directly, without further approval, and list archived notes.
annotations:writePlan manual note create, update, archive, or restore operations for same-user approval, check plan status, and list archived notes.

The complete paid catalog has 30 tools. A client sees only the subset covered by its approved scopes, and a tool that needs a second scope, such as get_page_query_mapping, appears only when both are approved. The MCP tool reference lists every tool with its scope and parameters.

Connect with https://mcp.crawlraven.com/mcp, complete browser OAuth, review the selected account and scopes, then begin with list_websites. Use the returned website_id for every site-specific tool. Existing connections are never widened silently; reconnect to add a newly available permission.

Build workflows that chain tools

Replace [your site] with the exact CrawlRaven site name or domain in the full-access prompts below.

WorkflowPrompt
Monthly search reviewFor [your site], compare the last 90 days with the preceding period, identify the returned pages and queries with the largest click losses, and check the timeline for nearby notes or Google updates.
Decay triageFind returned pages that lost clicks over 90 days, match them to current content-decay opportunities, and rank the resulting actions by Priority and current page traffic.
Page refresh researchFor [your site], list the queries attributed to exactly [page URL] from [start date] through [end date]. Combine them with the page's current public content, then propose refresh ideas grounded in the returned query evidence. Keep query evidence separate from content observations and state any truncation.
Planning coverageCompare targeted keywords with the bounded top-query corpus, then flag targets with no planned URL or no matching returned query. State the evidence boundary.
Search-to-outcome reviewCombine the last 28 days of Search Console movement with linked GA4 landing-page sessions and key events for the same complete-day period. Keep query evidence separate from page-level outcomes and report truncation.
Record a reviewed changeAfter reviewing the evidence, plan a concise manual timeline note for [date]. Show the exact values and approval link, and do not say it changed until I approve it in CrawlRaven and status confirms completion.
Audit follow-upCompare the latest finished Technical SEO audit for [your site] with the previous one, list new findings by severity with their suggested fixes, and separate fixed findings whose pages were not rechecked.
Target alignmentFor [your site], find target keywords whose intended page is not the page leading in clicks, then inspect each intended page's queries with page-query mapping.
Weekly backlogTurn the highest-priority active opportunities into a five-item implementation brief with the reason, evidence, affected page, and recommended action.

Browse more copyable examples for founders, SEO specialists, agencies, content teams, and developers in Prompts by role.

Choose windows and page only when needed

Tool groupDefaultMaximum and window
Query and Page lists25 rows100 rows per page; rolling 1–365 days or exact inclusive dates spanning at most 365 days.
Opportunities and Target Keywords25 rows100 rows per page; no reporting-window parameter.
Prioritized SEO plan25 rowsUp to 100 in one bounded ranked result; no cursor and no reporting window.
Target alignment and page-query mapping25 rows100 rows per page with a reporting window. A filtered page can be empty while next_cursor continues.
Technical SEO audits and findings25 rows100 rows per page; reads stored audits only.
Generative AI imports and pages10 imports; 50 pagesUp to 10 imports and 100 pages per page; dates follow the imported snapshot in Pacific Time.
Active annotations100 rows200 rows per page; choose 1 through 400 days.
Archived annotations25 rows100 rows per page; cursor-paginated and not time-bound.
Analytics summary28 complete daysRolling or exact windows up to 365 complete UTC days; one result with up to 365 daily points.
Analytics breakdown25 top rowsUp to 100 rows; no cursor, so inspect truncated and narrow the dimension or filters.
Annotation plan or statusOne resultPlans expire after 15 minutes; status lookup does not repeat a mutation.
WebsitesAll returnedUp to 100 websites; no cursor pagination.
Overview and daily search performance28 daysRolling 1–365 days or exact inclusive dates spanning at most 365 days.

When next_cursor is present, pass it back unchanged as cursor with the same site, window, search, exact page filter, and status. Changing that scope invalidates the cursor. Ask the agent to stop when the cursor is empty and to report any truncation rather than implying the source was exhaustive.

Know what full access still cannot do

  • It cannot change Search Console, Analytics properties, sites, billing, or administration; run exports; or call arbitrary API routes. Opportunity status, target keywords, and manual notes change only with the matching write permission.
  • It cannot refresh Opportunities, start Technical SEO audits, import Generative AI exports, or fetch arbitrary URLs, files, webhooks, or email.
  • Analytics tools read only the GA4 property already linked in CrawlRaven. They cannot connect or switch a property, expose credentials, or change Google configuration.
  • Manage manual notes directly changes manual notes without further approval. Propose annotation changes can only propose create, update, archive, or restore for manual notes, and the same authorizing user must approve every exact plan in CrawlRaven within 15 minutes.
  • Update, archive, and restore are version-checked; stale plans conflict. Create retries are idempotent within the documented 90-day retention window.
  • Derived and imported events are immutable. MCP can archive and restore manual notes but can never permanently delete one.
  • list_target_keywords returns the durable plan only. Use get_target_page_alignment for observed pages and mismatches.
  • Paid list_queries accepts an exact absolute HTTP(S) page URL and can combine it with query-text search. This extends the existing tool; it is not a separate page-query tool. Query and Page tools still do not expose the app’s country, device, or branded filters.

Tool results leave CrawlRaven for the connected client and model provider. Review their data policies, connect only clients you trust with Search Console, linked GA4, and CrawlRaven planning data, and revoke old connections from MCP connections. Grants expire after 90 days. If paid access lapses, the grant remains visible and revocable but returns no data until paid access is restored.

See the MCP server reference for exact parameters, client commands, OAuth behavior, and error recovery.