overlay: 1.0.0
info:
title: API Evangelist overlay for CNC Compass Search API
version: 1.0.0
extends: ../openapi/_original/cnccompass-com-openapi.yml
x-generated: '2026-11-04'
x-method: generated
x-source: https://cnccompass.com/.well-known/ai-access.json
x-rationale: >-
The provider OpenAPI declares only the X-Api-Key scheme, has no tags, and does not link its REST search
to the MCP tool. ai-access.json (HTTP 200, 2026-11-04) states "Authorization: Bearer is accepted too",
and a live tools/list confirmed the search_suppliers tool. This overlay adds those facts without
mutating the original.
actions:
- target: $.components.securitySchemes
description: Add the Bearer alternative that ai-access.json documents for the same issued key.
update:
bearerKey:
type: http
scheme: bearer
description: Optional. The CNC Compass-issued API key sent as Authorization Bearer; raises the anonymous per-IP quota.
- target: $
description: Add tags.
update:
tags:
- name: Search
description: Natural-language search over published CNC supplier records.
- name: MCP
description: Remote Model Context Protocol server (Streamable HTTP).
- target: $.paths['/api/search'].get
description: Tag, add Bearer option, and bind to the MCP tool.
update:
tags: [Search]
security: [{apiKey: []}, {bearerKey: []}, {}]
x-mcp-tool: search_suppliers
- target: $.paths['/api/search'].post
description: Tag, add Bearer option, and bind to the MCP tool.
update:
tags: [Search]
security: [{apiKey: []}, {bearerKey: []}, {}]
x-mcp-tool: search_suppliers
- target: $.paths['/mcp'].post
description: Tag and list the tools the live server returned on 2026-11-04.
update:
tags: [MCP]
security: [{apiKey: []}, {bearerKey: []}, {}]
x-mcp-tools: [search_suppliers, get_supplier, list_facets]
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.