Skip to main content

Spectral API and MCP documentation

Create structural models through the public Model API workflow, then connect model-aware agent clients through the Spectral MCP server.

Guide

Create a model

Follow the public model-creation workflow for a structural model.

  • Create the construct model shell.
  • Add nodes, frames, areas, materials, sections, and supports.
  • Fetch the viewer-ready payload.
API

Model creation API

Browse only the public create, upload, import, and viewer payload endpoints.

  • Generated from the public OpenAPI allowlist.
  • Includes request bodies, response statuses, schemas, and examples.
  • Do not edit generated endpoint pages by hand.
MCP

Connect MCP clients

Prepare Spectral for ChatGPT, Codex, Claude Code, and Cursor.

  • Use the remote HTTP MCP endpoint.
  • Set up ChatGPT, Codex, Claude Code, or Cursor.
  • Review write tool calls before approving them.
Setup

Start with authentication

Set up OAuth-first access for API and MCP workflows.

  • Issuer: viewer.spectralco.co.
  • Scopes: mcp:models:read and mcp:models:write.
  • Keep credentials outside source control.