Name: Convertlyft
Author: convertlyft

What this credential is, which workspace it reads, the scopes it holds, when it expires, and how many calls are left in the current windows; today’s paid-work limit in credits, the credit balance (owner or billing seat), new public scans left today, and which tools each missing scope blocks. Call this first when a tool refuses you — the answer usually names the fix.

Parameter	Type	Required	Notes
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Friction for a window: the pages people spend time on and scroll through, the rage clicks, the dead clicks (the tag’s own, minus the ones a link or a call answered — the Friction page’s count), and the form start-vs-submit funnel. Rows carry the same field names as cvl_dead_clicks, cvl_rage_clicks, cvl_page_attention and cvl_form_friction. Every collection is always present — an empty list means n

Parameter	Type	Required	Notes
window_handle	string	no	A handle from an earlier report, to ask about the identical window.
from	string	no	Start of the window, as a full ISO 8601 TIMESTAMP: 2026-01-01T00:00:00Z. A date alone means the start of that day, UTC. Omit for all time — which means all time, not today.
to	string	no	End of the window, same full-timestamp shape. Omit for now. A timestamp with a zone, like 2026-01-01T00:00:00Z; a day alone (2026-01-01) means the end of that day, UTC.
limit	number	no	Rows per list. Default 8, ceiling 200.
pages_cursor	string	no	counts.pages.next_cursor from the previous answer, for the pages after it.
rage_clicks_cursor	string	no	counts.rage_clicks.next_cursor from the previous answer.
dead_clicks_cursor	string	no	counts.dead_clicks.next_cursor from the previous answer.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Visitors, sessions, conversion rate, revenue by currency, median engaged time and site health for a window — the same figures, from the same code, as the dashboard header. Every figure is an object, never a bare number: read "state" first. When state is "ok" it carries "value", a rendered "display", and its own "previous" and "delta" so you never divide; when state is anything else there is NO "va

Parameter	Type	Required	Notes
window_handle	string	no	The handle from an earlier call in this chain. Present it and you get that call’s exact window and data_complete_through back. Takes precedence over from/to.
from	string	no	Start of the window, as a full ISO 8601 TIMESTAMP: 2026-01-01T00:00:00Z. A date alone (2026-01-01) means the start of that day, UTC. Omit for all time — which means all time, not today.
to	string	no	End of the window, same full-timestamp shape: 2026-01-10T23:59:59Z. A date alone means the end of that day, UTC. Omit for now.
source	string	no	Restrict to one utm_source a visit carried, e.g. google. A source no visit carried is refused with the ones that did; a channel such as paid is not a source.
campaign	string	no	Restrict to one campaign.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

The methodology behind one figure on the KPI header: its definition, the population it was computed over (denominator, numerator and row count), the filters in force, the condition that decides when it is withheld rather than shown, and the attribution epoch before which campaign-filtered counts are undercounted. It returns no figure value — call cvl_kpi for that, and present the same window.handl

Parameter	Type	Required	Notes
figure	string	no	One figure to explain: visitors, sessions, converted_sessions, conversion, revenue, engaged_time, crash_free_rate, lcp_p75_ms. Omit it and every figure on the header comes back.
verbose	boolean	no	true adds each figure’s definition, when it is withheld, and why a row count is missing — the same prose on every call, so it is left out by default.
window_handle	string	no	The handle from the cvl_kpi call whose figure you are asking about.
from	string	no	Start of the window, as a full ISO 8601 TIMESTAMP: 2026-01-01T00:00:00Z. A date alone (2026-01-01) means the start of that day, UTC. Omit for all time — which means all time, not today.
to	string	no	End of the window, same full-timestamp shape: 2026-01-10T23:59:59Z. A date alone means the end of that day, UTC. Omit for now.
source	string	no	Restrict to one utm_source a visit carried, e.g. google. A source no visit carried is refused with the ones that did; a channel such as paid is not a source.
campaign	string	no	Restrict to one campaign.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Submit the sentence you are about to say plus the receipt ids of the data you were given. Returns ok, or the exact span no receipt supports for the figure your sentence names, and a corrected sentence. A numeral is checked against the figure you NAME, so "Visitors were 41" is refused when visitors are 45 and 41 is the session count — a real number on the wrong figure is the failure this catches, n

