MCP tools

The signed-in account: name, credit balance, plan, monthly credits, the AI engines the plan can scan, how many businesses are used and allowed, whether this connection can start scans, and what scans cost in credits (per map scan by grid size, per AI answer, per Web Search page). Call this first, and before a large scan.

No parameters.

Every business in the account: id, name, category, address, website, phone, how many keywords are tracked, its latest finished map scan in one line, and a dashboard link. The business id is what the other tools take.

No parameters.

One business with its overview: details, what needs attention, its keywords with their latest results per platform, campaigns, review rating per site, listing watch status, the latest citation audit summary, and a dashboard link. The best single call for "how is this business doing".

Tracked keywords (the searches a business is tracked for), most recently scanned first, up to 100. Each has its platform, the latest and previous headline figure (ATRP for Google Maps where lower is better, mention rate for AI where higher is better, Google position for Web Search where lower is better), the change (positive means better), how many scans it has and a dashboard link. Filter by business and platform.

The finished scans of one tracked keyword in date order (oldest first), each with its headline figures: the trend of that keyword. Takes the keyword id from list_keywords. Returns the latest 20 scans unless limit is given (max 100).

Scans, newest first: id, business, keyword, platform, status, progress, dates, credits used, headline figures when finished, and a dashboard link. Filter by business, keyword, campaign, platform, status or a start date. Returns 20 unless limit is given (max 100). Use get_scan for one scan in full.

One scan in full: settings, status and progress (call again until status is completed), the headline figures, and by kind. Google Maps scan: ATRP, ARP, Local Visibility, the grid of ranks (rows north to south) and the top competitors. AI scan: mention rate, share of voice, average position, the businesses and websites the answers named, and per-town results or the grid. Web Search check: the position and page of the website and the results above it. Includes the previous scan of the same keyword for comparison and a dashboard link.

Campaigns (scheduled scans of several keywords, which can mix Google Maps, Web Search and AI engines): id, business, keywords, platforms, schedule, whether active, next and last run, last run status and the credits one run uses. The campaign id is what run_campaign takes.

A business' review profiles per review site (rating on a 5-star scale, review count, link, when last checked) and its most recent reviews (rating, text cut to about 600 characters, author, date, whether the owner replied). Filter reviews by site, a maximum rating (for example 3 to see the unhappy ones) and a start date. Returns 20 reviews unless limit is given (max 50).

A business' listings health: the latest citation audit (directories it is found on, missing, with a wrong name, address or phone, and where competitors are listed but the business is not), the Google listing watch (status, last check, recent changes to the Google profile) and the top backlink gaps.

Start a Google Maps geo-grid scan of a keyword for a business. Uses credits: one per grid point (a 7x7 grid is 49), charged as in the dashboard (get_account lists the costs). Without grid settings it uses the keyword's existing grid, else the grid sized to the business' competition, else 7x7. Returns the scan id, the credits used and left and a dashboard link; results are usually ready in 1-3 minutes: call get_scan with the id. Only run it when the user asked for a scan.

Ask AI engines a question customers ask (for example "who is the best plumber in Austin?") and see whether they recommend the business. One scan per engine. Uses credits: one per AI answer, charged as in the dashboard; get_account lists the engines the plan includes and the cost. Google AI Overviews and AI Mode are asked over a small grid around the business; ChatGPT, Gemini, Perplexity, Grok and Claude are asked several times about each town. Returns the scan ids, the credits used and left and a dashboard link; results are usually ready in 1-3 minutes: call get_scan with each id. Only run it when the user asked for a scan.

Check where the business' website ranks in Google's regular (organic) results for a keyword. Needs the business to have a website. Uses credits: one per page of 10 results read (5 for the default top 50, held up front; pages not needed are refunded when the check finishes). Without a location it uses the business' own town. Returns the scan id, the credits used and left and a dashboard link; results are usually ready in 1-3 minutes: call get_scan with the id. Only run it when the user asked for a check.

Run a campaign right now, outside its schedule: every keyword is scanned on Google Maps, and on the campaign's Web Search and AI engines too. Uses credits: the whole run is charged up front, as in the dashboard (list_campaigns shows credits_per_run); if the balance does not cover it, nothing starts. The schedule does not change. Returns the scan ids, the credits used and left and a dashboard link; results are usually ready in 1-3 minutes: call get_scan with each id. Only run it when the user asked for it.

Run an earlier scan again with the same settings (Google Maps, AI or Web Search), so the new scan joins the same keyword's history. Uses credits, the same as the first run (the scan's credits_used shows it). Returns the new scan id, the credits used and left and a dashboard link; results are usually ready in 1-3 minutes: call get_scan with the id. Only run it when the user asked for it.