Tool catalog

The MCP server exposes 89 tools. Which ones your agent can see depends on the permissions you granted when you authorized the client — a read-only grant hides every action tool. Read tools return data and are free; Action tools create, change, or run things and some spend tokens.

Cost legend

Free — no token cost. Per page / per check / per point — spends organization tokens exactly like the same action in the app; see Token usage. An agent can call get_token_balance first to check budget before running paid tools.

Identity & usage

Read-only. Use these so the agent can orient itself and check budget before spending.

Tool	Type	Cost	What it does
whoami	Read	Free	Returns the connected user and the organization the client is acting in.
get_token_balance	Read	Free	Current token balance for the organization.
get_entitlements	Read	Free	Which product features the organization’s plan has enabled.
get_token_transactions	Read	Free	Recent token debits and credits, for auditing spend.

Projects

Projects group searches and campaigns. Managing them requires the Project permission.

Tool	Type	Cost	What it does
list_projects	Read	Free	List projects in the organization.
get_project	Read	Free	Fetch one project by id.
create_project	Action	Free	Create a project.
update_project	Action	Free	Rename or edit a project.
delete_project	Action	Free	Delete a project.

Search

The flagship tools. Running a proxy search spends tokens; direct search only builds a URL and is free. Requires the Proxy search or Direct search permission and, for proxy search, the Search Engine Proxy feature.

Tool	Type	Cost	What it does
get_search_options	Read	Free	Valid values for country, language, device, engine, SafeSearch, and AI platforms.
get_schedule_options	Read	Free	Valid timezones, days, and cron format for campaign schedules.
run_proxy_search	Action	Per page	Run a localized Google/Bing search and scrape the result pages. Async — poll get_proxy_search.
get_proxy_search	Read	Free	Fetch a proxy search by id: status and, once complete, the parsed organic results and ads.
list_proxy_searches	Read	Free	List past proxy searches, newest first: query, location, status and page count — not the results.
run_direct_search	Action	Free	Build a localized search-engine URL and return it immediately (no scraping).
get_direct_search	Read	Free	Fetch a direct search by id.
list_direct_searches	Read	Free	List past direct searches, newest first, with their destination URL.

run_proxy_search is asynchronous

run_proxy_search returns immediately with a pending status and an id. The agent polls get_proxy_search with that id until the status is completed (or failed). Well-behaved clients do this automatically. Each requested page consumes one token.

Rank & ad tracking

Create and run position-tracker and ad-tracker campaigns. Reading and managing campaigns requires the Position tracker or Ad tracker permission; triggering a run spends tokens per keyword checked.

Tool	Type	Cost	What it does
list_position_campaigns	Read	Free	List position campaigns in the organization.
get_position_campaign	Read	Free	Fetch one position campaign’s configuration.
create_position_campaign	Action	Free	Create a SERP position-tracking campaign.
update_position_campaign	Action	Free	Edit a position campaign.
delete_position_campaign	Action	Free	Delete a position campaign.
trigger_position_run	Action	Per check	Run a position campaign now.
list_position_runs	Read	Free	List a campaign’s runs, newest first, with status and trigger (manual or scheduled).
get_position_run	Read	Free	Fetch a position run’s status and results.
get_position_results	Read	Free	Read captured rankings across a campaign.
get_position_overview	Read	Free	Campaign analytics: average position, the top domains with their 1/7/14/30-day change, a per-keyword summary and the daily trend.
get_position_keyword_analytics	Read	Free	One keyword’s ranking history: the domains ranking for it, their best/average position and change, and the daily positions.
get_position_alerts	Read	Free	Alerts raised: a tracked domain entering or leaving the top 10, or a significant position change.
list_ad_tracker_campaigns	Read	Free	List ad-tracker campaigns in the organization.
get_ad_tracker_campaign	Read	Free	Fetch one ad campaign’s configuration.
create_ad_tracker_campaign	Action	Free	Create an ad-tracking campaign.
update_ad_tracker_campaign	Action	Free	Edit an ad campaign.
delete_ad_tracker_campaign	Action	Free	Delete an ad campaign.
trigger_ad_tracker_run	Action	Per check	Run an ad campaign now.
list_ad_tracker_runs	Read	Free	List a campaign’s runs, newest first, with status and trigger (manual or scheduled).
get_ad_tracker_run	Read	Free	Fetch an ad run’s status and results.
get_ad_tracker_results	Read	Free	Read captured ad placements across a campaign.
get_ad_tracker_overview	Read	Free	Campaign analytics: ads captured, the top advertisers with their 1/7/14/30-day change, a per-keyword summary and the daily trend.
get_ad_tracker_keyword_analytics	Read	Free	One keyword’s ad history: the advertisers on it, their average position and change, the daily positions and the latest ad copy.
get_ad_tracker_alerts	Read	Free	Alerts raised: a domain starting or stopping advertising on the tracked keywords.