Parameter	Type	Required	Notes
sentence	string	yes	The sentence you are about to say, verbatim — or the whole paragraph, checked a sentence at a time.
receipt_ids	array	yes	Every receipt whose figures the sentence draws on. A numeral passes if it is present in at least one of them UNDER THE FIGURE THE SENTENCE NAMES — so name the figure ("Visitors were 45", not "The numb
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Show exactly what cvl_change_apply would write, and the undo it would hand back, without writing anything. Nothing is queued and nothing is stored by this call. Returns the preview_token cvl_change_apply needs for this same change (valid 30 minutes).

Parameter	Type	Required	Notes
note	string	no	What you changed, in your own words. Optional.
marked_at	string	no	When the change went live, ISO 8601. Defaults to now. May not be in the future.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Record that the site changed, so the impact can be measured against it. Needs the preview_token from cvl_change_preview of the same note and marked_at: preview, show the person, apply only after they agree. Retry with the same idempotency_key and you get the same single marker back — never a second one. Returns the proposal id you undo with.

Parameter	Type	Required	Notes
idempotency_key	string	yes	Your own key for this change. Reuse it to retry safely; use a new one for a new change.
note	string	no	What you changed, in your own words. Optional.
marked_at	string	no	When the change went live, ISO 8601. Defaults to now. May not be in the future.
preview_token	string	yes	What cvl_change_preview returned for this same note and marked_at. Valid 30 minutes.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Remove a marker you wrote, using the undo computed when it was applied. Takes the proposal_id cvl_change_apply returned. Calling it twice is safe — the second call reports the same result and removes nothing.

Parameter	Type	Required	Notes
proposal_id	string	yes	The proposal_id cvl_change_apply returned.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Append one row to this workspace’s ledger so the next session does not derive it again. A finding MUST carry the receipt_id of the call it came from and the window it covers — a claim about the data with no receipt behind it is refused, by design. A decision, preference or question needs no receipt. You cannot delete anything here; only the owner can, from their settings.

Parameter	Type	Required	Notes
kind	string	yes	finding = a claim about the data, needs a receipt. decision = what was chosen. preference = how this owner wants things done. question = something you asked and nobody answered.
statement	string	yes	One sentence, in the words a person would read.
receipt_id	string	no	Required for a finding: the receipt_id returned by the call the finding came from.
from	string	no	ISO 8601 start of the window the finding covers. Omit for all time. A timestamp with a zone, like 2026-01-01T00:00:00Z; a day alone (2026-01-01) means the start of that day, UTC.
to	string	no	ISO 8601 end. Required for a finding. A timestamp with a zone, like 2026-01-01T00:00:00Z; a day alone (2026-01-01) means the end of that day, UTC.
window_from	string	no	Older name for from, still accepted.
window_to	string	no	Older name for to, still accepted.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Queue a fix for the OWNER to approve. This does not apply anything and cannot: approval is a human act on this product, and no credential can approve a proposal, including its own. baseline is what you saw before proposing and revert_plan is how to undo it — both are required, because a proposal that cannot be staleness-checked or undone is one an owner cannot safely accept. Proposing the same fix

Parameter	Type	Required	Notes
fix_identity	string	yes	Stable identity for this fix. Re-proposing the same identity supersedes the queued card.
title	string	yes	One line the owner reads on the card.
detail	object	no	What you propose to change. Free shape.
baseline		yes	The state you observed before proposing. Required.
revert_plan		yes	How to put it back. Required.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Queue today’s operator run for this workspace. It does NOT execute here — a worker claims the row and runs it, so this returns a run id and a status, never a report. If the workspace has already spent its daily cap the call is refused and names the cap and the spend; asking twice on one day attaches to the existing row rather than starting a second run.

Parameter	Type	Required	Notes
run_type	string	no	Which run to queue. Lowercase, letters/digits/underscore. Defaults to seo_daily.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Start a crawl of this workspace’s own site with the Convertlyft spider: every page’s status, title, description, headings, words and technical findings. A first-party crawler, not a paid provider; it uses the account’s credits, 1 per crawled page, so at most max_pages credits (dry_run: true says so and buys nothing; confirm_cost caps it). It starts immediately and runs for a few minutes; the SEO t

Parameter	Type	Required	Notes
max_pages	number	no	How many pages to crawl at most. Defaults to 100; the ceiling is 500.
dry_run	boolean	no	true: buy nothing; answer the estimated credits (at most) and what is left of today’s limit.
confirm_cost	integer	no	Run only if the estimate is at most this many credits; otherwise refuse and buy nothing.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Tell Convertlyft that the fix for one error is live on the site. Call it only once the change is deployed — not when it is written or merged. It starts the clock on "stayed fixed": once the affected pages have had enough page loads that the old rate would have produced at least 3 of these errors and none came, the error reads as stayed fixed. The earliest report wins; reporting again changes nothi

Parameter	Type	Required	Notes
ref	string	no	The short ref every brief prints, like CVL-Ea1b2c3d4. Send this or fingerprint.
fingerprint	string	no	The issue fingerprint, exactly as cvl_issues_list gave it. Send this or ref.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Start a crawl of any public website with the Convertlyft crawler and get a crawl_id straight away; the crawl runs for a few minutes. It uses the account’s credits: 1 per crawled page, charged when the crawl ends and never more than limit; the answer gives max_credits, the balance and the balance after the most it can cost. It obeys the site’s robots.txt, skips sign-in endpoints (/api/auth/*), neve

Parameter	Type	Required	Notes
url	string	yes	Where to start, like https://example.com. http or https only.
limit	integer	no	Most pages to fetch. Defaults to 100; the ceiling is 500.
depth	integer	no	How many links deep from the start page. Optional; 0 is the start page only.
mode	string	no	"full" (default) keeps each page’s text; "links" is the URL map only.
render	string	no	Load pages in a browser: "auto" (default) where the crawler sees a page needs it, "always", or "never".
webhook	string	no	Optional https URL we POST to once when the crawl finishes, signed with the webhook_secret this call returns.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Add searches to rank tracking in a market. Checks follow the market's existing schedule; plan limits apply. Idempotent.

Parameter	Type	Required	Notes
keywords	array	yes	One or more searches, at most 200, each at most 120 characters.
market	integer	no	Market as a location code (e.g. 2784 for the United Arab Emirates; location_code is accepted too). Omit for the primary market.
location_code	integer	no	Older name for market, still accepted.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Remove searches from rank tracking in a market. Idempotent.

Parameter	Type	Required	Notes
keywords	array	yes	One or more searches, at most 200, each at most 120 characters.
market	integer	no	Market as a location code (e.g. 2784 for the United Arab Emirates; location_code is accepted too). Omit for the primary market.
location_code	integer	no	Older name for market, still accepted.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Pin a competitor (always used), dismiss one (hidden 180 days, or until it shares twice as many money keywords), or clear the choice. An authority site cannot be pinned. Idempotent.

Parameter	Type	Required	Notes
domain	string	yes	—
state	string	yes	—
market	integer	no	Market as a location code (e.g. 2784 for the United Arab Emirates; location_code is accepted too). Omit for the primary market.
location_code	integer	no	Older name for market, still accepted.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Act on an opportunity by tracking its search. Idempotent.

Parameter	Type	Required	Notes
keyword	string	yes	The search, as typed.
market	integer	no	Market as a location code (e.g. 2784 for the United Arab Emirates; location_code is accepted too). Omit for the primary market.
location_code	integer	no	Older name for market, still accepted.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Mark a search as a money keyword (counts for competitors and opportunities) or not. The same call with the other value undoes it.

Parameter	Type	Required	Notes
keyword	string	yes	The search, as typed.
money	boolean	yes	—
market	integer	no	Market as a location code (e.g. 2784 for the United Arab Emirates; location_code is accepted too). Omit for the primary market.
location_code	integer	no	Older name for market, still accepted.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Say which page of the site targets a search. Answers the page it had before.

Parameter	Type	Required	Notes
keyword	string	yes	The search, as typed.
page_url	string	yes	Full address of the page. (pageUrl is accepted too.)
pageUrl	string	no	Older name for page_url, still accepted.
market	integer	no	Market as a location code (e.g. 2784 for the United Arab Emirates; location_code is accepted too). Omit for the primary market.
location_code	integer	no	Older name for market, still accepted.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Add searches to the keyword list, optionally for one page. Idempotent.

Parameter	Type	Required	Notes
keywords	array	yes	One or more searches, at most 200, each at most 120 characters.
page_url	string	no	Full address of the page. (pageUrl is accepted too.)
pageUrl	string	no	Older name for page_url, still accepted.
market	integer	no	Market as a location code (e.g. 2784 for the United Arab Emirates; location_code is accepted too). Omit for the primary market.
location_code	integer	no	Older name for market, still accepted.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Run the SEO chain again from the newest crawl (or from one step): keywords, competitors, opportunities and briefs. It buys search data with the account’s credits inside the daily limit, with no per-call confirmation, and starts at once; cvl_seo_flow follows it. A step that meets the limit waits for tomorrow. cvl_usage shows what was used. Estimated at most 3300 credits for each market per run, and

Parameter	Type	Required	Notes
from_step	string	no	Start from this step. (fromStep is accepted too.)
fromStep	string	no	Older name for from_step, still accepted.
dry_run	boolean	no	true: buy nothing; answer the estimated credits (at most) and what is left of today’s limit.
confirm_cost	integer	no	Run only if the estimate is at most this many credits; otherwise refuse and buy nothing.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Make the competitor page brief for one search: it reads the live top results, crawls the top pages and writes suggestions. It buys search data and a model pass with the account’s credits inside the daily limit, with no per-call confirmation. A brief made in the last 7 days is returned as it is unless force is true. cvl_seo_brief reads it. Estimated at most 330 credits per brief made (one live sear

Parameter	Type	Required	Notes
keyword	string	yes	The search, as typed.
market	integer	no	Market as a location code (e.g. 2784 for the United Arab Emirates; location_code is accepted too). Omit for the primary market.
location_code	integer	no	Older name for market, still accepted.
force	boolean	no	Make it again even when a brief from the last 7 days exists.
dry_run	boolean	no	true: buy nothing; answer the estimated credits (at most) and what is left of today’s limit.
confirm_cost	integer	no	Run only if the estimate is at most this many credits; otherwise refuse and buy nothing.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Start tracking this site in another market (country, language and device). The new market copies the primary market’s tracked searches and is checked weekly (Mondays, 02:00 UTC) with the account’s credits; the primary market does not change. Nothing is bought when it is added. dry_run: true answers the estimated credits a check and a month, and when the first check runs, without adding anything —

Parameter	Type	Required	Notes
location_code	integer	yes	The country as a location code (e.g. 2840 for the United States).
language_code	string	yes	The search language, e.g. en.
device	string	yes	—
dry_run	boolean	no	Answer the estimated credits and the first check date; add nothing.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Scan a public website for SEO problems with the Convertlyft crawler: up to 16 pages, robots.txt obeyed, no JavaScript run, nothing changed on the site. Waits up to about 45 seconds and returns the crawler's own summary: the score out of 100 with its four parts, how many critical issues, warnings and notes, the top 3 issues with up to 3 example pages each, the first fix, what this scan did not chec

Parameter	Type	Required	Notes
url	string	yes	The site to scan, like https://example.com or example.com. The scan starts at the home page.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

The result of a scan cvl_public_seo_scan started, by its scan_id. Same shape as that tool's answer; waits up to about 45 seconds if the scan is still running, then returns {status: "running", scan_id} again. Does not start a scan and does not count against the 5 scans a day. A scan_id stays readable for at least 24 hours (a finished scan of the same site is reused for 24 hours); the crawler may de

Parameter	Type	Required	Notes
scan_id	string	yes	The scan_id cvl_public_seo_scan returned.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

What the scan found about AI agents on a public site: its agent-readiness level (L0 unreachable to L4 agent-native) with what holds it there, each AI crawler or assistant robots.txt lets in or not and what our request in its name got, whether llms.txt exists, and report_url — the full view on convertlyft.com/agent-readiness. Reads the same crawl as cvl_public_seo_scan, never a second one: pass the

Parameter	Type	Required	Notes
url	string	no	The site, like https://example.com. Send this or scan_id.
scan_id	string	no	A scan_id from cvl_public_seo_scan. Send this or url.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Search Convertlyft’s public documentation for agents — https://convertlyft.com/llms.txt and https://convertlyft.com/llms-full.txt (the API, the MCP door, dates, limits, worked examples). Returns the best-matching sections, quoted, each with where it came from. Plain word matching, not a summary. No account needed; same per-address limits as the other public tools.

Parameter	Type	Required	Notes
query	string	yes	What to look for, like "rate limit" or "connect Claude".
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

The live first page of Google results for one search in one country: position, address, domain and title of each organic result, the "People also ask" questions, and every other block the page held — ads, AI overview, map pack, video and the rest — as features, typed by the provider. Ads and other blocks take places, so the first page can hold fewer than 10 organic results; organic_note says so. E

Parameter	Type	Required	Notes
keyword	string	yes	One search, as typed.
location_code	integer	no	Country as a location code (e.g. 2784 for the United Arab Emirates). Omit for this site’s primary market, or the United States (2840) when none is set.
language_code	string	no	Language, like en. Omit for the market’s own.
device	string	no	Default: the device this site’s rank tracking uses, else desktop. The answer’s question.device says which.
refresh	boolean	no	Buy a fresh answer instead of reading the stored one. Default false: the same question asked again is read back without using credits.
dry_run	boolean	no	true: buy nothing; answer the estimated credits (at most) and what is left of today’s limit.
confirm_cost	integer	no	Run only if the estimate is at most this many credits; otherwise refuse and buy nothing.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Searches around one seed: ideas in the same topic (mode ideas, the default), searches that contain the seed (suggestions), or what Google lists beside it (related) — each with monthly volume, difficulty, cost per click and intent as the provider estimates them. Each answer bought uses the account’s credits, inside this site’s daily limit, with no per-call confirmation. The answer is stored, so ask

Parameter	Type	Required	Notes
keyword	string	yes	One search, as typed.
mode	string	no	—
limit	integer	no	Rows at most. Default 50.
location_code	integer	no	Country as a location code (e.g. 2784 for the United Arab Emirates). Omit for this site’s primary market, or the United States (2840) when none is set.
language_code	string	no	Language, like en. Omit for the market’s own.
refresh	boolean	no	Buy a fresh answer instead of reading the stored one. Default false: the same question asked again is read back without using credits.
dry_run	boolean	no	true: buy nothing; answer the estimated credits (at most) and what is left of today’s limit.
confirm_cost	integer	no	Run only if the estimate is at most this many credits; otherwise refuse and buy nothing.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

For searches you name: monthly volume, difficulty, intent and the last 12 months of volume, as the provider estimates them. Each answer bought uses the account’s credits, inside this site’s daily limit, with no per-call confirmation. The answer is stored, so asking the same question again uses no credits (refresh: true buys again). cvl_usage shows what was used. Estimated at most 450 credits per a

Parameter	Type	Required	Notes
keywords	array	yes	One or more searches, at most 200, each at most 120 characters.
location_code	integer	no	Country as a location code (e.g. 2784 for the United Arab Emirates). Omit for this site’s primary market, or the United States (2840) when none is set.
language_code	string	no	Language, like en. Omit for the market’s own.
refresh	boolean	no	Buy a fresh answer instead of reading the stored one. Default false: the same question asked again is read back without using credits.
dry_run	boolean	no	true: buy nothing; answer the estimated credits (at most) and what is left of today’s limit.
confirm_cost	integer	no	Run only if the estimate is at most this many credits; otherwise refuse and buy nothing.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Any site’s organic footprint in one country: how many searches it ranks for, how many of those in the top 3, and the provider’s estimate of its monthly search traffic. Each answer bought uses the account’s credits, inside this site’s daily limit, with no per-call confirmation. The answer is stored, so asking the same question again uses no credits (refresh: true buys again). cvl_usage shows what w

Parameter	Type	Required	Notes
domain	string	yes	A site’s bare hostname, like example.com. Any site, not only this workspace’s.
location_code	integer	no	Country as a location code (e.g. 2784 for the United Arab Emirates). Omit for this site’s primary market, or the United States (2840) when none is set.
language_code	string	no	Language, like en. Omit for the market’s own.
refresh	boolean	no	Buy a fresh answer instead of reading the stored one. Default false: the same question asked again is read back without using credits.
dry_run	boolean	no	true: buy nothing; answer the estimated credits (at most) and what is left of today’s limit.
confirm_cost	integer	no	Run only if the estimate is at most this many credits; otherwise refuse and buy nothing.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

The searches one competitor ranks for that the site does not, best competitor positions first, with monthly volume and the competitor’s ranking page. Each answer bought uses the account’s credits, inside this site’s daily limit, with no per-call confirmation. The answer is stored, so asking the same question again uses no credits (refresh: true buys again). cvl_usage shows what was used. Estimated

Parameter	Type	Required	Notes
domain	string	yes	A site’s bare hostname, like example.com. Any site, not only this workspace’s.
competitor	string	yes	The competitor’s bare hostname.
limit	integer	no	Rows at most. Default 50.
location_code	integer	no	Country as a location code (e.g. 2784 for the United Arab Emirates). Omit for this site’s primary market, or the United States (2840) when none is set.
language_code	string	no	Language, like en. Omit for the market’s own.
refresh	boolean	no	Buy a fresh answer instead of reading the stored one. Default false: the same question asked again is read back without using credits.
dry_run	boolean	no	true: buy nothing; answer the estimated credits (at most) and what is left of today’s limit.
confirm_cost	integer	no	Run only if the estimate is at most this many credits; otherwise refuse and buy nothing.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Any site’s backlink headline counts from the provider’s link index: referring domains, backlinks, broken backlinks, referring pages and when it was first seen. Each answer bought uses the account’s credits, inside this site’s daily limit, with no per-call confirmation. The answer is stored, so asking the same question again uses no credits (refresh: true buys again). cvl_usage shows what was used.

Parameter	Type	Required	Notes
domain	string	yes	A site’s bare hostname, like example.com. Any site, not only this workspace’s.
refresh	boolean	no	Buy a fresh answer instead of reading the stored one. Default false: the same question asked again is read back without using credits.
dry_run	boolean	no	true: buy nothing; answer the estimated credits (at most) and what is left of today’s limit.
confirm_cost	integer	no	Run only if the estimate is at most this many credits; otherwise refuse and buy nothing.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Referring domains that link to one or more of the named competitors and not to the site, with which competitors each links to, its spam score and rank. Each answer bought uses the account’s credits, inside this site’s daily limit, with no per-call confirmation. The answer is stored, so asking the same question again uses no credits (refresh: true buys again). cvl_usage shows what was used. Estimat

Parameter	Type	Required	Notes
domain	string	yes	A site’s bare hostname, like example.com. Any site, not only this workspace’s.
competitors	array	yes	Up to 20 competitor hostnames.
limit	integer	no	Rows at most. Default 50.
refresh	boolean	no	Buy a fresh answer instead of reading the stored one. Default false: the same question asked again is read back without using credits.
dry_run	boolean	no	true: buy nothing; answer the estimated credits (at most) and what is left of today’s limit.
confirm_cost	integer	no	Run only if the estimate is at most this many credits; otherwise refuse and buy nothing.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Whether AI assistants name a site: answers from the provider’s tracked panel of prompts, each with the platform, the question, whether the site was mentioned and an excerpt. A sample of tracked answers, not every answer an assistant gives. Each answer bought uses the account’s credits, inside this site’s daily limit, with no per-call confirmation. The answer is stored, so asking the same question

Parameter	Type	Required	Notes
domain	string	yes	A site’s bare hostname, like example.com. Any site, not only this workspace’s.
limit	integer	no	Answers at most. Default 25.
refresh	boolean	no	Buy a fresh answer instead of reading the stored one. Default false: the same question asked again is read back without using credits.
dry_run	boolean	no	true: buy nothing; answer the estimated credits (at most) and what is left of today’s limit.
confirm_cost	integer	no	Run only if the estimate is at most this many credits; otherwise refuse and buy nothing.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Find a Convertlyft tool that is not in your tool list, and the skills (step-by-step playbooks) that fit. Your list holds a core set; behaviour, SEO, errors, site and workspace reads are here. Answers name, title and one line per tool; schema:true adds the input schema. Run a read it finds with cvl_call_read. Writes are always in your list already: call them directly.

Parameter	Type	Required	Notes
query	string	yes	Words for what you want to know, like "rage clicks on a page" or "keyword rankings". A tool name works too.
limit	integer	no	How many tools to return, at most 10. Default 5.
schema	boolean	no	true adds each tool’s full inputSchema, scopes and labels. Default false: name, title and one line.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Run a Convertlyft READ tool that is not in your tool list, by name, with its arguments. It answers exactly as calling that tool directly would, with the same permissions. It refuses every write or spend tool: those are in your list and are called directly. Use cvl_search_tools to find the name and arguments.

Parameter	Type	Required	Notes
name	string	yes	The read tool to run, as cvl_search_tools named it.
arguments	object	no	Its arguments, as its inputSchema describes them.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

The Convertlyft skills: step-by-step playbooks for jobs like finding where people get stuck, fixing errors, auditing SEO or diagnosing a drop. Each has a name and when to use it; cvl_skill_read opens one.

Parameter	Type	Required	Notes
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

One Convertlyft skill, in full: its SKILL.md, or one of its reference files when the skill points to one. cvl_skills_list names them.

Parameter	Type	Required	Notes
name	string	yes	The skill, as cvl_skills_list names it, like "finding-ux-friction".
file	string	no	A reference file the skill names, like "references/page-analysis.md". Default SKILL.md.
fields	array	no	Top-level keys to keep, e.g. ["kpis"] — envelope keys, not metric names. See the server instructions.

Where are you running it?

Tool surface

Release history

Convertlyft MCP

What it does

Quickstart

Where are you running it?

Tool surface

What counts against your monthly calls

Release history

See also