Contrie MCP API

The Mcp API from Contrie — 1 operation(s) for mcp.

GitHub OpenAPI

Operations 1

POST /mcp MCP Streamable HTTP endpoint #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/contrie-com:contrie-com-mcp-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

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.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

contrie-com-mcp-api-openapi.yml Raw ↑
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