Analytics come back capped

get_position_overview and get_ad_tracker_overview return the 300 most recent daily trend rows and set trendTruncated when there were more. The keyword analytics tools return the top 50 domains (domainsTruncated) and the 300 most recent daily position rows (positionHistoryTruncated). Narrow the window with dateFrom / dateTo, or pass domains, to read past a cap.

Maps visibility

Track where a business ranks on the Google Maps canvas across a grid of coordinates, and how that compares to the local pack. Reading and managing campaigns requires the Maps permission.

A run spends one token per check, which for Maps is grid points × keywords, plus one per keyword for the local pack — a sum, not a product. A 9×9 grid on 5 keywords is 410 tokens. Every campaign summary returns tokensPerRun, so check it before running.

Tool	Type	Cost	What it does
list_maps_campaigns	Read	Free	List Maps campaigns, with cost per run.
get_maps_campaign	Read	Free	Fetch one campaign’s grid geometry and config.
get_maps_heatmap	Read	Free	Rank at every grid point, plus the Local Presence Score.
get_maps_competitors	Read	Free	Who holds the grid: points won, avg rank, sponsored.
create_maps_campaign	Action	Free	Create a geo-grid campaign.
update_maps_campaign	Action	Free	Edit a campaign’s grid, keywords or surfaces.
set_maps_campaign_status	Action	Free	Pause, resume or archive a campaign. Nothing is deleted.
delete_maps_campaign	Action	Free	Permanently delete a campaign with its runs and history.
run_maps_campaign	Action	Per point	Run a campaign now.
list_maps_runs	Read	Free	List a campaign’s runs — the run id the heatmap and competitor tools need.
get_maps_run	Read	Free	Fetch a run’s status; poll it after run_maps_campaign.
get_maps_trend	Read	Free	Local Presence Score, top-10 coverage and average rank for one keyword across recent runs.
get_maps_alerts	Read	Free	Alerts raised: entering or leaving the top 3 across the grid, or a big Local Presence Score change.
lookup_maps_place	Read	Free	Resolve a Google Maps link or place identifier into the trackedPlaceId to track.

Track by place id, not name

Ranking is measured against Google’s stable place id (fid). Businesses get renamed constantly, so a campaign without trackedPlaceId can silently lose its history. Set it when you can: lookup_maps_place reads a Google Maps link (a full address-bar URL or a Share short link), a Place ID (ChIJ…), a 0x…:0x… feature id or a numeric CID and returns the trackedPlaceId that create_maps_campaign and update_maps_campaign take. It cannot search by business name — paste the Maps link of the business. It’s free, and found comes back false when the input carries no place identity.

Marketplace visibility

Rank and price tracking on Amazon, Google Shopping and Walmart. Reading requires the Marketplace permission; managing campaigns requires it too. A run spends one token per check, which is keywords × targets (a target is one platform plus one storefront). Every campaign summary returns tokensPerRun, so check it before running. Per-listing rows are read with get_marketplace_results.

Tool	Type	Cost	What it does
list_marketplace_campaigns	Read	Free	List marketplace campaigns: targets, keywords, tracked products.
get_marketplace_campaign	Read	Free	Fetch one campaign’s config summary.
get_marketplace_overview	Read	Free	Where the tracked products stand now, per target and keyword.
get_marketplace_keyword_trend	Read	Free	Rank and price over time for one keyword on one target.
get_marketplace_competitors	Read	Free	Which listings hold the shelf against yours.
create_marketplace_campaign	Action	Free	Create a campaign.
update_marketplace_campaign	Action	Free	Edit a campaign’s targets, keywords or tracked products.
set_marketplace_campaign_status	Action	Free	Pause, resume or archive a campaign. Nothing is deleted.
delete_marketplace_campaign	Action	Free	Permanently delete a campaign with its runs and history.
run_marketplace_campaign	Action	Per check	Run a campaign now.
list_marketplace_runs	Read	Free	List a campaign’s runs, newest first, with their status.
get_marketplace_run	Read	Free	Fetch a run’s status; poll it after run_marketplace_campaign.
get_marketplace_results	Read	Free	The listings a campaign saw, best rank first: title, rank, price, rating, seller — pass runId to read one shelf.
get_marketplace_alerts	Read	Free	Alerts raised: a tracked product entering, leaving or moving in the top 10, and price changes on the shelf.
lookup_marketplace_product	Action	Free	Search one target live for a product and return candidate listings with the id to track.

