Fractera

Register a new Fractera user and start the deployment of their server in one atomic call. Use this AFTER you have collected the user's email (entered twice for typo protection), server IP, and root password. Creates the User row (or reuses an existing one with the same email), creates a free Subscription, creates a ServerToken, wipes any previous installation on the target server, and launches bootstrap. The deploy is IP-first (phase-1): the server comes up on plain HTTP at http://<IP>:3002 in 8-14 minutes; it does NOT get a domain or HTTPS cert here (that is an optional later step inside the workspace). Returns session_id (for a single on-demand check_status read — do not poll) and server_token (so the user can recover via retry_deploy if anything breaks). Call this AT MOST ONCE per conversation.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The email the user typed (and confirmed by re-typing). Welcome / failure emails go here."
    },
    "email_confirmed": {
      "type": "boolean",
      "description": "REQUIRED, must be true. Set this ONLY after the user has typed their email a SECOND time (Q2) and the two entries match (case-insensitive, trimmed). Do not set it if you only asked once."
    },
    "ip": {
      "type": "string",
      "description": "IPv4 address of the user's VPS, e.g. 185.10.20.30."
    },
    "password": {
      "type": "string",
      "description": "Root password for the VPS."
    },
    "login": {
      "type": "string",
      "description": "Optional — defaults to \"root\". Override only if the VPS provider gave a non-root username."
    },
    "components_selected": {
      "type": "boolean",
      "description": "REQUIRED, must be true. Nothing is selectable any more — every server gets the same set — so this only records that you TOLD the user what gets installed (Q5): the app, the database and file storage with vector memory, sign-in, and the control panel."
    },
    "terms_accepted": {
      "type": "boolean",
      "description": "REQUIRED, must be true. Set this ONLY after the user has explicitly confirmed in the chat that they (1) have read and agree to Fractera's Terms of Service (https://www.fractera.ai/en/terms) and Privacy Policy (https://www.fractera.ai/en/privacy), and (2) understand they MUST change their server root password immediately after installation — Fractera never stores it and has no way to access the server afterwards. If the user has not given this explicit agreement, do NOT call this tool: ask for it first (and offer to explain the documents right in the chat)."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "es",
        "fr",
        "it",
        "ru",
        "de",
        "pt",
        "pl",
        "tr",
        "nl"
      ],
      "description": "Optional — the two-letter code of the language the user is talking to you in (e.g. \"ru\" if the conversation is in Russian). Their new app is built in English PLUS this language, and this language becomes its default; pass \"en\" or omit for an English-only app. Adding more languages later is a switch in the Admin panel, so this is not a permanent choice — it just means their site opens in their own language from the first minute."
    }
  },
  "required": [
    "email",
    "email_confirmed",
    "ip",
    "password",
    "components_selected",
    "terms_accepted"
  ]
}

Read the current installation progress ONCE, on demand. Call this only when the user explicitly asks how the deploy is going (e.g. "what is the status", "did it finish") — never on a timer and never in a polling loop. The deploy takes 8-14 minutes and the authoritative status channels are the email pipeline + the dashboard; one read on request is enough. Returns the current step, the list of completed steps (~44 total in a full bootstrap), and whether installation is done or failed.

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "The session_id returned by register_and_deploy or retry_deploy."
    }
  },
  "required": [
    "session_id"
  ]
}

Return the final entry address of the server once installation is complete. In phase-1 (IP-first) this is a plain-HTTP Admin URL of the form http://<IP>:3002 — the server has NO domain and NO HTTPS cert yet (attaching a custom domain with HTTPS is an optional later step the user does inside Admin -> Personal Domain). Call this once after check_status reports status="done".

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "The session_id used during installation."
    }
  },
  "required": [
    "session_id"
  ]
}

Retry a failed deployment using a server_token (from the failure email, the deploy-progress UI, or the dashboard). Wipes the previous broken install and runs a fresh deploy on the SAME server. Returns a new session_id — poll with check_status. Use this when the user reports a failed deploy or pastes a server_token.

{
  "type": "object",
  "properties": {
    "server_token": {
      "type": "string",
      "description": "The unique server token the user received in the deploy-failure email, the active deploy UI, or the dashboard. Acts as the authorisation for this retry."
    },
    "ip": {
      "type": "string",
      "description": "Optional — only pass if the user discovered the original IP was wrong (e.g. typo). Otherwise the stored IP is used."
    },
    "login": {
      "type": "string",
      "description": "Optional — Linux user, defaults to root."
    },
    "password": {
      "type": "string",
      "description": "Optional — only pass if the user discovered the original password was wrong. Otherwise the stored password is used."
    }
  },
  "required": [
    "server_token"
  ]
}

Return a single recommended VPS provider for users who do not yet have a server. Call this ONLY when the user explicitly says they have no server. The user buys the VPS at this provider and comes back with IP + password.

{
  "type": "object",
  "properties": {},
  "required": []
}

Project reference / help desk about Fractera. Use this to answer ANY user question about what Fractera is, how it works, its architecture, components, modes, data ownership, pricing, use cases, partner program, etc. — especially while a deploy is running and the user wants to learn more. TOKEN-ECONOMY: call with NO arguments first to get the lightweight list of section ids+titles, then call again with a single `section` id to fetch just that section. NEVER try to fetch everything at once; pull only the section(s) relevant to the user question. Set `lang:"ru"` for Russian-speaking users.

{
  "type": "object",
  "properties": {
    "section": {
      "type": "string",
      "description": "A section id from the list returned when called with no section. Omit to get the list (table of contents) first."
    },
    "lang": {
      "type": "string",
      "enum": [
        "en",
        "ru"
      ],
      "description": "Language of the returned content. Defaults to \"en\". Use \"ru\" for Russian-speaking users."
    }
  },
  "required": []
}