MCP tool reference
Choose the narrowest registered read tool that answers your question.
Start with project discovery, inspect available evidence, then ask for the concrete record or dataset you need. List tools are bounded; follow returned cursors instead of assuming the first page is complete.
Choose a reading path
| Your question | Start with |
|---|---|
| Which project can I analyze? | list_projects |
| What is known about this business? | get_project_business_context |
| Where is a specific saved record? | search, then fetch |
| What did an AI audit observe? | read_visibility_audit, then read_visibility_results |
| Which sources were used? | read_visibility_sources |
| What did the website crawl find? | read_site_health, then read_site_pages |
| Which connected reports exist? | read_integration_status |
| What does a performance window show? | read_performance, then read_performance_table |
| Which research dataset should I inspect? | read_search_intelligence, then read_search_dataset |
Read records and windows precisely
The generic search tool returns supported citeladder:// record references. Pass a returned reference to fetch to read that record. Arbitrary URLs, SQL and filesystem paths are not valid substitutes.
Keep the exact audit, dataset or date-window identity in your analysis. A query table and a page table do not automatically establish query–page evidence.
Preserve missing-data states
An unavailable result is not zero. A partial result is not complete. If a tool cannot return the requested scope, ask for the available inventory and explain the limitation.
The catalog below describes registered tools, not a guarantee that every dataset exists for your project.
Registered tools
The reference below is generated from the backend catalog. Your connected client’s catalog determines which tools are available on its server.
fetch
Fetch a full account-authorized record by a citeladder:// URI returned by search.
Parameters: id
get_project_business_context
Read the project profile, active prompt portfolio, Site Health, demand, opportunities, and latest visibility audit from persisted CiteLadder data.
Parameters: project_id, sections
list_projects
List a bounded page of projects visible to the connected CiteLadder account; follow next_cursor to enumerate the rest.
Parameters: cursor, limit
read_ai_referrals
Read the persisted AI-referral projection for a project: sessions referred by AI answer engines, their share of traffic, and the sources behind them. Pass start_date and end_date (ISO YYYY-MM-DD) for an explicit window.
Parameters: end_date, project_id, range, start_date
read_demand
Read the latest persisted demand snapshot, coverage, and comparison for a project.
Parameters: project_id
read_integration_status
Read which providers are connected to a project, which properties are mapped, how far the history import has progressed, and how far its coverage reaches. This is the read that explains why a projection is empty.
Parameters: project_id
read_opportunities
Read the highest-priority current opportunities and their persisted evidence references.
Parameters: cursor, limit, project_id, status
read_performance
Read the persisted Search Console/GA4 performance projection for a project: clicks, impressions, CTR, average position and their series for a range, with an optional comparison window. Ranges are day, week, month, 3_months, 6_months, last_synced, or custom with start_date and end_date (ISO YYYY-MM-DD).
Parameters: compare, compare_end_date, compare_start_date, end_date, granularity, project_id, range, start_date
read_performance_table
Read one paged breakdown of the persisted performance projection: query, page, country, device, search_appearance, day, bing_query or bing_page. Pass the snapshot_id a performance read returned, or a range (with start_date/end_date when the range is custom) to resolve it.
Parameters: compare_snapshot_id, cursor, dimension, end_date, page_size, project_id, range, snapshot_id, sort, start_date
read_prompt_portfolio
Enumerate the complete persisted prompt portfolio with stable pagination, cohort, status, and generation provenance.
Parameters: cohort, cursor, limit, project_id, prompt_set_id
read_query_evidence
Read an exact saved query/page/date window. Missing windows remain unavailable and never fall back to another range.
Parameters: cursor, limit, project_id, query, resolution_outcome, site_url_id, window_end, window_start
read_search_dataset
Read bounded rows from one published dataset using its dataset-specific persisted grain. Aggregate backlink datasets are never presented as backlink edges.
Parameters: cursor, dataset_id, direction, limit, project_id, sort
read_search_intelligence
Enumerate saved published Search Intelligence datasets, exact target/market scope, coverage, and acquisition status without acquiring data.
Parameters: project_id
read_site_health
Read the latest persisted Site Health score and coverage projection for a project.
Parameters: project_id
read_site_links
Read page-level internal-link metrics and bounded captured neighbours from one concrete crawl. Aggregate rows are not individual edges.
Parameters: crawl_id, cursor, limit, project_id, site_url_id
read_site_pages
Read bounded page facts, final analysis references, issues, coverage, and applicability from one persisted crawl.
Parameters: crawl_id, cursor, limit, page_kind, project_id, status
read_visibility_audit
Read the latest persisted AI visibility audit status, summary, and evidence reference.
Parameters: audit_id, completed_baseline, project_id
read_visibility_results
Read persisted answers, entity observations, citations, and query-fanout evidence for one concrete audit without rerunning a provider.
Parameters: audit_id, cohort, cursor, engine, limit, project_id, prompt_id
read_visibility_sources
Read owner-computed source usage and denominators for one audit, keeping citation occurrence separate from inspected publisher-page presence.
Parameters: audit_id, cohort, cursor, engine, level, limit, project_id
search
Search account-authorized projects, opportunities, and prompts. Returns stable record URIs that can be passed to fetch.
Parameters: limit, project_id, query