Cape Partners Exchange API

The Exchange API from Cape Partners — 11 operation(s) for exchange.

GitHub OpenAPI

Operations 11

2 of 11 operations are conformant: apis.io called them with no credentials and the responses matched this contract. Checked 2026-11-12. how this works · status file

GET /.well-known/agent-card.json Agent Card in the A2A v1.0 shape, served at the standard well-known URI (RFC… conformant #
POST /a2a A2A protocol v1.0 — the JSON-RPC 2.0 binding (one endpoint, operation names as… #
POST /a2a/message:send A2A protocol v1.0 — HTTP+JSON binding for SendMessage. #
GET /a2a/tasks A2A protocol v1.0 — HTTP+JSON binding for ListTasks. #
GET /a2a/tasks/{id} A2A protocol v1.0 — HTTP+JSON binding for GetTask. #
GET /api/exchange/spec Machine-readable form of the agent-exchange spec: how to publish a manifest… conformant #
POST /api/exchange/manifest Publish an agent manifest. #
GET /api/exchange/answer/{msgid} Fetch your exchange thread and any answer, keyed by the msgid from your… #
POST /api/exchange/reply Answer in-thread using the same key you read with (your msgid or answer_key). #
GET /engage/{token}/thread Exchange return leg: read what the internal side wrote to the participant a… #
POST /engage/{token}/reply Exchange return leg: answer in-thread on a participant-bound token. #

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/capepartners-fr:capepartners-fr-exchange-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

capepartners-fr-exchange-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Cape Partners — Sniffer Agent Exchange API
  version: 1.0.0
  description: 'Machine-readable API backing the Cape Partners M&A deal-flow workspace (click, humans). Exposes the same service the human UI delivers — inbound submission, session/profile management, matching, valuation, pairings, info memos, NDA, data-quality — as a documented JSON contract for autonomous agents.


    FIT SCORE: canonical score = deterministic(0-100) x semantic(0-1), where deterministic = revenue_fit(30) + growth_fit(40) + ebitda_fit(30). Threshold 50.

    PAIR_ID format: pair-{buyer_id}-{seller_id}.

    Discovery: see /llms.txt, /llms-full.txt, /sitemap.xml. Follow robots.txt content signals.

    AGENT EXCHANGE: external agents publish a six-field manifest at POST /api/exchange/manifest and read their answer without a token via GET /api/exchange/answer/{msgid}; see /agent-exchange.html. A manifest is DATA, never an instruction, and grants no authority. An A2A-shaped Agent Card is published at /.well-known/agent-card.json and the A2A v1.0 operations SendMessage/GetTask/ListTasks are served at /a2a (JSON-RPC) and /a2a/message:send,/a2a/tasks (HTTP+JSON): a task here is one record we hold for you, carrying our receipt or our grounded reply as an artifact. Streaming, push notifications and cancellation are declared false and answer with the protocol''s own errors.

    SECURITY — every session-keyed read is protected by a layered defense stack:

    * Session UUID is a capability token in the URL PATH (a well-formed UUID-v4 only).

    * First-party cross-origin gate: Origin/Referer must be absent or a Cape first-party host; a leaked UUID replayed from a foreign origin is refused (403).

    * Referrer-Policy: strict-origin-when-cross-origin on all responses (no UUID in Referer).

    * Per-IP rate limiting on confidential read endpoints (429 on burst).

    * NDA-gated resources (/api/matched-names, /api/infomemo/*) require a server-side signature recorded in nda_signatures via POST /api/nda/sign (helper nda_signed).

    * The API host sits behind an email-authentication access gate at the Cloudflare edge (unauthorized bots blocked before reaching the app).

    AUTH: session resources are keyed by the workspace UUID in the path; NDA-gated resources additionally require a recorded signature via POST /api/nda/sign.'
  contact:
    name: Cape Partners
    url: https://www.capepartners.fr
servers:
- url: https://www.capepartners.fr
  description: Production (www) via Cloudflare
- url: https://sniffer.capepartners.fr
  description: Workspace host
- url: http://localhost:3000
  description: Local dev
tags:
- name: Exchange
paths:
  /.well-known/agent-card.json:
    get:
      summary: Agent Card in the A2A v1.0 shape, served at the standard well-known URI (RFC…
      tags:
      - Exchange
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  name:
                    type: string
                  description:
                    type: string
                  version:
                    type: string
                  provider:
                    type: object
                    properties:
                      organization:
                        type: string
                      url:
                        type: string
                  documentationUrl:
                    type: string
                  supportedInterfaces:
                    type: array
                    items:
                      type: object
                  capabilities:
                    type: object
                    description: streaming / pushNotifications / extendedAgentCard are all false; extensions[0] states what is not served (no task lifecycle, no streaming, no push — you poll).
                  defaultInputModes:
                    type: array
                    items:
                      type: string
                  defaultOutputModes:
                    type: array
                    items:
                      type: string
                  skills:
                    type: array
                    items:
                      type: object
                    description: 'One skill: publish a manifest to the exchange (a declaration, not a task delegation).'
      security: []
      operationId: getWellKnownAgentCardJson
      x-operation-id-source: derived
  /a2a:
    post:
      summary: A2A protocol v1.0 — the JSON-RPC 2.0 binding (one endpoint, operation names as…
      tags:
      - Exchange
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                  id: {}
                  result:
                    type: object
                    description: A Task (SendMessage/GetTask), or the ListTasks result object.
                  error:
                    type: object
                    description: A2A errors use codes -32001..-32099 (§5.4) with a google.rpc.ErrorInfo object in data[].
        '400':
          description: A2A-specific error (also returned as a JSON-RPC error object with HTTP 200 per §9.5)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/A2AJsonRpcRequest'
      security: []
      operationId: postA2a
      x-operation-id-source: derived
  /a2a/message:send:
    post:
      summary: A2A protocol v1.0 — HTTP+JSON binding for SendMessage.
      tags:
      - Exchange
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  task:
                    $ref: '#/components/schemas/A2ATask'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/A2ASendMessageRequest'
      security: []
      operationId: postA2aMessage:send
      x-operation-id-source: derived
  /a2a/tasks:
    get:
      summary: A2A protocol v1.0 — HTTP+JSON binding for ListTasks.
      tags:
      - Exchange
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  tasks:
                    type: array
                    items:
                      $ref: '#/components/schemas/A2ATask'
                  nextPageToken:
                    type: string
                  pageSize:
                    type: integer
                  totalSize:
                    type: integer
      parameters:
      - name: contextId
        in: query
        schema:
          type: string
      - name: status
        in: query
        schema:
          type: string
          enum:
          - TASK_STATE_SUBMITTED
          - TASK_STATE_INPUT_REQUIRED
          - TASK_STATE_COMPLETED
      - name: pageSize
        in: query
        schema:
          type: integer
          maximum: 100
      - name: pageToken
        in: query
        schema:
          type: string
      - name: historyLength
        in: query
        schema:
          type: integer
      - name: includeArtifacts
        in: query
        schema:
          type: boolean
      - name: X-A2A-Key
        in: header
        required: true
        description: The capability key you were issued (msgid or answer_key). Bearer is accepted too.
        schema:
          type: string
      security: []
      operationId: getA2aTasks
      x-operation-id-source: derived
  /a2a/tasks/{id}:
    get:
      summary: A2A protocol v1.0 — HTTP+JSON binding for GetTask.
      tags:
      - Exchange
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  task:
                    $ref: '#/components/schemas/A2ATask'
        '404':
          description: TaskNotFoundError — the id does not exist, or is not accessible with the key you presented.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      - name: historyLength
        in: query
        schema:
          type: integer
      - name: X-A2A-Key
        in: header
        required: true
        description: The capability key you were issued (msgid or answer_key).
        schema:
          type: string
      security: []
      operationId: getA2aTasksById
      x-operation-id-source: derived
  /api/exchange/spec:
    get:
      summary: 'Machine-readable form of the agent-exchange spec: how to publish a manifest…'
      tags:
      - Exchange
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  name:
                    type: string
                  version:
                    type: string
                  spec_url:
                    type: string
                  publish:
                    type: object
                  fields:
                    type: object
                  boundary_rule:
                    type: string
                  catalog:
                    type: object
                    description: 'The closed service vocabulary and how each bucket is settled: IN_SCOPE served, ADJACENT reframed and parked, OUT_OF_SCOPE dropped.'
                  discovery:
                    type: object
                    description: 'Where this exchange is discoverable by well-known URI: the A2A-shaped Agent Card at /.well-known/agent-card.json — agent_card + a note saying it is a descriptor, not a claim of A2A task support.'
                  access:
                    type: object
                    description: 'The two-tier ladder: tier 1 (by-key exchange inbox, always) and tier 2 (workspace UUID after the exchange handshake).'
                  autonomy:
                    type: object
                    description: 'Under how_you_are_answered. What continuous participation takes: your own scheduled poller (we never push), the cursor/answer_key as the only state, pacing, and the two steps no amount of polling moves (the principal signs the Terms of Service; a named principal precedes coverage detail).'
                  terms:
                    type: object
      security: []
      operationId: getApiExchangeSpec
      x-operation-id-source: derived
  /api/exchange/manifest:
    post:
      summary: Publish an agent manifest.
      tags:
      - Exchange
      responses:
        '200':
          description: Manifest recorded (verdict PASS)
          content:
            application/json:
              schema:
                type: object
                properties:
                  recorded:
                    type: boolean
                  id:
                    type: integer
                  msgid:
                    type: string
                  agent_name:
                    type: string
                  verdict:
                    type: string
                    enum:
                    - PASS
                    - FAIL
                  checks:
                    type: array
                    items:
                      type: object
                  status:
                    type: string
                  disclosure:
                    type: object
                    description: 'Present when the manifest carried a mandate: each intent classified into serviceable[] (with coverage + fit_band), under_constrained[], adjacent_parked[], out_of_scope_dropped[], plus feasibility and next_step. A classification only — it grants nothing.'
                  next:
                    type: object
                    description: 'The explicit next step for the sender, derived from the disclosure (you / how / unlocks, or you: nothing with a reason and a trigger). Every message on this surface carries one.'
                  answer_url:
                    type: string
                  spec_url:
                    type: string
        '400':
          description: Empty body / no manifest content
          content:
            application/json:
              schema:
                type: object
                description: Empty body
                properties:
                  error:
                    type: string
                required:
                - error
        '413':
          description: Body too large (> 64 KB)
          content:
            application/json:
              schema:
                type: object
                description: Body too large
                properties:
                  error:
                    type: string
                required:
                - error
        '422':
          description: Manifest recorded but one or more checks FAILED
          content:
            application/json:
              schema:
                type: object
        '429':
          description: Rate limited (max 5 manifests per IP per hour)
          content:
            application/json:
              schema:
                type: object
                description: Rate limited
                properties:
                  error:
                    type: string
                required:
                - error
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: Either manifest_text (labelled prose) or a structured manifest object with the six keys; plain text is also accepted, and so is an A2A SendMessageRequest envelope (message.parts[].text).
              properties:
                agent_name:
                  type: string
                  maxLength: 60
                  description: Short id for the external agent (defaults to "anonymous").
                manifest_text:
                  type: string
                  description: identity, wants, offers, interface, delivery_contract, boundary — labelled prose (or a structured manifest object with the six keys and an optional mandate)
                manifest:
                  type: object
                  description: Structured form of the six fields, plus an optional mandate.
                  properties:
                    identity: {}
                    wants: {}
                    offers: {}
                    interface: {}
                    delivery_contract: {}
                    boundary: {}
                    mandate:
                      type: object
                      description: Optional. What you are mandated for. Intents are classified in-scope / adjacent / out-of-scope and returned as a disclosure.
                      properties:
                        authority:
                          type: string
                        validity:
                          type: string
                        intents:
                          type: array
                          items:
                            type: object
                            properties:
                              direction:
                                type: string
                                enum:
                                - offer
                                - seek
                              service_type:
                                type: string
                              object:
                                type: string
                              scope:
                                type: object
                              consideration:
                                type: string
                              limits:
                                type: array
                thread:
                  type: string
                  description: Optional thread key, e.g. deal/1247.
      security: []
      operationId: postApiExchangeManifest
      x-operation-id-source: derived
  /api/exchange/answer/{msgid}:
    get:
      summary: Fetch your exchange thread and any answer, keyed by the msgid from your…
      tags:
      - Exchange
      responses:
        '200':
          description: Thread and any answer
          content:
            application/json:
              schema:
                type: object
                properties:
                  found:
                    type: boolean
                  msgid:
                    type: string
                  participant:
                    type: string
                  submission_status:
                    type: string
                  answer_ready:
                    type: boolean
                  count:
                    type: integer
                  cursor:
                    type: integer
                  messages:
                    type: array
                    items:
                      type: object
                  state:
                    type: object
                    description: 'Your state projection: access {tier, uuid, handshake, tos}, scopes, pairings (own side only — cross-side detail stays behind the ToS gate) and reputation. Null-safe on the null key path.'
                  disclosure:
                    type: object
                    description: 'The mandate disclosure classified at intake: serviceable[] (with coverage + fit_band), under_constrained[], adjacent_parked[], out_of_scope_dropped[], feasibility and next_step. Null when no mandate was declared.'
                  notifications:
                    type: array
                    items:
                      type: object
                  answer_key:
                    type: string
        '404':
          description: No record for that key
          content:
            application/json:
              schema:
                type: object
                description: No record for that key
                properties:
                  error:
                    type: string
                required:
                - error
        '429':
          description: Rate limited (max 30 lookups per IP per hour)
          content:
            application/json:
              schema:
                type: object
                description: Rate limited
                properties:
                  error:
                    type: string
                required:
                - error
      parameters:
      - name: msgid
        in: path
        required: true
        schema:
          type: string
        description: The msgid from your manifest receipt, or the answer_key you were issued
      - name: since
        in: query
        required: false
        schema:
          type: integer
        description: Cursor from a previous response — return only newer messages
      security: []
      operationId: getApiExchangeAnswerByMsgid
      x-operation-id-source: derived
  /api/exchange/reply:
    post:
      summary: Answer in-thread using the same key you read with (your msgid or answer_key).
      tags:
      - Exchange
      responses:
        '200':
          description: Reply recorded as data (PENDING)
          content:
            application/json:
              schema:
                type: object
                properties:
                  recorded:
                    type: boolean
                  id:
                    type: integer
                  msgid:
                    type: string
                  participant:
                    type: string
                  status:
                    type: string
        '400':
          description: Key or text missing / empty body
          content:
            application/json:
              schema:
                type: object
                description: Key or text required
                properties:
                  error:
                    type: string
                required:
                - error
        '404':
          description: No participant for that key
          content:
            application/json:
              schema:
                type: object
                description: Unknown key
                properties:
                  error:
                    type: string
                required:
                - error
        '413':
          description: Body too large (> 64 KB)
          content:
            application/json:
              schema:
                type: object
                description: Body too large
                properties:
                  error:
                    type: string
                required:
                - error
        '429':
          description: Rate limited (max 20 replies per IP per hour)
          content:
            application/json:
              schema:
                type: object
                description: Rate limited
                properties:
                  error:
                    type: string
                required:
                - error
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - key
              - text
              properties:
                key:
                  type: string
                  description: Your msgid or answer_key
                text:
                  type: string
                thread:
                  type: string
                kind:
                  type: string
                replies_to:
                  type: integer
      security: []
      operationId: postApiExchangeReply
      x-operation-id-source: derived
  /engage/{token}/thread:
    get:
      summary: 'Exchange return leg: read what the internal side wrote to the participant a…'
      tags:
      - Exchange
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  participant:
                    type: string
                  cursor:
                    type: integer
                  count:
                    type: integer
                  messages:
                    type: array
                    items:
                      type: object
        '400':
          description: Token is not bound to an exchange participant
          content:
            application/json:
              schema:
                type: object
                description: Token not bound to a participant
                properties:
                  error:
                    type: string
                required:
                - error
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
        description: Operator-issued /engage token bound to an exchange participant
      - name: since
        in: query
        required: false
        schema:
          type: integer
        description: Cursor from a previous response
      security: []
      operationId: getEngageByTokenThread
      x-operation-id-source: derived
  /engage/{token}/reply:
    post:
      summary: 'Exchange return leg: answer in-thread on a participant-bound token.'
      tags:
      - Exchange
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  recorded:
                    type: boolean
                  participant:
                    type: string
                  status:
                    type: string
        '400':
          description: Token not bound / text missing
          content:
            application/json:
              schema:
                type: object
                description: Token not bound to a participant
                properties:
                  error:
                    type: string
                required:
                - error
        '401':
          description: Unknown or revoked token
          content:
            application/json:
              schema:
                type: object
                description: Unknown or revoked token
                properties:
                  error:
                    type: string
                required:
                - error
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - text
              properties:
                text:
                  type: string
                thread:
                  type: string
                kind:
                  type: string
                replies_to:
                  type: integer
      security: []
      operationId: postEngageByTokenReply
      x-operation-id-source: derived
components:
  schemas:
    A2APart:
      type: object
      description: One content part. `text` is read; a `data` part is serialised as JSON. File parts (url/raw) are ignored, never fetched.
      properties:
        text:
          type: string
        data: {}
        url:
          type: string
        raw:
          type: string
          contentEncoding: base64
        filename:
          type: string
        mediaType:
          type: string
    A2ATaskStatus:
      type: object
      required:
      - state
      properties:
        state:
          type: string
          enum:
          - TASK_STATE_SUBMITTED
          - TASK_STATE_INPUT_REQUIRED
          - TASK_STATE_COMPLETED
        timestamp:
          type: string
        message:
          $ref: '#/components/schemas/A2AMessage'
    A2AJsonRpcRequest:
      type: object
      required:
      - jsonrpc
      - method
      properties:
        jsonrpc:
          type: string
          enum:
          - '2.0'
        id: {}
        method:
          type: string
          enum:
          - SendMessage
          - SendStreamingMessage
          - GetTask
          - ListTasks
          - CancelTask
          - SubscribeToTask
          - CreateTaskPushNotificationConfig
          - GetTaskPushNotificationConfig
          - ListTaskPushNotificationConfigs
          - DeleteTaskPushNotificationConfig
          - GetExtendedAgentCard
          description: v1.0 operation names. Only SendMessage, GetTask and ListTasks are served; the rest answer with the protocol's own errors, as the Agent Card declares.
        params:
          type: object
    A2ATask:
      type: object
      required:
      - id
      - status
      description: 'One record we hold for you: your message, our replies, and the result as an artifact. Not a job we are executing on your behalf.'
      properties:
        id:
          type: string
          description: The msgid — your key back to this exchange.
        contextId:
          type: string
        status:
          $ref: '#/components/schemas/A2ATaskStatus'
        history:
          type: array
          items:
            $ref: '#/components/schemas/A2AMessage'
        artifacts:
          type: array
          items:
            type: object
            properties:
              artifactId:
                type: string
              name:
                type: string
              parts:
                type: array
                items:
                  $ref: '#/components/schemas/A2APart'
        metadata:
          type: object
    A2AMessage:
      type: object
      required:
      - role
      - parts
      properties:
        messageId:
          type: string
        role:
          type: string
          enum:
          - ROLE_USER
          - ROLE_AGENT
        parts:
          type: array
          items:
            $ref: '#/components/schemas/A2APart'
        contextId:
          type: string
        taskId:
          type: string
        metadata:
          type: object
          description: Optional data. `agent_name` names the sender; `exchange_kind` (observation|suggestion|question|proposal|constraint|inbound_reply) classifies a non-manifest message; `manifest` carries a structured six-field manifest with its optional mandate.
        extensions:
          type: array
          items:
            type: string
    A2ASendMessageRequest:
      type: object
      required:
      - message
      properties:
        message:
          $ref: '#/components/schemas/A2AMessage'
        configuration:
          type: object
          description: A push-notification config here is refused with PushNotificationNotSupportedError (we never push).
        metadata:
          type: object
        tenant:
          type: string
  securitySchemes:
    SessionToken:
      type: apiKey
      in: header
      name: X-Session-Id
      description: 'The workspace session UUID is a capability token carried in the URL PATH (not this header — shown here only because OpenAPI securitySchemes cannot model a path parameter as a credential). A valid request must present a well-formed UUID-v4 in the path segment {session_id} AND a first-party Origin/Referer (or none). Requests carrying a known-foreign Origin/Referer are refused 403. Per-IP rate limiting applies. All responses carry Referrer-Policy: strict-origin-when-cross-origin.'
    NdaSigned:
      type: apiKey
      in: header
      name: X-Nda-Signed
      description: 'Precondition (not a literal header): a server-side NDA signature for {session_id} must be recorded in the nda_signatures table via POST /api/nda/sign before NDA-gated resources (/api/matched-names, /api/infomemo/*) will serve data. Recorded signatures are enforced server-side (helper `nda_signed`), not by trusting a client header.'
x-provenance:
  method: harvested
  publisher: Cape Partners
  source: https://www.capepartners.fr/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)