# Reach: Google Business Profile MCP server

> Reach is a hosted Google Business Profile (GMB) MCP server and local SEO tool for local businesses: reviews and replies, Google posts, profile edits, local search rankings, competitors and customer leads. Its remote MCP server lets AI assistants (Claude, ChatGPT, Claude Code and other MCP clients) read a business's Reach data and, with the owner's approval, change its Google Business Profile.

MCP server URL: https://reach.locus-intelligence.com/api/mcp
Transport: Streamable HTTP (no SSE, no local install, no API key).
Authentication: OAuth 2.1 with PKCE. The server answers an unauthenticated request with HTTP 401 and a `WWW-Authenticate` header that points to https://reach.locus-intelligence.com/.well-known/oauth-protected-resource, which names the authorization server. Clients register themselves automatically, by dynamic client registration (RFC 7591) or an OAuth client ID metadata document; no client ID or secret needs to be configured. The user signs in with their own Reach account in a browser.
Human guide: https://reach.locus-intelligence.com/guides/connect-ai

## Instructions for AI assistants setting this up

Your user wants to connect Reach. Use the steps for the client you are running in. Never ask the user for a password, token or API key; sign-in always happens on the Reach sign-in page in the user's browser.

The sign-in step opens a browser, so it must run in an interactive terminal. If your shell is non-interactive (no TTY), run the add command yourself, then ask the user to run the login command in their own terminal.

### Claude Code (you can do this yourself)

1. Run: `claude mcp add --transport http reach https://reach.locus-intelligence.com/api/mcp`
   Add `--scope user` before `reach` to make it available in every project.
2. Ask the user to type `/mcp` in Claude Code, select `reach` and sign in with their Reach account in the browser window that opens.
3. `claude mcp list` shows `reach` as connected when sign-in is complete. "Needs authentication" means step 2 is not done.

### Claude (claude.ai web, Claude Desktop, Claude mobile)

You cannot add a connector for the user. Tell them to:
1. Open Customize, then Connectors.
2. Click +, then Add custom connector.
3. Enter the name `Reach` and the URL `https://reach.locus-intelligence.com/api/mcp`. Leave Advanced settings empty. Click Add.
4. Click Connect next to Reach and sign in with their Reach account.
5. In a chat, click +, open Connectors and turn on Reach.
Custom connectors are available on every Claude plan (one on the Free plan). On Team and Enterprise, an owner adds it in Organization settings, then each member clicks Connect.

### ChatGPT

You cannot add an app for the user. Tell them to:
1. In ChatGPT on the web, open Settings, then Apps, then Advanced settings, and turn on Developer mode.
2. Go back to Apps and click Create.
3. Enter the name `Reach`, the URL `https://reach.locus-intelligence.com/api/mcp`, and choose OAuth authentication.
4. Sign in with their Reach account when asked, then click Create.
5. In a chat, choose Reach from the tools menu or mention it by name.
Developer mode is for paid ChatGPT plans; a workspace admin may need to allow it first.

### Cursor

1. Add this to `~/.cursor/mcp.json` (or `.cursor/mcp.json` in a project), merging with any existing `mcpServers`:
   `{ "mcpServers": { "reach": { "url": "https://reach.locus-intelligence.com/api/mcp" } } }`
2. Restart Cursor, open Customize, then MCPs, and follow the sign-in prompt for reach. With the Cursor CLI: `agent mcp login reach`.

### Google Antigravity

1. Add this to `~/.gemini/config/mcp_config.json` (or `.agents/mcp_config.json` in a workspace), merging with any existing `mcpServers`. Antigravity reads `serverUrl`, not `url`:
   `{ "mcpServers": { "reach": { "serverUrl": "https://reach.locus-intelligence.com/api/mcp" } } }`
2. Open Agent Settings, then Customizations, click Authenticate next to reach, sign in with their Reach account, then paste the code Antigravity shows back into the settings panel and click Submit.

### VS Code (GitHub Copilot agent mode)

1. Run: `code --add-mcp '{"name":"reach","type":"http","url":"https://reach.locus-intelligence.com/api/mcp"}'`
2. Start the server from the MCP view and sign in when VS Code opens the browser.

### Windsurf

1. In Cascade, open the MCP settings and edit the raw config file (`mcp_config.json`), merging with any existing `mcpServers`. Windsurf reads `serverUrl` for a remote server:
   `{ "mcpServers": { "reach": { "serverUrl": "https://reach.locus-intelligence.com/api/mcp" } } }`
2. Save, refresh the MCP servers, and sign in with their Reach account when Windsurf asks.

