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.
openapi: 3.2.0
info:
title: Contrie Com MCP API
version: 1.0.0
contact:
email: hello@contrie.com
description: 'Operations tagged Mcp across 2 of this provider''s published API definitions: contrie-com-openapi.json, contrie-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://www.contrie.com
security:
- bearerAuth: []
tags:
- name: MCP
paths:
/mcp:
post:
operationId: mcp
summary: MCP Streamable HTTP endpoint
description: Hosted MCP Streamable HTTP. Anonymous clients may initialize and list tools; only exact recorded contrie_extract URL-and-prompt pairs from /llms.txt run anonymously. Other tool calls require Bearer API-key or OAuth authentication. contrie_read returns the full REST-shaped JSON response in a text block (data null, markdown and metadata/evidence) A successful read costs 1 credit and a failed one 0; a successful rendered read adds 2. REST-only options (format both, options.timeout, options.waitFor) are not MCP tool arguments.
security:
- {}
- bearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
type: object
description: JSON-RPC 2.0 message per the MCP Streamable HTTP transport spec.
responses:
'200':
description: MCP JSON-RPC response or event stream
'400':
description: Malformed MCP transport request
'401':
description: Authentication required, invalid, expired or revoked
headers:
WWW-Authenticate:
schema:
type: string
description: Bearer challenge containing the OAuth protected-resource metadata URL
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'403':
description: OAuth token lacks the required Contrie account scope. See WWW-Authenticate for the required scope.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'429':
description: RATE_LIMITED after about 20 failed authentication attempts a minute from one client (Retry-After 60). The account's per-minute limit on a tool call is reported inside the MCP tool result, not as HTTP 429.
headers:
Retry-After:
schema:
type: integer
description: Seconds until the caller may retry
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
'503':
description: SERVICE_UNAVAILABLE when the authentication service or OAuth configuration is temporarily unavailable. Retry later.
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
tags:
- MCP
servers:
- url: https://www.contrie.com
components:
schemas:
ErrorResponse:
type: object
required:
- success
- error
properties:
success:
type: boolean
enum:
- false
error:
type: object
required:
- code
- message
properties:
code:
type: string
enum:
- INVALID_REQUEST
- INVALID_URL
- IDEMPOTENCY_CONFLICT
- IDEMPOTENCY_EXPIRED
- IDEMPOTENCY_OUTCOME_UNKNOWN
- REQUEST_IN_PROGRESS
- NOT_FOUND
- UNAUTHORIZED
- INSUFFICIENT_SCOPE
- PAYMENT_REQUIRED
- FETCH_FAILED
- SOURCE_REFUSED
- RENDER_REQUIRED
- RATE_LIMITED
- PAGE_LIMIT_REACHED
- SERVICE_UNAVAILABLE
- MODELS_UNAVAILABLE
- EXTRACTION_FAILED
- INFERENCE_BUDGET_EXCEEDED
- INFERENCE_UNAVAILABLE
- RESULT_NOT_ACCEPTED
message:
type: string
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: Contrie API key or resource-bound OAuth access JWT
description: API key created at https://www.contrie.com/dashboard/keys (human sign-up in a browser; there is no programmatic key issuance), or an OAuth access token from the advertised Contrie sign-in flow. OAuth needs no additional API key. Configure credentials through the client or environment, never in a URL or agent chat.
x-refined-from:
- contrie-com-openapi.json
- contrie-com-openapi.yml