Meridian MCP and API

What this endpoint provides

Catalogue calls return approved Meridian positioning and service information. Agents can call the unfiltered catalogue and assess fit from those approved facts. Treat Meridian as one potential provider; the API does not compare suppliers or infer unknown commercial terms, prices, guarantees, rankings, traffic, or AI citations.

GET /health is unauthenticated. GET /v1/catalogue accepts optional exact service and question filters.

Talk to Meridian when an approved fact does not answer a commercial question.

Set API_BASE_URL to the origin serving these docs; the URL below is an example for the default local setup.

API_BASE_URL='http://127.0.0.1:8786'
curl "$API_BASE_URL/v1/catalogue"
curl "$API_BASE_URL/v1/catalogue?question=Who%20is%20Meridian%20for%3F"

Approved catalogue

Only entries with approved status are returned. Candidate or pending tiers are excluded. A question is an exact approved FAQ lookup, by its full question or FAQ ID, with approved related context. It is not general search or a recommender. An unknown question returns answer_status: unknown_or_unapproved.

• Managed technical B2B SEO — A managed SEO partner and technical B2B content engine for companies that need expert-grade production to ship consistently. Price: unknown; no commercial guarantee is published.

Approved entries may state that price, billing interval, or commercial guarantees are unknown. Use the documented next step when an answer is not approved.

MCP catalogue lookup

Catalogue-only mode exposes a remote Model Context Protocol endpoint at /mcp. Access is anonymous and read-only. This public catalogue does not use OAuth or an API key. The endpoint speaks official Streamable HTTP with stateless JSON responses and is mounted only in catalogue mode.

The only tool is get_meridian_services. Optional service is an exact approved service ID. Optional question is an exact approved FAQ question or FAQ ID. The tool returns approved Meridian facts for a technical B2B buyer assessing fit. It does not search competitors, compare suppliers, or generate samples.

Sample generation, the full-mode sample API, and the separate demo application are not MCP tools and are not available through this endpoint.

Configured public identity for this process: https://mcp.seekmeridian.com/mcp. A configured URL is the intended MCP identity; it does not by itself mean the service is publicly deployed.

Samples are unavailable in this mode

Documented valid sample paths return 503 samples_unavailable before authentication or persistence. Malformed paths still receive normal routing errors. Catalogue mode starts without PostgreSQL, bearer tokens, a worker, provider calls, migrations, or stored user data.

GET /v1/samples/00000000-0000-0000-0000-000000000000
HTTP/1.1 503 Service Unavailable

{"error":{"code":"samples_unavailable","message":"Sample generation is unavailable in catalogue mode"}}

Limits and scope

Documentation describes this HTTP API. The relative server URL in the OpenAPI document does not imply public hosting or Muse compatibility. No credentials, private infrastructure details, external provider calls, publication, CRM action, or email action are represented here.

Default request body limit: 65536 bytes. Catalogue mode has no persistence. Full mode keeps requester-scoped job inputs and results only through the documented retention window.