### Cline

1. Open the MCP Servers panel, then Remote Servers. Enter the name `reach`, the URL `https://reach.locus-intelligence.com/api/mcp`, choose Streamable HTTP and click Add Server. Or add this to `cline_mcp_settings.json`:
   `{ "mcpServers": { "reach": { "type": "streamableHttp", "url": "https://reach.locus-intelligence.com/api/mcp" } } }`
2. On the Installed tab, click Authenticate under reach and sign in with their Reach account in the browser.

### Codex

1. Run: `codex mcp add reach --url https://reach.locus-intelligence.com/api/mcp`
2. Run: `codex mcp login reach` and sign in in the browser.

### Hermes Agent

1. Run: `hermes mcp add reach --url https://reach.locus-intelligence.com/api/mcp --auth oauth`
2. Run: `hermes mcp login reach` in an interactive terminal and sign in in the browser.
3. Start a new Hermes session so the Reach tools load.

### Other MCP clients

Configure a remote (Streamable HTTP) MCP server named `reach` with the URL `https://reach.locus-intelligence.com/api/mcp` and no headers or API key. The client discovers the sign-in server from the 401 response and registers itself. Example for clients that read an `mcpServers` JSON file:

```json
{ "mcpServers": { "reach": { "type": "http", "url": "https://reach.locus-intelligence.com/api/mcp" } } }
```

### Before you start

