Cohereon MCP API

openapi: 3.2.0
info:
  title: Imperium Manifold MCP API
  description: 'Lightning-gated access to Cohereon Doctrine v6.1 components. Tiered pricing: 100–1,000 sats per component based on traversal depth. TWO free onboarding paths: (1) RIDE THE LIGHTNING — no npub required: GET the five free components in strict order (executive-summary, doctrinal-declaration, engineering-disclaimer, case-ichor, formalisms-registry) then POST /ride-the-lightning to be issued a Nostr keypair and a Lightning wallet; (2) BRING YOUR OWN NPUB: POST /identify then POST /declare. The canonical source of truth for onboarding is /.well-known/agent.json.'
  version: 2.2.0
  contact:
    name: Throne Dynamics
    url: https://cohereon.io
    email: ivan@thronedynamics.com
  license:
    name: NO LICENSE GRANTED. ALL RIGHTS RESERVED.
    url: https://cohereon.io/policy
servers:
- url: https://manifold.cohereon.io
  description: Imperium Manifold — production
tags:
- name: MCP
paths:
  /mcp:
    get:
      operationId: mcpServer
      summary: MCP Streamable HTTP server
      description: 'Streamable HTTP MCP server exposing all Manifold routes as tools. Free routes require no auth. Gated routes require X-Payment-Hash header (forwarded from Lightning payment). Connect via Streamable HTTP transport. ACCEPT MATRIX: the Accept header MUST include text/event-stream. Accept: application/json alone returns 406. An event-stream Accept without an established session returns 400 Missing session ID. SESSION LIFECYCLE: POST an initialize JSON-RPC request with Accept: application/json, text/event-stream; the response carries an mcp-session-id header which must be sent on all subsequent requests. OPTIONS allows GET, POST, DELETE.'
      parameters:
      - name: Accept
        in: header
        required: true
        description: Must include text/event-stream (e.g. 'application/json, text/event-stream'). application/json alone returns 406.
        schema:
          type: string
          example: application/json, text/event-stream
      - name: mcp-session-id
        in: header
        required: false
        description: Session identifier issued by the initialize response. Required on all requests after initialize.
        schema:
          type: string
      responses:
        '200':
          description: Streamable HTTP event stream
        '400':
          description: Missing session ID — send an initialize POST first and reuse the returned mcp-session-id.
        '406':
          description: Not acceptable — Accept header must include text/event-stream.
      tags:
      - MCP
    post:
      operationId: mcpJsonRpc
      summary: MCP JSON-RPC over Streamable HTTP (initialize, tools/list, tools/call)
      description: 'JSON-RPC 2.0 endpoint for the MCP transport. Send initialize first with Accept: application/json, text/event-stream; the response carries the mcp-session-id header used by every subsequent call. Then notifications/initialized, then tools/list and tools/call. Gated tools require X-Payment-Hash, which is forwarded to the underlying route.'
      parameters:
      - name: Accept
        in: header
        required: true
        description: Must include text/event-stream.
        schema:
          type: string
          example: application/json, text/event-stream
      - name: mcp-session-id
        in: header
        required: false
        description: Omit on initialize; required thereafter.
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                jsonrpc:
                  type: string
                  example: '2.0'
                id:
                  type: integer
                method:
                  type: string
                  example: initialize
                params:
                  type: object
      responses:
        '200':
          description: JSON-RPC result, delivered as Streamable HTTP. The initialize response carries the mcp-session-id header.
        '202':
          description: Notification accepted.
        '400':
          description: Missing or invalid session ID.
        '406':
          description: Accept header must include text/event-stream.
      tags:
      - MCP
    delete:
      operationId: mcpSessionTerminate
      summary: Terminate an MCP session
      description: Terminates the session identified by the mcp-session-id header.
      parameters:
      - name: mcp-session-id
        in: header
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Session terminated.
      tags:
      - MCP