# CoreLoop Business Network (remote · coreloop.so)

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

- Trust score: 63/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-20

## Components

- remote · `coreloop.so`: 63/100 (this document), [markdown](https://verifymcp.io/servers/so-coreloop-directory/api-mcp-coreloop-directory.md), [page](https://verifymcp.io/servers/so-coreloop-directory/api-mcp-coreloop-directory)

## Channel facts

- Endpoint: `https://coreloop.so/api/mcp/coreloop-directory`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.2.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-20.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 6 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 62/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2176 tokens (~310/item across 7 items; 7 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 3/100
  - Stability observed for 1 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 96/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 86% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### Claude

```bash
claude mcp add --transport http so-coreloop-directory https://coreloop.so/api/mcp/coreloop-directory
```

### Codex

```toml
[mcp_servers.so-coreloop-directory]
url = "https://coreloop.so/api/mcp/coreloop-directory"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "so-coreloop-directory": {
      "type": "remote",
      "url": "https://coreloop.so/api/mcp/coreloop-directory",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add so-coreloop-directory --url https://coreloop.so/api/mcp/coreloop-directory --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  so-coreloop-directory:
    url: "https://coreloop.so/api/mcp/coreloop-directory"
```

### Other

```json
{
  "mcpServers": {
    "so-coreloop-directory": {
      "type": "http",
      "url": "https://coreloop.so/api/mcp/coreloop-directory"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-20 (score 63, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-08-19 (score 62)

First indexed and scored.

## MCP tools (7)

### `search_businesses` (~831 tokens)

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.

Input parameters:

- `capabilities` (array): Filter by capability tags (e.g. real_time_booking, live_pricing, verified)
- `category` (string): Filter by business category (case-insensitive exact match). Canonical categories: Accounting & Tax, Agriculture & Farming, Automotive, Beauty & Wellness, Childcare & Family, Cleaning Services, Constr…
- `city` (string): Filter by city (case-insensitive exact match)
- `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…
- `has_live_booking` (boolean): Only show businesses with real-time booking
- `has_live_catalog` (boolean): Only show businesses with live catalog pricing
- `limit` (integer): Maximum results per page (1-20). Out-of-range values are clamped, not rejected.
- `min_rating` (number): Minimum average rating (0-5)
- `query` (string): Search query (business name or keyword)
- `service_type` (string): Filter by service type keyword
- `sort_by` (string): Sort results. Default: relevance
- `verified_only` (boolean): Only show verified businesses

Output parameters:

- `businesses` (array)
- `has_more` (boolean): True when more results exist beyond this page. Read this rather than inferring from `returned_count`: a short page is not proof of the end.
- `next_cursor` (string|null): Opaque continuation token, or null on the last page. Pass it back unchanged as `cursor` to get the next page. It is bound to this search's filters and sort — change them and it is rejected, so start…
- `requested_locale` (string|null)
- `returned_count` (integer)

### `check_business_availability` (~164 tokens)

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

Input parameters:

- `business` (string, required): 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,…
- `location_id` (string): Which location's hours to return (id from get_info locations[]). Defaults to the primary location.

Output parameters:

- `always_open` (boolean)
- `business` (object)
- `data_source` (string)
- `is_open_now` (boolean)
- `last_updated` (string)
- `locale` (string)
- `location_id` (string|null)
- `location_label` (string|null)
- `next_open_at` (string|null)
- `operating_hours` (object|null)
- `timezone` (string)

### `compare_business_services` (~221 tokens)

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.

Input parameters:

- `business` (string, required): 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,…
- `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 fu…
- `service_type` (string, required): Service category or keyword to compare. Matches category exactly first, then service name/description contains.

Output parameters:

- `business` (object)
- `business_name` (string)
- `comparison_summary` (object)
- `data_source` (string)
- `last_updated` (string)
- `locale` (string)
- `service_type` (string)
- `services` (array)
- `suggestion` (object)
- `verified` (boolean)

### `get_business_agent` (~170 tokens)

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.

Input parameters:

- `business` (string, required): 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,…

Output parameters:

- `available_locales` (array)
- `business` (object)
- `content_locale` (string)
- `data_source` (string)
- `protocol_urls` (object)
- `protocols` (array)
- `resolved_at` (string)
- `tools_available` (array)
- `verified` (boolean)

### `get_business_info` (~150 tokens)

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

Input parameters:

- `business` (string, required): 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,…
- `sections` (array): Which sections to include. Defaults to all.

Output parameters:

- `asserts_no_physical_location` (boolean)
- `available_locales` (array)
- `business` (object)
- `call_to_action` (object)
- `category` (string)
- `contact` (object)
- `data_source` (string)
- `description` (string)
- `documents` (array)
- `images` (object)
- `intake` (object)
- `keywords` (array)
- `last_updated` (string)
- `locale` (string)
- `location` (object)
- `locations` (array)
- `name` (string)
- `policies` (object)
- `protocols_available` (array)
- `subcategories` (array)
- `tagline` (string|null)
- `tools_available` (array)
- `verified` (boolean)

### `get_business_services` (~333 tokens)

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.

Input parameters:

- `business` (string, required): 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,…
- `category` (string): Filter by service category
- `limit` (integer)
- `max_duration` (integer): Only services lasting at most this many minutes
- `max_price` (number): Only services priced at or below this amount
- `min_duration` (integer): Only services lasting at least this many minutes
- `min_price` (number): Only services priced at or above this amount
- `offset` (integer): Number of results to skip (pagination)
- `price_type` (string): Filter by price type (e.g. fixed, from, range, hourly, free, contact, or unpublished for services with no price set)
- `sort_by` (string): Field to sort by. Recognised values: price, duration, name, category (unrecognised values are ignored — results stay unsorted).
- `sort_order` (string): Sort direction (defaults to asc)

Output parameters:

- `business` (object)
- `data_source` (string)
- `has_more` (boolean)
- `last_updated` (string)
- `limit` (integer)
- `locale` (string)
- `offset` (integer)
- `services` (array)
- `total` (integer)

### `send_business_inquiry` (~202 tokens)

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.

Input parameters:

- `business` (string, required): 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,…
- `message` (string, required): Inquiry message (plain text, max 2000 chars)
- `sender_email` (string)
- `sender_name` (string, required)
- `sender_phone` (string)
- `subject` (string)

Output parameters:

- `business` (object)
- `message` (string)
- `status` (string)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/so-coreloop-directory/api-mcp-coreloop-directory#diagnostics

## Score history

- 2026-08-20: 63
- 2026-08-19: 62

## Links

- Remote endpoint: https://coreloop.so/api/mcp/coreloop-directory
- Website: https://coreloop.so/
- Changelog RSS feed: https://verifymcp.io/servers/so-coreloop-directory/api-mcp-coreloop-directory.xml
- Changelog JSON feed: https://verifymcp.io/servers/so-coreloop-directory/api-mcp-coreloop-directory.json
- HTML version of this page: https://verifymcp.io/servers/so-coreloop-directory/api-mcp-coreloop-directory