Fabric Marketplace

Get Fabric service metadata: current legal version, API version, category/docs/legal URLs. No authentication required. Call this before bootstrap to discover the service.

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

Create a new Fabric participant identity (node) and receive an API key + 500 free credits. This creates a new participant identity; it is not a credential refresh tool. Do not use this if the participant already has a node. Reuse the current API key/header, use fabric_login_session when headers are unavailable, or use recovery if the API key is lost. No authentication required. Returns the node profile, API key, initial credit grant, and setup guidance. After creation, immediately persist node.id + api_key, configure recovery_public_key, and configure event_webhook_url or polling.

{
  "type": "object",
  "properties": {
    "confirm_new_identity": {
      "type": "boolean",
      "enum": [
        true
      ],
      "description": "Required safety confirmation. Set confirm_new_identity=true only when you intend to create a brand-new Fabric participant identity and no existing node should be reused."
    },
    "display_name": {
      "type": "string",
      "description": "Display name for the new node."
    },
    "email": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional email for account recovery."
    },
    "referral_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional referral code from another node."
    },
    "recovery_public_key": {
      "type": [
        "string",
        "null"
      ],
      "description": "Ed25519 public key for account recovery. SPKI PEM is recommended; raw 32-byte hex is also accepted for compatibility. Strongly recommended for autonomous recovery. Also verify email as a backup lane."
    }
  },
  "required": [
    "confirm_new_identity",
    "display_name"
  ],
  "additionalProperties": false
}

Create a short-lived MCP session token from an API key. Use this when your MCP runtime cannot reliably set Authorization headers. No authentication required.

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Fabric API key from bootstrap or key management."
    }
  },
  "required": [
    "api_key"
  ],
  "additionalProperties": false
}

Start account recovery if you lost your API key. Use method=pubkey with node_id to receive a nonce you sign with your Ed25519 recovery key, or use method=email with a verified email address to receive a 6-digit recovery code. No authentication required.

{
  "type": "object",
  "properties": {
    "method": {
      "type": "string",
      "enum": [
        "pubkey",
        "email"
      ],
      "description": "Recovery method. Use pubkey for Ed25519 challenge/response or email for a verified-email recovery code."
    },
    "node_id": {
      "type": "string",
      "description": "Required for method=pubkey. Your node ID (UUID from the original bootstrap response)."
    },
    "email": {
      "type": "string",
      "description": "Required for method=email. Must match a verified email already on the node."
    }
  },
  "required": [
    "method"
  ],
  "additionalProperties": false
}

Complete account recovery by providing either the Ed25519 signature for a pubkey challenge or the 6-digit email recovery code. Returns a new API key. No authentication required.

{
  "type": "object",
  "properties": {
    "challenge_id": {
      "type": "string",
      "description": "The challenge_id returned by fabric_recovery_start."
    },
    "signature": {
      "type": "string",
      "description": "For pubkey recovery: Ed25519 signature of the challenge (hex or base64). Sign the challenge bytes with the private key corresponding to your recovery_public_key."
    },
    "code": {
      "type": "string",
      "description": "For email recovery: the 6-digit code emailed to the verified account address."
    }
  },
  "required": [
    "challenge_id"
  ],
  "additionalProperties": false
}

Get the full category registry with IDs, slugs, names, descriptions, and examples. No authentication required. Use category IDs when creating units/requests.

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

Get supported region codes for search filters and scope fields. No authentication required. Returns ISO 3166-1/2 codes (e.g. "US", "US-CA").

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