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/mcp

In 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_businessesread

    Search 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_profileread

    The 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_reviewsread

    Verified 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_availabilityread

    Advisory 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_bookingwrite

    Request 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_bookingread

    The 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_reviewwrite

    Submit 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_marketsread

    List 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_collectionread

    The 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/mcp

For the machine-readable action catalogue (booking + availability, with concrete URL templates) see /.well-known/ai-actions.json.

Further reading