BrightLocal MCP Server and API by Cotlet
dev.cotlet/brightlocal · v1.0.2 · MCP 2026-07-28
BrightLocal local SEO management MCP server: list locations, get rank tracker report.
Reachability
error
checked 2026-11-21 05:43 UTC
Registry status active
Tools pinned 47
06a6dae332f3
Tools last changed
2026-11-20
Provenance
Registry namespace dev.cotlet
(domain verified by the official registry)
Remote endpoints
https://cotlet.dev/mcp/v1/brightlocal (streamable-http)
https://cotlet.dev/mcp/v1/brightlocal/connect (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-20 05:42 | tools changed | 0 added, 0 removed, 1 changed |
| 2026-11-19 05:40 | tools changed | 0 added, 0 removed, 1 changed |
| 2026-11-19 05:40 | unreachable | |
| 2026-11-18 05:41 | tools changed | 0 added, 0 removed, 16 changed |
| 2026-11-18 05:41 | back online | |
| 2026-11-17 05:38 | unreachable | |
| 2026-11-15 05:36 | first capture | 47 tools pinned |
| 2026-11-15 05:36 | back online | |
| 2026-11-15 05:36 | back online |
Pinned tool definitions (47)
| Tool | Description |
|---|---|
| cotlet_whoami | The Cotlet account this connection acts as: email, workspace, access status, the API key or OAuth client in use with its scope, the apps the workspace may call, its credit balance, and the app the user signed up for with its first task... |
| cotlet_apps | The apps of the user's workspace and whether each works now: the app account in the user's Cloud Browser (connected, signed out, signed in but not connected), and the one step the user has to take, with the console link. Free. Needs the... |
| cotlet_request_apps | Requests access to apps for the user's workspace, as Request access in the console: every app is granted at once. Not needed to work in an app: the user's AI works in any web app in their Web browser with cotlet_app_guide. An app with... |
| cotlet_get_call | Status of an earlier Cotlet call, by its call_id: pending (waits for the owner's approval in the Cotlet console), approved, running, success, rejected, expired, blocked or failed. For a call that answered with status pending or running. |
| cotlet_upload_file | Returns a one-time upload_url and a file_id for a local file (an image for a post, an attachment). The file is sent to upload_url with an HTTP PUT; an argument that takes a file accepts {"file_id": "..."}. Up to 25 MB, the URL takes one... |
| cotlet_report_issue | Sends a report to the Cotlet team: a tool that failed or returned wrong data, an error you could not get past, or a step the browser could not do, with the page, the step and what you saw. A missing dedicated tool is not a problem to... |
| cotlet_browser_open | Starts the user's BrightLocal Cloud Browser (a real Chrome on Cotlet, signed in to BrightLocal as the user; use it for what the BrightLocal tools do not cover) and opens `url`. Call it first. Only BrightLocal pages open. Answers the... |
| cotlet_browser_navigate | Opens `url` in the current tab, or goes `history` back or forward. Answers the page after it: the elements and text in view, with the same numbers. |
| cotlet_browser_read | The whole current page: its text (up to 20,000 characters) and a numbered list of its links, buttons, fields and other controls, open dialogs first. Use it on a new page or when a step's answer is not enough; `element` reads only inside... |
| cotlet_browser_find | Finds `text` on the whole current page, frames included: the elements whose label holds it, with their numbers, and each line of text that holds it. Use it instead of reading or scrolling a long page for one thing. |
| cotlet_browser_screenshot | A JPEG of the visible part of the page. Use it for boards, canvases, maps, charts and layout that the text does not show, then click or drag by `x`, `y` of the image. |
| cotlet_browser_scroll | Scrolls with the mouse wheel: `down` or `up` by `screens`, to `top` or `bottom`, until `element` is in view, or inside a panel or list (`inside`). Content that loads on scroll appears. Answers the page after it: the elements and text in... |
| cotlet_browser_click | Clicks element `element`, or point `x`, `y` of the screenshot; `double` double-clicks, `button: right` right-clicks. Answers the page after it: the elements and text in view, with the same numbers. Says when nothing changed. A link that... |
| cotlet_browser_hover | Rests the pointer on an element or a point, to open a hover menu, a tooltip or a preview. Answers the page after it: the elements and text in view, with the same numbers. |
| cotlet_browser_drag | Drags from one element or point to another: a card between columns, a piece on a board, a slider's handle. Answers the page after it: the elements and text in view, with the same numbers. |
| cotlet_browser_type | Types `text` into field `element`, replacing what it held; `submit` presses Enter after it. For several fields use fill_form. Without `element` the text goes where the focus is, as a person types after clicking: for spreadsheet cells... |
| cotlet_browser_fill_form | Fills several fields in one step: text fields take text, drop-downs an option's label, checkboxes, radios and switches true or false. Stops at the first field that fails and names those filled. Does not send the form: click its button... |
| cotlet_browser_select | Chooses `option` (its label as listed, or its value) in drop-down `element`. For a home-made drop-down, click it, then click the option. Answers the page after it: the elements and text in view, with the same numbers. |
| cotlet_browser_press | Presses a key on the focused element: Enter to send, Tab to the next field, Escape to close a pop-up, arrows in a list or slider, or one character (a site's shortcut). Answers the page after it: the elements and text in view, with the... |
| cotlet_browser_upload | Puts files into file field or upload button `element`: each file is {"url": "https://..."} or {"file_id": "..."} of a file uploaded to Cotlet; up to 10 files, 20 MB each. Answers the page after it: the elements and text in view, with... |
| cotlet_browser_download | Gets the file that clicking `element` (a download link or button) or opening `url` starts, also an image or PDF it only opens: answers its name, type, size and a link valid 15 minutes; CSV, JSON and other text files also as text. |
| cotlet_browser_evaluate | Runs a JavaScript function body on the page and answers what it returns, as JSON. Use it to extract data the page holds (a table, a list, attributes); act with the other tools. It cannot send requests, click, submit, or read cookies or... |
| cotlet_browser_wait | Waits until `text` shows on the page (at most `seconds`, default 5, up to 20), or just `seconds`: for results that load slowly. Says whether the text appeared. Answers the page after it: the elements and text in view, with the same numbers. |
| cotlet_browser_close | Ends the browser session when the task is done: the browser keeps its cookies and sleeps, and the per-minute charge stops. Answers the session's minutes and credits. |
| cotlet_app_guide | How to work in an app by clicking in the user's Cloud Browser with Cotlet's browser tools: which browser to use for this workspace and the sign-in link, the method step by step, the app's screens, menus and actions, notes, and the app's... |
| get_citation_tracker_report | Read a Citation Tracker report: where the business is listed, missing, or listed with wrong NAP data. Returns the top-site coverage and citation score, name, address, postcode and phone accuracy counts, the competitors' citation counts... |
| get_gbp_audit | Read a location's Google Business Profile Audit: profile data, NAP check, local ranking factors. Returns the audited Google Business Profile (name, address, phone, website, category, description, verified, rating, reviews, photos,... |
| get_local_search_grid_report | Read a location's Local Search Grid: the Google Maps rank at each grid point, and competitors. Returns the grid (size, points, distance, center), the average rank over all keywords, each keyword's latest run (average rank, points ranked... |
| get_location | Read one location's business details: name, address, phone, website, category, hours, descriptions. Returns the record BrightLocal compares citations and listings against (NAP): business name, address, phones, website, category, contact... |
| get_rank_tracker_report | Read a Rank Tracker report: each keyword's position on Google, Maps and the local pack, with changes. Returns one run of the report (the latest unless run_id is given) against the run before it: per keyword the search volume and, per... |
| get_review_summary | Read a location's star rating and review counts overall and per review site. Returns the average star rating and total reviews over all tracked sites, the count per star rating, and per site with a listing: its rating, total, new... |
| list_active_sync_alerts | List Active Sync alerts: changes found on a location's listings on other sites. Each alert is a field (name, address, phone, website, category, description) whose value on an external listing (Google Business Profile, Facebook, Bing,... |
| list_citation_builder_campaigns | List Citation Builder campaigns with their status, from Saved to Submitting To Sites and Complete. One row per campaign: location, status (Saved, Reviewing Data, On Hold, Submitting To Sites, Live Listing Checks, Complete), payment... |
| list_citation_tracker_reports | List Citation Tracker reports with their last run, live citations and competitor citations. One row per report: location, reference, schedule, last run, the number of live citations (found and indexed by Google) and of competitor... |
| list_local_search_grid_reports | List Local Search Grid reports: keywords, grid size and the average Google Maps rank across the grid. One row per report: location, keywords, schedule, last run, status, grid size and points, average rank over all keywords and its... |
| list_locations | List the locations in the account with their rank, citation and review metrics, as on All Locations. Returns each location with its location_id, name, reference, city, status (active or ad_hoc) and the metrics of the All Locations page:... |
| list_rank_tracker_reports | List Rank Tracker reports with their latest run and average Google position. One row per report: location, schedule (ad_hoc, weekly, monthly), date of the latest run, status, average Google position and its change, keywords and... |
| list_reviews | List a location's reviews from all tracked review sites, newest first, with rating, text and status. Returns reviews Reputation Manager collected for the location: date, star rating, reviewer, site, text, status (unread,... |
| rerun_report | Run one of a location's reports now, as the Re-run button does. Starts a manual run of the location's report of that type, as the Re-run button does. A manual run uses one of the account's ad-hoc run credits; a Local Search Grid run... |
| respond_to_review | Post a public reply to a review on Google or Facebook through BrightLocal. Publishes the text as the business's reply under the review on its site and marks the review Manually Responded. Only reviews with can_reply true in list_reviews... |
| update_rank_tracker_keywords | Add or remove keywords tracked by a location's Rank Tracker report. Changes the keyword list of the location's Rank Tracker report and saves the report with its other settings unchanged. Up to 100 keywords per report. Keywords already... |
| brightlocal_list_locations | List locations in the user's own BrightLocal account from ChatGPT, Claude or any AI agent. Returns how to do it in BrightLocal step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_*... |
| brightlocal_get_rank_tracker_report | Get rank tracker report in the user's own BrightLocal account from ChatGPT, Claude or any AI agent. Returns how to do it in BrightLocal step by step (screens, buttons, fields) and opens nothing by itself; then do it with the... |
| brightlocal_get_local_search_grid_report | Get local search grid report in the user's own BrightLocal account from ChatGPT, Claude or any AI agent. Returns how to do it in BrightLocal step by step (screens, buttons, fields) and opens nothing by itself; then do it with the... |
| brightlocal_list_reviews | List reviews in the user's own BrightLocal account from ChatGPT, Claude or any AI agent. Returns how to do it in BrightLocal step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_* tools... |
| brightlocal_update_rank_tracker_keywords | Update rank tracker keywords in the user's own BrightLocal account from ChatGPT, Claude or any AI agent. Returns how to do it in BrightLocal step by step (screens, buttons, fields) and opens nothing by itself; then do it with the... |
| brightlocal_re_run_report | Re-run report in the user's own BrightLocal account from ChatGPT, Claude or any AI agent. Returns how to do it in BrightLocal step by step (screens, buttons, fields) and opens nothing by itself; then do it with the cotlet_browser_*... |
Get alerted when this changes.
Email the moment dev.cotlet/brightlocal drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/dev.cotlet/brightlocal)
Maintain this server? Add the badge to your README. It links your users to this live status page.