SignalHarness.ai

Discover the currently enabled public SignalHarness service catalog before choosing a service. This free, read-only call takes no arguments and returns a compact service array with canonical IDs, descriptions, prices, and supported payment metadata. Results follow the canonical catalog order; compare services by their exact service_id.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "schemaVersion": {
      "description": "Catalog schema version when supplied by the runtime."
    },
    "services": {
      "type": "array",
      "description": "Enabled public services in canonical catalog order. Each item includes its exact service ID and available discovery and payment fields.",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "error": {
      "type": "string",
      "description": "Stable machine error code when catalog discovery fails."
    }
  },
  "description": "A compact public catalog response, or a normalized machine-readable error.",
  "additionalProperties": true
}

Inspect one enabled public SignalHarness service before invoking it. Use an exact service_id returned by list_services. This free, read-only call returns the canonical description, input and output schemas, price, endpoint, and supported payment metadata when available; an unknown or disabled ID returns a normalized not-found error.

{
  "type": "object",
  "properties": {
    "service_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,159}$",
      "description": "Exact canonical service ID from list_services; matching is case-sensitive and aliases are not accepted."
    }
  },
  "required": [
    "service_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "service_id": {
      "type": "string",
      "description": "Exact canonical service ID."
    },
    "input_schema": {
      "type": "object",
      "description": "JSON Schema the invoke_service input must satisfy."
    },
    "output_schema": {
      "type": "object",
      "description": "JSON Schema describing the service-specific success result."
    },
    "error": {
      "type": "string",
      "description": "Stable machine error code when the service cannot be returned."
    }
  },
  "description": "Canonical public service metadata, or a normalized machine-readable error.",
  "additionalProperties": true
}

Run exactly one enabled public SignalHarness service with caller-supplied input. Call get_service first and validate input against its input_schema. An unpaid call returns the canonical x402 V2 PAYMENT-REQUIRED challenge plus the equivalent x402 V1 JSON challenge; a client can then retry once with payment in params._meta["x402/payment"]. The server never retries automatically. A paid call may settle the advertised charge and perform external work, then returns service-specific structured JSON or a normalized error.

{
  "type": "object",
  "properties": {
    "service_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,159}$",
      "description": "Exact canonical ID of an enabled public service, obtained from list_services."
    },
    "input": {
      "type": "object",
      "description": "Caller-supplied job data. It must satisfy the selected service input_schema returned by get_service."
    },
    "request_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,159}$",
      "description": "Optional caller-generated request identifier for tracing this attempt. Never place secrets or payment credentials in it."
    },
    "idempotency_key": {
      "type": "string",
      "pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]{0,159}$",
      "description": "Optional stable key for retrying the same logical job safely. Reuse it only for recovery of that same job and payment."
    }
  },
  "required": [
    "service_id",
    "input"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "description": "Stable machine error code for unpaid, invalid, failed, or unavailable requests."
    }
  },
  "description": "Service-specific structured JSON, an unpaid x402 challenge, or a normalized machine-readable error. Inspect get_service.output_schema for the selected service success shape.",
  "additionalProperties": true
}