Hive Civilization Xcalibur API

The xcalibur API from Hive Civilization — 6 operation(s) for xcalibur.

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v1/xcalibur/echo/v2/compress Compress a prompt with ECHO v2 · Compress #
Ask an LLM
“Can I shrink a long prompt while keeping what matters for my task?”
“How do I set a target compression ratio and a minimum preservation score?”
Tell an agent
Compress this prompt with ECHO: {prompt}.
Compress {prompt} to ratio {target_ratio} for the task {task_query}.
GET /v1/xcalibur/echo/v2/health Check ECHO v2 compressor health · Health #
Ask an LLM
“Is the ECHO v2 prompt compressor up?”
“Can I health-check the compression endpoint before sending prompts?”
Tell an agent
Check ECHO v2 compressor health.
Ping the prompt compression service.
POST /v1/xcalibur/membrane/v2/classify Classify text as safe or unsafe · Classify #
Ask an LLM
“How do I check whether a piece of text is a prompt injection or otherwise unsafe?”
“Can I adjust the threshold and per-model weights of the MEMBRANE safety ensemble?”
Tell an agent
Classify {text} as safe or unsafe.
Run MEMBRANE on {text} with an unsafe threshold of {threshold}.
GET /v1/xcalibur/membrane/v2/health Check MEMBRANE v2 classifier health · Health #
Ask an LLM
“Is the MEMBRANE safety classifier available?”
“Can I health-check MEMBRANE without loading its models?”
Tell an agent
Check MEMBRANE v2 health.
Ping the safety classifier service.
POST /v1/xcalibur/verify/v2/attest Attest a data chunk belongs to a signed corpus · Attest #
Ask an LLM
“How do I prove a chunk is in a corpus and was signed by a specific post-quantum key?”
“Which signature algorithms does the attestation ensemble cross-check?”
Tell an agent
Attest chunk {chunk} against corpus root {corpus_root} with signature {signature_hex} and key {signer_pubkey_hex}.
Verify {chunk} is under root {corpus_root} via path {expected_path}, signed {signature_hex} by {signer_pubkey_hex}.
GET /v1/xcalibur/verify/v2/health Check VERIFY v2 attestation health · Health #
Ask an LLM
“Is the VERIFY v2 corpus attestation endpoint up?”
“Can I health-check attestation without loading the PQ libraries?”
Tell an agent
Check VERIFY v2 attestation health.
Ping the corpus attestation service.

Documentation

Specifications

Other Resources

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/thehiveryiq-com:thehiveryiq-com-xcalibur-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

