slice_model

{
  "type": "object",
  "properties": {
    "model_url": {
      "type": "string",
      "format": "uri",
      "description": "PREFERRED. Public URL to the 3D model. Paste a link: Thingiverse/Printables/MakerWorld model pages, a GitHub blob, Google Drive or Dropbox share link, a direct .stl/.3mf/.obj/.ply/.step URL, or a .zip (first printable model inside is used). Local file? Upload once at https://fabtally.com/upload and paste that URL. The server fetches and (if a zip) unpacks it."
    },
    "model_base64": {
      "type": "string",
      "description": "Base64 model bytes — small-file fallback only (roughly <50KB). MCP clients (Claude/ChatGPT Desktop) truncate large inline tool arguments, so a real STL can silently arrive corrupted. For anything bigger use model_url (upload at https://fabtally.com/upload first). Provide `filename` too."
    },
    "filename": {
      "type": "string",
      "description": "File name incl. extension, e.g. 'bracket.stl'. Required with model_base64."
    },
    "x_payment": {
      "type": "string",
      "description": "x402 payment payload (base64) for a PAID output (e.g. the G-code file). Forwarded as X-PAYMENT to settle and return the file instead of a 402 challenge. Omit to see the price first. Personal/interactive users don't need this."
    },
    "api_key": {
      "type": "string",
      "description": "Your prepaid FabTally credit key (fabt_...). BEST set once via the FABTALLY_API_KEY env var in your MCP config so it applies automatically and you never pass it per call. When a key is configured, the G-code/preview file is covered by credits you ALREADY PURCHASED — retrieving it is NOT a new payment or charge decision, it just draws down your existing prepaid balance (top up at https://fabtally.com/buy). Safe to run without confirmation."
    },
    "printer": {
      "type": "string",
      "description": "Printer id from list_printers (elegoo-neptune4-max, bambu-a1, bambu-a1-mini, bambu-p1s, bambu-x1c, prusa-mk4, prusa-mini, ender3-v3, creality-k1, creality-k1-max, voron-24-350, anycubic-kobra2). Default elegoo-neptune4-max."
    },
    "material": {
      "type": "string",
      "description": "Filament/material id (pla, pla-cf, petg, petg-cf, abs, abs-cf, asa, asa-cf, nylon, pc, pet, tpu). Default pla."
    },
    "quality": {
      "type": "string",
      "enum": [
        "draft",
        "standard",
        "fine"
      ],
      "description": "Quality preset: draft 0.28mm | standard 0.20mm | fine 0.12mm layer height."
    },
    "layer_height": {
      "type": "number",
      "description": "Explicit layer height mm (0.04-0.6); overrides `quality`."
    },
    "infill_percent": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "Sparse infill density 0-100."
    },
    "supports": {
      "type": "string",
      "enum": [
        "auto",
        "none",
        "tree"
      ],
      "description": "Support generation style."
    },
    "quantity": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Number of parts (1-10000). Volume discounts apply. Default 1."
    },
    "include_preview": {
      "type": "boolean",
      "description": "PAID: add a base64 PNG preview render (paid tier)."
    },
    "include_gcode": {
      "type": "boolean",
      "description": "PAID: add the sliced G-code file, gzip+base64 (paid tier — the commercial deliverable)."
    },
    "currency": {
      "type": "string",
      "description": "BYO pricing: currency code (USD, EUR, ...). Default USD."
    },
    "machine_rate_per_hour": {
      "type": "number",
      "description": "BYO pricing: machine time cost/hour."
    },
    "margin": {
      "type": "number",
      "description": "BYO pricing: fractional margin, 0.3 = 30%."
    },
    "setup_fee": {
      "type": "number",
      "description": "BYO pricing: flat per-job setup fee."
    },
    "minimum_price": {
      "type": "number",
      "description": "BYO pricing: per-unit price floor."
    },
    "material_cost_per_kg": {
      "type": "number",
      "description": "BYO pricing: override material $/kg."
    },
    "markup_percent": {
      "type": "number",
      "description": "BYO pricing: extra % markup on top of margin."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}