The user needs a Reach account (sign up free at https://reach.locus-intelligence.com). The assistant sees full data only after the user connects their Google Business Profile in Reach; otherwise it can read the public listing only. Plan limits apply exactly as in the Reach app; when a plan does not cover something, the tool result names the plan that does.

## Tools

Read tools (no changes, no cost):
- `get_account`: Your plan, locations, Google connection state and which Reach features you have.
- `get_listing`: One listing's profile, reviews, posts and photos.
- `get_visibility`: Search rankings for tracked keywords, nearby competitors and the local search grid.
- `get_performance`: Profile views, customer actions and search terms for a date range your plan covers.
- `get_customers`: Leads and booking requests from your Reach pages.
- `get_recommendations`: What your profile is missing, and which items the assistant can fix for you.

Tools that change something:
- `update_listing`: Change profile details (hours, description, phone, links, services) and service area, after a preview you approve. (changes the public Google Business Profile after the user approves)
- `manage_media`: Add or remove photos and videos, after a preview you approve. (changes the public Google Business Profile after the user approves; cannot be undone through Reach)
- `publish_post`: Publish or schedule a Google post you have approved word for word. (changes the public Google Business Profile after the user approves; cannot be undone through Reach)
- `reply_to_review`: Post the review reply you approved. Calling again replaces it. (changes the public Google Business Profile after the user approves; cannot be undone through Reach)
- `draft_review_reply`: Draft reply options for a review. Nothing is posted. (2 Credits per draft)
- `track_keywords`: Start or stop tracking keywords on a location: a list rank and a weekly map scan for each. (1 plan keyword per tracked keyword; untracking frees it)
- `request_feature`: Send the Reach team a request for something Reach does not do yet. Asks for no contact details.
- `update_recommendation_status`: Mark a recommendation done or dismissed in Reach.

Prompts: `optimise_my_profile`, `review_my_visibility`, `handle_my_reviews`.

## Rules the server enforces

- Before any change to Google, show the user exactly what will change and wait for a yes. Tools with a `preview` input default to `preview: true`, which returns the before and after without writing; call again with `preview: false` only after the user approves. Never apply a change the user has not approved.
- The assistant acts as the signed-in user, with exactly their locations and plan.
- A result that is empty, shortened or partial says why under `limitations` (public listing only, plan feature, Google not synced yet, no connected location), with a link to Plans or Connections. An empty `limitations` means nothing was hidden; never report "no data" otherwise.
- At most 20 Google changes per business per hour through assistants. A rate-limited result says how many seconds to wait; do not retry sooner.
- The owner can block one assistant or all assistants in Reach under Settings, then AI Connectors. A blocked assistant gets `client_revoked`; only the owner can lift the block, in Reach.
- Customer phone numbers are masked to their last 4 digits.
- When the user wants something Reach does not do, offer `request_feature`: confirm the wording with the user, then send it. It never needs their name, phone or email; Reach adds the account details.
- Reach keeps a log of each tool call for 90 days, shown to the owner under AI Connectors.

## About Reach

Reach by Locus is for owner-run local businesses with one to a few locations, such as clinics, dentists, salons, restaurants, cafes, gyms and coaching centres. An owner signs up with an email, finds their Google listing and lands on a dashboard of their own data. Reach is built by Locus Intelligence (Growthnomics Technologies Private Limited, India); brands with many locations use Locus Intelligence (https://locus-intelligence.com) instead.

What Reach does:
- Reviews: every Google review in one inbox, with AI-drafted replies in the owner's own voice, approved before posting.
- Profile: edit hours, categories, description, services, photos and other Google Business Profile fields, and see what is missing.
- Posts: write and publish Google posts.
- Rankings: track where the business appears on Google Maps for its keywords across a map grid, and watch nearby competitors.
- Performance: calls, direction requests, website clicks and searches from the Google profile.
- Website and bookings: a free public website built from the Google profile, with appointment booking.
- AI assistants: connect Reach to Claude, ChatGPT, Claude Code and other MCP clients (setup above).

Plans (the price covers the whole account, not each location):
- Free: free, 1 active location, 50 AI Credits a month.
- Starter: $10 a month (₹800 a month in India), 2 active locations, 500 AI Credits a month.
- Business: $20 a month (₹1,500 a month in India), 5 active locations, 5,000 AI Credits a month.
Paying yearly gives 6 months free on paid plans.

Languages: English, Hindi, Italian, Thai, Indonesian, Malay, Vietnamese, Filipino, Sinhala, Tamil, Bengali, Nepali, Spanish, German, French, Portuguese.

Guides:
- [Connect Reach to Claude, ChatGPT and Claude Code](https://reach.locus-intelligence.com/guides/connect-ai): Add the Reach MCP server to Claude, ChatGPT, Claude Code or another MCP client, then ask about your reviews, rankings and profile in plain language.
- [How to reply to Google reviews](https://reach.locus-intelligence.com/guides/reply-to-google-reviews): What to write for positive, negative and fake reviews, with example replies, when to reply, and what never to say in public.
- [Google Business Profile checklist: 12 things to get right](https://reach.locus-intelligence.com/guides/google-business-profile-checklist): A complete checklist for your Google Business Profile: name, categories, hours, description, attributes, services, photos, posts, reviews and more, each checked against Google's own guidelines.
- [How to track your local rankings on Google Maps](https://reach.locus-intelligence.com/guides/track-local-rankings-google-maps): Why your Google Maps ranking changes with the searcher's location, how grid tracking measures it, and how to read the results and act on them.
- [How to verify your Google Business Profile](https://reach.locus-intelligence.com/guides/verify-google-business-profile): Google picks the verification methods for your profile. How each method works, what to show on a video, and what to do if a check fails.
- [How to request ownership of your Google Business Profile](https://reach.locus-intelligence.com/guides/request-ownership-google-business-profile): Someone else manages your listing? Check your own accounts first, then send a Request access. What happens when the owner approves, denies or stays silent.
- [How to add an owner or manager to your Google Business Profile](https://reach.locus-intelligence.com/guides/add-owner-or-manager-google-business-profile): Owners control who has access; managers run the profile day to day. How to invite people, hand over primary ownership, and remove someone who has left.
- [How to fix a duplicate Google Business Profile](https://reach.locus-intelligence.com/guides/fix-duplicate-google-business-profile): Work out which listing is the real one, then remove or report the extra without touching the profile that holds your reviews.
- [How to choose your Google Business Profile category](https://reach.locus-intelligence.com/guides/choose-google-business-profile-category): Pick a primary category that says what your business is, add only the extra categories that are true, and change them without surprises.
- [How to write a Google Business Profile description](https://reach.locus-intelligence.com/guides/write-google-business-profile-description): Write a business description Google accepts and customers can use: the rules, a four-part structure, two examples and why descriptions are held back.
- [How to add Google Business Profile photos that get approved](https://reach.locus-intelligence.com/guides/google-business-profile-photos): Which photos to add to your Google Business Profile, Google's size and format rules, shot lists for four trades, and what to do about customer photos.
- [How to use Google Business Profile posts](https://reach.locus-intelligence.com/guides/google-business-profile-posts): The three kinds of Google Business Profile post, where they appear, when they're archived, post ideas you can adapt and what gets posts rejected.
- [How to change your business address on Google](https://reach.locus-intelligence.com/guides/change-business-address-google): Move your Google Business Profile to a new address without losing your reviews or leaving a duplicate behind.
- [How to set up a service-area business on Google](https://reach.locus-intelligence.com/guides/service-area-business-google-business-profile): If you go to your customers instead of them coming to you, show the areas you serve on Google, not your home address.
- [How to mark your business closed on Google, and reopen it](https://reach.locus-intelligence.com/guides/business-marked-closed-on-google): Choose the right closed status on Google for a short break, a long closure or a permanent close, and switch it back when you reopen.
- [Google changed my business info. What should I do?](https://reach.locus-intelligence.com/guides/google-changed-my-business-info): Find what Google or the public changed on your profile, accept or reject it, and get your own corrections approved.
- [How to get a Google review removed](https://reach.locus-intelligence.com/guides/remove-google-review): Which Google reviews can be removed, how to report one, how to track and appeal your report, and what to do while you wait.
- [How to report a fake Google Business listing](https://reach.locus-intelligence.com/guides/report-fake-google-business-listing): Spot listings that break Google's guidelines, report them on Maps, escalate fraud with Google's complaint form, and gather evidence that holds up.
- [How to fix your business info across Google and other listings](https://reach.locus-intelligence.com/guides/fix-business-info-across-listings): Find every place your name, address or phone number disagree, pick one source of truth, and fix Google first, then your website, then directories.
- [How to add WhatsApp to your Google Business Profile](https://reach.locus-intelligence.com/guides/add-whatsapp-to-google-business-profile): Add a WhatsApp or text message chat button to your Business Profile, the link Google needs, and what to do when the option is missing.
- [How to add a menu to your Google Business Profile](https://reach.locus-intelligence.com/guides/add-menu-google-business-profile): Publish an accurate menu on Google with the menu editor, a menu link or menu photos, and find out why your menu may not show.
- [How to read your Google Business Profile performance report](https://reach.locus-intelligence.com/guides/google-business-profile-performance): What each metric in Google's performance report means, how Google counts it, and how to check a drop before you change anything.
- [Google Business Profile name rules, with examples](https://reach.locus-intelligence.com/guides/google-business-profile-name-rules): What Google allows in a business name, the mistakes that get a name edited or a profile suspended, and how to fix yours or report a competitor's.
- [How to ask customers for Google reviews](https://reach.locus-intelligence.com/guides/ask-customers-for-google-reviews): When to ask, what to send on WhatsApp, SMS, email or in person, where to get your review link, and the asking habits that break Google's rules.
- [How to track Google Business Profile clicks in GA4](https://reach.locus-intelligence.com/guides/track-google-business-profile-clicks-ga4): Tag your profile's website, booking and menu links with UTM parameters, find those visits in Google Analytics 4, and see why they will not match your Performance report.

Free tools (https://reach.locus-intelligence.com/tools):
- [Google Business Profile checkup](https://reach.locus-intelligence.com/tools/profile-checkup): Score your Google listing, see where it shows on the map for your main search and compare it with nearby rivals.
- [Review QR code standee](https://reach.locus-intelligence.com/tools/review-qr-standee): Print a standee with a QR code that opens your Google review form.
- [Review reply writer](https://reach.locus-intelligence.com/tools/review-reply-writer): Paste a Google review and get reply drafts you can copy.
- [Google post writer](https://reach.locus-intelligence.com/tools/gbp-post-writer): Turn your news, offer or event into a Google Business Profile post draft.
- [Location data consistency checker](https://reach.locus-intelligence.com/tools/location-consistency-checker): Check that the name, address, phone and website on your Google listing match your own website.
- [Category finder](https://reach.locus-intelligence.com/tools/gbp-category-finder): Search Google's own Business Profile categories and pick the one that names your business.
- [Google review link generator](https://reach.locus-intelligence.com/tools/google-review-link-generator): Get the direct link that opens Google's review form for your business.
- [Review rating calculator](https://reach.locus-intelligence.com/tools/review-rating-calculator): Work out how many new reviews it takes to reach a target Google rating.
- [Local business schema generator](https://reach.locus-intelligence.com/tools/local-business-schema-generator): Generate LocalBusiness structured data for your website from a short form.
- [Bulk upload sheet checker](https://reach.locus-intelligence.com/tools/bulk-upload-sheet-checker): Check a Business Profile bulk upload sheet row by row before you upload it.

## Links

- [Connect Reach to Claude, ChatGPT and Claude Code](https://reach.locus-intelligence.com/guides/connect-ai): step-by-step setup guide
- [Reach Google Business Profile MCP server](https://reach.locus-intelligence.com/google-business-profile-mcp): what the server does and who it is for
- [Reach home](https://reach.locus-intelligence.com/)
- [Privacy Policy](https://reach.locus-intelligence.com/privacy)
- [Terms & Conditions](https://reach.locus-intelligence.com/terms)
- Support: hello@locus-intelligence.com