API & AgentsTools & resources

Get a quote before signing up

Agents with HTTP and file access can start a temporary RMFG project, upload a STEP file, and get real manufacturability feedback and pricing without a browser login. Give the customer the private claim link when the work is ready.

Start here when you have no RMFG credentials. Creating a project needs no Authorization header. If already connected, use your existing account. An agent that only supports MCP must connect an account first.

1. Create a project
curl https://api.rmfg.com/v1/agent-projects \
  -H 'Content-Type: application/json' \
  -d '{"name":"Mounting bracket"}'

Save the returned key privately as RMFG_PROJECT_KEY. Keep claim_url for the customer. Neither credential should appear in public logs, source control, or shared chat channels.

2. Upload a STEP file
curl https://api.rmfg.com/v1/analyze \
  -H "Authorization: Bearer $RMFG_PROJECT_KEY" \
  -H 'Idempotency-Key: bracket-upload-1' \
  -F file=@bracket.step

Poll the returned status_url at https://api.rmfg.com with the same credential while the status is queued or processing. Continue when ready; stop and report failures instead of uploading repeatedly. Use the returned design and part IDs. Read GET /v1/materials for sheet or GET /v1/tube-profiles for tube, following pagination, and select returned catalog IDs. Never guess an ID or substitute a material without the customer’s approval.

3. Request a quote
curl https://api.rmfg.com/v1/quotes \
  -H "Authorization: Bearer $RMFG_PROJECT_KEY" \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: bracket-quote-1' \
  -d '{"items":[{"design_id":"DESIGN_ID","quantity":1,"configuration":{"defaults":{"material_id":"MATERIAL_ID"}}}]}'

This example is for a sheet part. Use tube_profile_id for tube and per-part configuration for mixed assemblies. Show all DFM findings and resolve requires_input or blocked results; never accept a manufacturing risk without the customer’s agreement. Use a new Idempotency-Key when inputs change and reuse the same key only for identical retries. Prices are integer US cents and exclude shipping and tax. For detailed DFM, use POST /v1/dfm. Upload files through /v1/analyze; temporary projects accept JSON quote requests only.

Hand the work to your customer

Send claim_url. It shows the project’s completed files and quote summaries. The customer signs in or creates an account, then explicitly claims the project. Existing analysis, configurations and quotes move to that account; in-progress uploads follow it. The customer can then review parts and use normal checkout.

Claiming does not charge a card or place an order. The temporary key stops working after claim. To continue, connect the agent using the customer’s authenticated MCP connection or account API key. Temporary keys are REST-only and do not authenticate hosted MCP.

Limits and expiry

A project lasts seven days and permits three uploads (50 MB each), thirty DFM/quote/image requests, and 2,000 API requests. Attempts, including retries, consume the budget. Claim it to continue through an account. Projects cannot pay, access saved cards, place orders, or read another project’s files. Quotes accept at most ten items. Review links returned by design endpoints become usable after claim; use the project’s claim link for the initial handoff.

Issuance is limited to five projects per network address per day and a shared pilot capacity. A 429 response means the budget or capacity has been reached: honor Retry-After when present and do not create projects to bypass limits. A 410 means the project expired or was claimed; stop using that key. Expired projects cannot be claimed; sign in to continue with an account. See the API reference for request schemas and error details.