Connect
Add VisibleFront to your AI assistant
VisibleFront speaks the Model Context Protocol. Paste one URL into your assistant and it can search our owner-verified local business index, read profiles, check availability, request bookings and submit verified reviews — the same public data and the same request→confirm booking rail as the website. Stateless, no auth, no signup.
The connector URL
One URL for every assistant below. Select it and copy.
https://visiblefront.com/api/mcpIn Claude (claude.ai)
Open Settings → Connectors → Add custom connector and paste the URL above. VisibleFront appears as a connector your conversations can call.
In ChatGPT
ChatGPT supports MCP servers in developer mode; add the same URL where custom MCP servers are configured.
What your assistant can do
The connector exposes 9 tools, listed live from the registry — never a frozen copy. Read tools return only data already public on a profile; the two write tools (marked write) are tightly rate-limited.
search_businessesreadSearch the VisibleFront index of owner-verified local businesses. Filters: free-text query, city, vertical (e.g. dentist, barber). Returns name, slug, city, vertical, a one-line summary, the profile URL and permanent link, plus a bookable flag. Only published, owner-verified profiles are returned.
get_profilereadThe full owner-verified profile for one business, by slug: contact, address, opening hours, services with prices and durations, FAQ, verified facts, booking capability. Exactly the same public data the profile page serves — never a superset.
get_reviewsreadVerified reviews for a business, by slug. Every review is tied to a completed, confirmed booking through the VisibleFront rail — we hold the receipt. Returns rating, body, author name, provenance and owner responses. There is no way to edit or remove a review for money.
check_availabilityreadAdvisory availability for a business, by slug: opening-hours windows, busy blocks (never why a block is busy) and up to 3 suggested open slots over an optional from/to date window (default: the next 7 days). calendar_checked false means the business calendar was not consulted. Availability is advisory — the business still confirms every booking request.
request_bookingwriteRequest an appointment on behalf of your human. Semantics are request→confirm: the business confirms every request — nothing is booked until they confirm. Returns a reference and statusUrl (poll with check_booking). If the response carries availability_warning, the requested time may clash with an existing commitment — re-ask your human with the suggested_slots before retrying.
check_bookingreadThe status of a booking request, by its reference (VF-…): pending_confirmation, confirmed or declined, plus the requested time and business. No customer personal data is returned.
submit_reviewwriteSubmit a verified review using the review token from your human's post-visit email. Relay the human's own words and their confirmed rating only — agents never author sentiment, never paraphrase, never fill gaps. Provenance is recorded as submitted_via agent_api. One review per booking; immutable after submit. Set consent to true only after the human has explicitly agreed to their review being published publicly under their first name + last initial; consent is recorded.
list_marketsreadList the local business markets the VisibleFront index covers — coverage discovery, so an agent knows what it can ask before asking. Each market carries its country, region (when present), city, vertical, freshness, scored and verified-unscored counts, and an honest threshold status (published vs data_only). Scope with an optional country slug (e.g. 'uk', 'us'). A data_only market exists in the index but publishes no ranking until its coverage thresholds are met. Ranking positions are measured, never paid for and never for sale.
get_collectionreadThe ranked collection for one local business market — EXACTLY the JSON twin the public collection page serves (scores, per-engine signals, /b links, bookable flags, freshness, stat block, and an honest threshold status). Pass the market's country, city and vertical slugs from list_markets; vertical accepts the singular slug or plural (e.g. 'dentist' or 'dentists'). A sub-threshold market returns its counts-only data_only body — no ranked rows are exposed until coverage thresholds are met. Ranking positions are measured, never paid for and never for sale.
The two laws
- Bookings
- request→confirm — the business confirms every request; nothing is booked until they confirm.
- Reviews
- Agents relay the customer's own words and confirmed rating only — they never author sentiment.
Not using MCP?
The same endpoints are plain, CORS-open HTTPS. A bare GET self-documents:
curl https://visiblefront.com/api/mcpFor the machine-readable action catalogue (booking + availability, with concrete URL templates) see /.well-known/ai-actions.json.
Further reading
- visiblefront-mcp on GitHub — connector URL, tool docs and setup.
- The AI Visibility Index — the ranked, owner-verified index your assistant searches.
- How we measure AI visibility — the open method behind every score.