openapi: 3.2.0
info:
  title: AFMR Discovery Rpc API
  version: 1.0.1
  description: Institutionally neutral, read-oriented discovery for AFMR 1.0, the AFMR Reputation Attestation Working Draft, and configuration-only Lift Evidence. Nothing described here issues an attestation, confers market admission, establishes universal trust or safety, or authorizes a transaction.
  contact:
    name: Agent Failure Mode Registry
    url: https://afmr.ai/
  license:
    name: CC BY 4.0
    url: https://creativecommons.org/licenses/by/4.0/
servers:
- url: https://afmr.ai
tags:
- name: RPC
paths:
  /api/rpc:
    post:
      operationId: mcpJsonRpc
      summary: Call the public read-only AFMR MCP server
      description: MCP 2025-11-25 Streamable HTTP at the exact /api/rpc path. The server is stateless and does not expose an SSE listening stream.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JsonRpcRequest'
      responses:
        '200':
          description: JSON-RPC response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JsonRpcResponse'
        '202':
          description: Notification accepted
        '403':
          description: Browser Origin is not permitted
        '405':
          $ref: '#/components/responses/MethodNotAllowed'
      tags:
      - RPC
    get:
      operationId: mcpListeningStream
      summary: Probe for an optional MCP SSE listening stream
      description: This stateless server returns 405 because it does not offer an SSE listening stream. JSON-RPC messages use POST.
      responses:
        '405':
          $ref: '#/components/responses/MethodNotAllowed'
      tags:
      - RPC
components:
  schemas:
    Problem:
      type: object
      required:
      - type
      - title
      - status
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        detail:
          type: string
        instance:
          type: string
    JsonRpcResponse:
      type: object
      required:
      - jsonrpc
      - id
      properties:
        jsonrpc:
          const: '2.0'
        id: {}
        result: {}
        error:
          type: object
    JsonRpcRequest:
      type: object
      required:
      - jsonrpc
      - method
      properties:
        jsonrpc:
          const: '2.0'
        id:
          oneOf:
          - type: string
          - type: number
          - type: 'null'
        method:
          type: string
        params:
          type: object
          additionalProperties: true
  responses:
    MethodNotAllowed:
      description: Method is not supported; inspect Allow and the machine-readable problem document
      headers:
        Allow:
          schema:
            type: string
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'