---
title: "Search records with the hosted MCP schema"
method: GET
path: "/api/v1/mcp/search-records"
tags: ["Search"]
---

# Search records with the hosted MCP schema

`GET /api/v1/mcp/search-records`

## Request

- Base URL: `https://fonteum.com`
- URL: `https://fonteum.com/api/v1/mcp/search-records`
- Auth: HTTP bearer

REST bridge for the `fonteum_search_providers` MCP tool and source-only @fonteum/mcp 0.5.0 contract. Requires a healthcare vertical and state; it returns the same dated source-context envelope as hosted MCP. This is distinct from the semantic SSE `/search` endpoint.

## Query parameters

- `vertical` string, required
- `state` string, required
- `county` string
- `limit` integer

## Response `200`

Hosted MCP search result envelope.

- object
  - `data` object, required
  - `provenance` object, required
  - `source_file` string, nullable, required: Exact retained source filename when one file represents the response; null for composite results or when no retained file is identified.
  - `as_of_date` string, nullable, required: Source publish or snapshot date when one date represents the response; null for composite results with dates in nested source blocks or when no source date is available.
  - `snapshot_digest` string, nullable, required: Digest of an identified retained snapshot object; null for composite results with digests in nested source blocks or when unavailable, and never a per-fact signature or live-chain-head substitute.
  - `verifiable_url` string, uri, required: Public source, methodology, or retained-snapshot re-check URL appropriate to the response.

## Other responses

- `400`: Missing or invalid hosted MCP search input.
- `401`: Missing or invalid Fonteum API key.

---

[API](https://skmtc.dev/fonteum/apis/fonteum-api.md) · [All operations](https://skmtc.dev/fonteum/apis/fonteum-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fonteum/apis/fonteum-api/revisions/334e6e179d0d?raw)