# Rekayo for AI agents

Rekayo is an instant-quote manufacturing service in Bandung, Indonesia, for FDM 3D printing, acrylic and wood laser cutting, metal plate laser cutting and bending, and PCB fabrication. AI agents can read the design rules, quote designs, see exactly where a design breaks a rule, and manage project revisions for a signed-in person through the Rekayo MCP server.

## Connect

- MCP server: `https://rekayo.com/mcp`
- Transport: Streamable HTTP
- Auth: OAuth 2.1 with PKCE. Dynamic client registration is supported. The first request returns `401` with a `WWW-Authenticate` header that points to the protected resource metadata. Open the browser so the person can sign in with their Rekayo account and approve access.
- Protected resource metadata: `https://rekayo.com/.well-known/oauth-protected-resource/mcp`
- Server card: `https://rekayo.com/.well-known/mcp/server-card.json`
- Human setup page: `https://rekayo.com/agents`

Do not ask the person for a token or password. The MCP client handles sign-in and token refresh.

### Client setup

| Client | Setup |
| --- | --- |
| Claude Code | `claude mcp add --transport http rekayo https://rekayo.com/mcp`, then `/mcp` to sign in |
| Claude Desktop, claude.ai | Settings > Connectors > Add custom connector > `https://rekayo.com/mcp` |
| Codex | `codex mcp add rekayo --url https://rekayo.com/mcp`, then `codex mcp login rekayo` |
| Gemini CLI | `gemini mcp add --transport http rekayo https://rekayo.com/mcp`, then `/mcp auth rekayo` |
| Cursor, VS Code, others | `{"mcpServers": {"rekayo": {"url": "https://rekayo.com/mcp"}}}` (Windsurf uses `serverUrl`) |

## Processes

| `process_id` | Files | Notes |
| --- | --- | --- |
| `fdm_3d` | STL in mm | Walls, details, object size and build volume are checked |
| `laser_cut` | DXF in mm | Acrylic and wood. Integer `thickness_mm` from the material options |
| `sheet_metal` | STEP, or flat DXF in mm | Metal plate cut and bent. One part per STEP. `thickness_mm` needed for DXF |
| `pcb_fabrication` | One Gerber ZIP | Two layer standard preset |

## Tools

| Tool | Purpose |
| --- | --- |
| `discover_processes` | Supported processes and file formats |
| `get_design_rules` | Every limit for a process: requirement with numbers, whether it blocks the order, cause, fix, and what is not checked |
| `get_material_options` | Materials, thicknesses and settings for a process |
| `list_projects`, `create_project`, `get_project` | Saved projects and revision history |
| `create_upload_link` | One-time signed upload URL and a ready `curl -T` command, for agents with a shell |
| `submit_design` | Quote an STL, DXF, STEP or Gerber ZIP by `upload_id`, or inline base64 up to 2 MiB |
| `get_manufacturing_result` | Poll a quote until `completed` or `failed`; includes `design_feedback` |
| `save_revision` | Attach a completed quote to a project with notes |
| `get_review_link` | Private project page for the person to review and order |

## Workflow

1. Call `get_design_rules` and `get_material_options` for the process before designing or quoting.
2. Upload: if you can run shell commands, call `create_upload_link` and run its `curl_command`. Otherwise send small files inline.
3. Call `submit_design`, then poll `get_manufacturing_result`.
4. Read `design_feedback`. Fix every finding with `blocks_order: true`, upload the changed design, and quote again.
5. Call `save_revision`. Give the person the `get_review_link` URL.

## Design feedback

Each finding in `design_feedback` (from `get_manufacturing_result`, or in the tool error when a request is rejected) has:

- `code` and `rule_id`: the engine check and the rule from `get_design_rules` it belongs to.
- `severity` and `blocks_order`: a blocking finding must be fixed before the design can be ordered.
- `message`: the engine's own text, often in Indonesian.
- `where` and `locations`: the bend, path or object, and coordinates in mm. `space` names the frame: `model_mm` (the uploaded 3D model), `flat_mm` (the unfolded sheet metal pattern), `drawing_mm` (the 2D DXF), or `posed_bed_mm` (the FDM part as placed on the printer bed).
- `measured`, `limit`, `unit`: how far the design is from the limit.
- `cause` and `fix`: why the limit exists and how to meet it.

## Limits

- Prices come from the Rekayo backend. Never calculate or promise a price yourself.
- Agents cannot pay, place orders, or start production. The person reviews and orders in the browser through hosted checkout.
- Results report the checks listed by `get_design_rules` only (see its `not_checked`). No findings does not prove strength, assembly fit, or fitness for use.
- All files use millimeters.
