Agent / MCP docs

ArchiScale runs a remote MCP server (Streamable HTTP):

https://archiscale.stlgalaxy.com/mcp
Authorization: Bearer sk-sp-YOUR-FIRM-KEY

To get a key, buy an Agent API or Studio plan. Keys belong to a firm, and a key's seat count limits how many sessions can run at once. Keep your key secret.

Clients with remote MCP support

{
  "mcpServers": {
    "archiscale": {
      "url": "https://archiscale.stlgalaxy.com/mcp",
      "headers": { "Authorization": "Bearer sk-sp-YOUR-FIRM-KEY" }
    }
  }
}

Clients without header support (mcp-remote)

{ "mcpServers": { "archiscale": { "command": "npx",
  "args": ["-y", "mcp-remote", "https://archiscale.stlgalaxy.com/mcp", "--header", "Authorization: Bearer ${ARCHISCALE_KEY}"],
  "env": { "ARCHISCALE_KEY": "sk-sp-..." } } } }

Large files

curl -X POST https://archiscale.stlgalaxy.com/uploads \
  -H "Authorization: Bearer $ARCHISCALE_KEY" -H "X-Filename: plan.dxf" --data-binary @plan.dxf
# then call upload_plan { upload_id, filename }

Tools

• create_project, get_project: create a project from a title or coordinates, then read its state
• upload_plan: import DXF or SKP
• run_regs_check: ResCode (Victoria) check
• propose_change, list_pending, approve_change, reject_change, approval_log: no model change is committed until an architect approves it
• export_working_drawings, generate_elevations, generate_sections, generate_3d_model
• list_finishes, set_finishes, render

Any geometry ArchiScale infers comes back with an explicit flag (for example UNITS_INFERRED, FRONT_EDGE_UNCONFIRMED). Review these flags before you rely on the output. Usage is logged per firm (tool, time, duration, ok). Tool arguments are never logged. Health check: GET https://archiscale.stlgalaxy.com/healthz.