Reference

Agent docs

Maichine is a thin integration layer. Your agent keeps full control of 3D modeling; Maichine handles auth, storage, preview, color mapping, quotes, human review, and production.

Start here

Install the skill

Copy this into your agent. It tells the agent to fetch the raw SKILL.md, save it wherever its own persistent skill system expects it, persist the origin and key, and verify bootstrap. No folder assumptions.

Raw SKILL.md ↗Install page
Install Maichine. Fetch https://maichine-agent-forge.lovable.app/agent-onboarding/SKILL.md and save that exact file verbatim in your own persistent skill/rules/memory system so it loads in future sessions. Do not summarize or rewrite it. Persist MAICHINE_ORIGIN=https://maichine-agent-forge.lovable.app and MAICHINE_KEY=<MAICHINE_KEY> in your own secret/env config. Then verify with GET https://maichine-agent-forge.lovable.app/api/public/v1/bootstrap using Authorization: Bearer MAICHINE_KEY. Reply with the place you saved the Skill and whether bootstrap succeeded.
Everything for a task

One bootstrap call

A single authenticated request returns capabilities, upload formats and limits, the live production color palette, and endpoint URLs. Cache it for the current task.

GET /api/public/v1/bootstrap
Authorization: Bearer mk_live_...
Capabilities JSON ↗Supported formats
Sync + configure + produce

REST API

Authenticate every request with a Bearer API key.

  • GET /api/public/v1/bootstrap — one-shot auth + capabilities
  • POST /api/public/v1/projects — create a project
  • POST /api/public/v1/projects/:id/versions — upload a validated STL or standard 3MF (multipart)
  • GET /api/public/v1/projects/:id/versions/:versionId — poll version status
  • PATCH /api/public/v1/projects/:id/color-mapping — swap production colors without re-uploading geometry
  • POST /api/public/v1/quotes — lock a credit price, returns a confirmation URL
  • POST /api/public/v1/production-requests — submit a confirmed quote (Idempotency-Key required)
Read the API referenceRaw markdown ↗
Secure setup

API keys

Mint and manage keys in Integrations. Keys are shown once; store them in your agent's env as MAICHINE_KEY.

Open Integrations
For MCP-native clients

MCP

maichine also exposes an MCP endpoint. Register the server URL below in your MCP client; auth uses OAuth against your maichine account.

https://maichine-agent-forge.lovable.app/mcp