thehiveryiq-com-xcalibur-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: HiveMorph v0.1 Xcalibur API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: xcalibur
paths:
  /v1/xcalibur/echo/v2/compress:
    post:
      tags:
      - xcalibur
      summary: Compress
      operationId: compress_v1_xcalibur_echo_v2_compress_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CompressV2Request'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Compress V1 Xcalibur Echo V2 Compress Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/xcalibur/echo/v2/health:
    get:
      tags:
      - xcalibur
      summary: Health
      operationId: health_v1_xcalibur_echo_v2_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Health V1 Xcalibur Echo V2 Health Get
  /v1/xcalibur/membrane/v2/classify:
    post:
      tags:
      - xcalibur
      summary: Classify
      description: 'Classify a text as SAFE or UNSAFE using the MEMBRANE v2 ensemble.


        Returns a signed receipt with:

        - verdict: SAFE | UNSAFE

        - candidate_scores: per-model score

        - final_score: weighted ensemble score

        - receipt_id, timestamp, input_hash, signature'
      operationId: classify_v1_xcalibur_membrane_v2_classify_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__xcalibur__membrane_v2_routes__ClassifyRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Classify V1 Xcalibur Membrane V2 Classify Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/xcalibur/membrane/v2/health:
    get:
      tags:
      - xcalibur
      summary: Health
      description: Health check — does not load models.
      operationId: health_v1_xcalibur_membrane_v2_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Health V1 Xcalibur Membrane V2 Health Get
  /v1/xcalibur/verify/v2/attest:
    post:
      tags:
      - xcalibur
      summary: Attest
      description: 'Corpus-attestation ensemble endpoint.


        Validates Merkle membership + external PQ signature + runs cross-family

        ensemble (ML-DSA-65 reference, ML-DSA-65 deterministic, SLH-DSA-SHA2-128s,

        Ed25519). Returns signed XCALIBUR VERIFY v2 receipt.


        Verdict PASS requires unanimity across all ensemble candidates.'
      operationId: attest_v1_xcalibur_verify_v2_attest_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/hivemorph__xcalibur__verify_v2_routes__AttestRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Attest V1 Xcalibur Verify V2 Attest Post
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/xcalibur/verify/v2/health:
    get:
      tags:
      - xcalibur
      summary: Health
      description: Health check — does not load heavy PQ libraries.
      operationId: health_v1_xcalibur_verify_v2_health_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                title: Response Health V1 Xcalibur Verify V2 Health Get
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    hivemorph__xcalibur__membrane_v2_routes__ClassifyRequest:
      properties:
        text:
          type: string
          minLength: 1
          title: Text
          description: Text to classify for safety/injection
        threshold:
          type: number
          maximum: 1.0
          minimum: 0.0
          title: Threshold
          description: Decision threshold for unsafe classification (default 0.5)
          default: 0.5
        weights:
          anyOf:
          - additionalProperties:
              type: number
            type: object
          - type: 'null'
          title: Weights
          description: 'Per-candidate weights (must sum to ~1.0). Keys: toxic_bert, deberta_pi, membrane_v1, keyword_heuristic. Uses calibrated defaults if omitted.'
      type: object
      required:
      - text
      title: ClassifyRequest
    hivemorph__xcalibur__verify_v2_routes__AttestRequest:
      properties:
        chunk:
          type: string
          minLength: 1
          title: Chunk
          description: The data chunk to attest, as a UTF-8 string (hex-encode binary).
        corpus_root:
          type: string
          title: Corpus Root
          description: Expected Merkle root (hex) of the corpus.
        expected_path:
          items:
            additionalProperties:
              type: string
            type: object
          type: array
          title: Expected Path
          description: 'Merkle inclusion path. Each element: {"sibling": "<hex>", "position": "left"|"right"}. Empty list means leaf IS the root (single-element corpus).'
        signature_hex:
          type: string
          title: Signature Hex
          description: Signer's PQ signature over chunk (hex).
        signer_pubkey_hex:
          type: string
          title: Signer Pubkey Hex
          description: Signer's PQ public key (hex).
        alg:
          type: string
          title: Alg
          description: 'PQ signature algorithm used by signer. Default: ML-DSA-65.'
          default: ML-DSA-65
        run_slhdsa:
          type: boolean
          title: Run Slhdsa
          description: Include SLH-DSA cross-family witness in ensemble (slower but stronger).
          default: true
      type: object
      required:
      - chunk
      - corpus_root
      - signature_hex
      - signer_pubkey_hex
      title: AttestRequest
    CompressV2Request:
      properties:
        prompt:
          type: string
          minLength: 1
          title: Prompt
        task_query:
          anyOf:
          - type: string
          - type: 'null'
          title: Task Query
          description: Output-conditioned hint, e.g. 'Summarize this report.' Defaults to a generic summarize prompt if omitted.
        target_ratio:
          type: number
          exclusiveMaximum: 1.0
          exclusiveMinimum: 0.0
          title: Target Ratio
          description: Compressed length ≤ target_ratio × original (0.5 = 2x compression).
          default: 0.5
        min_preservation:
          type: number
          maximum: 1.0
          minimum: 0.0
          title: Min Preservation
          description: Reject candidates scoring below this oracle threshold; the selector picks best regardless and flags if below.
          default: 0.0
      type: object
      required:
      - prompt
      title: CompressV2Request
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
x-provenance:
  method: harvested
  publisher: Hive Civilization
  source: https://receipts.thehiveryiq.com/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)