CoreLoop Business Network

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Search real businesses, then read profiles, services and hours or contact them, in one endpoint.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "CoreLoop Business Network": {
      "url": "https://coreloop.so/api/mcp/coreloop-directory",
      "transport": "streamable-http"
    }
  }
}

Measured tools (7)

• search_businesses read-only

  Search the CoreLoop business directory. Start here: every other tool on this endpoint needs a business, and each result carries the `business_id` and `slug` you pass to them as the `business` argument. `business_id` is a PUBLIC, OPAQUE, STABLE routing identifier: it is safe to store and re-use across sessions, it stays the same when a business renames itself or changes its slug, and it carries no sensitive information. Treat it as a token — do not parse it, do not derive meaning from its format, and do not construct one. Pass back exactly the value you were given. A result with `asserts_no_physical_location: true` has stated that it has no premises (consultants, trades, online-only) — it is intentionally absent from city search rather than missing data. `false` means no such statement was made; it does NOT imply premises. Results are returned in your requested language when the business has published a translation: send `?locale=<code>` on the endpoint URL (takes precedence) or an Accept-Language header. Each result reports the language it is written in (`locale`), the business's original language (`content_locale`), and every language it is available in (`available_locales`). `mcp_url`, `a2a_url` and `page_url` — and every URL inside `protocol_urls` — are null when that surface is currently switched off for the business: a null is intentional (do not construct the URL yourself), and the business remains reachable through its non-null surfaces. `data_source: "directory"` marks these rows as the search projection; call get_business_info for the live profile. PAGING: one call returns at most `limit` results. Read `has_more` — a short page is not proof of the end — and pass `next_cursor` back as `cursor` for the next page. The cursor is opaque and bound to the filters and sort it was issued for: change any of them and it is rejected, so start a new search instead. `limit` may change between pages.

  Parameters:

  • city — string — Filter by city (case-insensitive exact match)
  • limit — integer — Maximum results per page (1-20). Out-of-range values are clamped, not rejected.
  • query — string — Search query (business name or keyword)
  • cursor — string — Continuation token from a previous response's `next_cursor`. Omit for the first page. It is opaque and bound to the filters and sort it was issued for: pass it back byte-for-byte, and change nothing except `limit` between pages — any other change makes it invalid and you must start a new search. At most 100 results are reachable by paging; narrow the filters to see beyond that.
  • sort_by — string — Sort results. Default: relevance
  • category — string — Filter by business category (case-insensitive exact match). Canonical categories: Accounting & Tax, Agriculture & Farming, Automotive, Beauty & Wellness, Childcare & Family, Cleaning Services, Construction & Renovation, Creative & Arts, Education & Training, Events & Entertainment, Financial Services, Fitness & Sports, Food & Beverage, Funeral & Memorial, Health & Medical, Home Services, Legal Services, Media & Photography, Nonprofit & Community, Personal Care & Therapy, Pets & Animals, Professional Services, Real Estate, Religious & Spiritual, Retail & Shopping, Security Services, Sports & Recreation, Technology & IT, Transportation & Logistics, Travel & Tourism, Other
  • min_rating — number — Minimum average rating (0-5)
  • capabilities — array — Filter by capability tags (e.g. real_time_booking, live_pricing, verified)
  • service_type — string — Filter by service type keyword
  • verified_only — boolean — Only show verified businesses
  • has_live_booking — boolean — Only show businesses with real-time booking
  • has_live_catalog — boolean — Only show businesses with live catalog pricing

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• check_business_availability read-only

  One business's opening hours, whether it is open right now, and when it next opens. Phase 1 returns published hours, not bookable slots.

  Parameters:

  • business (required) — string — Which business to ask: its CoreLoop slug, or the `business_id` returned by search_businesses. `business_id` is an opaque, stable, public routing identifier — safe to store and re-use across sessions, unchanged by a rename or a slug change, and carrying no sensitive information. Pass back exactly the value search_businesses gave you: do not parse it, do not infer meaning from its format, and do not construct one.
  • location_id — string — Which location's hours to return (id from get_info locations[]). Defaults to the primary location.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• compare_business_services read-only

  Compare one business's services within a category or keyword, with a price/duration summary. Each row reports `match_type`, so you can tell an exact category hit from an incidental keyword.

  Parameters:

  • business (required) — string — Which business to ask: its CoreLoop slug, or the `business_id` returned by search_businesses. `business_id` is an opaque, stable, public routing identifier — safe to store and re-use across sessions, unchanged by a rename or a slug change, and carrying no sensitive information. Pass back exactly the value search_businesses gave you: do not parse it, do not infer meaning from its format, and do not construct one.
  • service_type (required) — string — Service category or keyword to compare. Matches category exactly first, then service name/description contains.
  • compare_by — array — Restrict the comparison to these fields. Recognised values: price, duration, description, includes (name, category and match_type are always present; unrecognised values are ignored). Omit for the full comparison view.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• get_business_agent read-only

  The canonical ids and endpoint URLs for one business — its own MCP and A2A endpoints, agent card, llms.txt and public page, under `protocol_urls`. A null URL means that surface is switched off for this business right now: do not construct it yourself, and use one of the non-null surfaces instead.

  Parameters:

  • business (required) — string — Which business to ask: its CoreLoop slug, or the `business_id` returned by search_businesses. `business_id` is an opaque, stable, public routing identifier — safe to store and re-use across sessions, unchanged by a rename or a slug change, and carrying no sensitive information. Pass back exactly the value search_businesses gave you: do not parse it, do not infer meaning from its format, and do not construct one.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• get_business_info read-only

  Full profile for one business found through search_businesses: identity, locations, contact, policies, images, public documents and the languages it publishes in.

  Parameters:

  • business (required) — string — Which business to ask: its CoreLoop slug, or the `business_id` returned by search_businesses. `business_id` is an opaque, stable, public routing identifier — safe to store and re-use across sessions, unchanged by a rename or a slug change, and carrying no sensitive information. Pass back exactly the value search_businesses gave you: do not parse it, do not infer meaning from its format, and do not construct one.
  • sections — array — Which sections to include. Defaults to all.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• get_business_services read-only

  One business's service catalogue, with filtering, sorting and pagination. Page with `offset`/`limit` and read `has_more` — the order is stable, so a second page will not repeat or skip a service.

  Parameters:

  • business (required) — string — Which business to ask: its CoreLoop slug, or the `business_id` returned by search_businesses. `business_id` is an opaque, stable, public routing identifier — safe to store and re-use across sessions, unchanged by a rename or a slug change, and carrying no sensitive information. Pass back exactly the value search_businesses gave you: do not parse it, do not infer meaning from its format, and do not construct one.
  • limit — integer
  • offset — Pagination position: omit for the first page, then pass back the `next_offset` token from the previous response VERBATIM. The token is opaque and bound to the catalogue as it was when the page was issued — if services were added, removed or reordered since, the call returns `cursor_expired` and you should restart without an offset. A plain integer offset is still accepted in EITHER spelling — as a JSON number (20) or as its exact string form ("20") — and skips that many results with no catalogue binding. Only a string that is neither an exact integer nor a token this endpoint issued (for example a mangled or truncated token) is refused with `cursor_expired` rather than resumed.
  • sort_by — string — Field to sort by. Recognised values: price, duration, name, category (unrecognised values are ignored — results stay unsorted).
  • category — string — Filter by service category
  • max_price — number — Only services priced at or below this amount
  • min_price — number — Only services priced at or above this amount
  • price_type — string — Filter by price type (e.g. fixed, from, range, hourly, free, contact, or unpublished for services with no price set)
  • sort_order — string — Sort direction (defaults to asc)
  • max_duration — integer — Only services lasting at most this many minutes
  • min_duration — integer — Only services lasting at least this many minutes

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world no

• send_business_inquiry

  Send a message to one business. This has a real side effect — it notifies the owner and delivers an email — and is rate-limited both per business and across this directory, so send one considered inquiry rather than a broadcast.

  Parameters:

  • business (required) — string — Which business to ask: its CoreLoop slug, or the `business_id` returned by search_businesses. `business_id` is an opaque, stable, public routing identifier — safe to store and re-use across sessions, unchanged by a rename or a slug change, and carrying no sensitive information. Pass back exactly the value search_businesses gave you: do not parse it, do not infer meaning from its format, and do not construct one.
  • message (required) — string — Inquiry message (plain text, max 2000 chars)
  • sender_name (required) — string
  • subject — string
  • sender_email — string
  • sender_phone — string

  Hints: read-only no · destructive no · idempotent no · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.