Find the product id before you create a campaign

A campaign tracks products by the marketplace’s own id — an Amazon ASIN, or the platform’s own product id elsewhere. lookup_marketplace_product searches one target live by product name and returns up to 12 candidates with their externalId, ready to put in trackedProductIds of create_marketplace_campaign or update_marketplace_campaign. It spends no tokens and stores nothing, but it is rate limited to 20 lookups a minute. Ids differ between platforms and marketplaces, so run it once per target.

AI visibility

Track how often your brand is mentioned by AI answer engines (ChatGPT, Gemini, Perplexity, Google AI Overviews, Google AI Mode). Requires the AI visibility permission; triggering a run spends tokens per prompt checked.

Tool	Type	Cost	What it does
list_ai_visibility_campaigns	Read	Free	List AI-visibility campaigns in the organization.
get_ai_visibility_campaign	Read	Free	Fetch one campaign’s prompts, brands, and competitors.
create_ai_visibility_campaign	Action	Free	Create an AI-visibility campaign.
update_ai_visibility_campaign	Action	Free	Edit an AI-visibility campaign.
delete_ai_visibility_campaign	Action	Free	Delete an AI-visibility campaign.
trigger_ai_visibility_run	Action	Per check	Run an AI-visibility campaign now.
get_ai_visibility_run	Read	Free	Fetch an AI-visibility run’s status and metrics.
get_ai_visibility_results	Read	Free	Read brand mentions and sentiment across a campaign.
list_ai_visibility_runs	Read	Free	List a campaign’s runs, newest first, with checks run and failed.
get_ai_visibility_check	Read	Free	One check in full: the answer the platform gave, every brand mentioned, and the comparison analysis. The answer text is cut at 20,000 characters.
get_ai_visibility_overview	Read	Free	Headline analytics: visibility rate and trend, average position and sentiment, recommendation rate, share of voice, per-platform breakdown. Start here.
get_ai_visibility_trend	Read	Free	Where and when the brand is visible: by prompt, location and platform, each with its change and daily series.
get_ai_visibility_competitors	Read	Free	Who AI answers mention instead: share per domain, sentiment, head-to-head win rate and the attributes competitors are credited with.
get_ai_visibility_prompt_analytics	Read	Free	Per-prompt grid: listed or missing on each platform, average position, competitor count, last check.
get_ai_visibility_ads	Read	Free	Sponsored placements in AI answers: totals, ads per platform, which competitors advertise, and the prompts where they do and you do not.
get_ai_visibility_alerts	Read	Free	Alerts raised for the campaign: a significant visibility change, your ads starting or stopping, a competitor starting to advertise.
suggest_ai_visibility_prompts	Action	Free	Suggest prompts people might ask about a brand, or competitor domains, to seed a campaign. Generated text, not measured data.

Flexible data queries

Two read-only tools let the agent answer questions your canned tools don’t cover — “which keywords dropped the most last month?”, “how many searches did we run per country?” — by querying your own data directly.

Tool	Type	Cost	What it does
describe_schema	Read	Free	Lists the tables and columns the agent may query — scoped to the data you granted read on.
query_sql	Read	Free	Runs a single read-only SELECT (or WITH … SELECT) over your organization’s data.

How query_sql stays safe

query_sql runs as a non-owner database role inside a read-only transaction bound to your organization by row-level security. It cannot write, cannot reach other organizations’ data, cannot touch internal or sensitive tables, is capped to 100 rows, and times out quickly. It’s a safe analytical window onto your data — nothing more. See Permissions & security.

Related

Connect a clientSet up your MCP client.

Permissions & securityHow grants map to the tools above.

Token usageExactly what each paid action costs.