API docs
One API, two ways in: REST for scripts, MCP for agents. The catalog, prices and home page highlights need no key; reading subscriber guides, placing bank-transfer orders and checking your account's access need an API key.
Overview
Every path below is relative to this base URL. Responses are JSON.
https://api.modernengineer.devAuthentication
Create an API key in API key management, then send it in an Authorization: Bearer <key> header. The key is shown once, when you create it. Public verbs (catalog, articles.list, pack-versions, spotlight, prices) need no key. POST and PATCH verbs take their parameters in a JSON body, sent with a Content-Type: application/json header.
Limits & errors
| Applies to | Limit |
|---|---|
| Paid guide reads (content.get) | 1,000 in 24 hours, per account |
| File pack and visual links (packs.download, visuals.issueUrl) | 50 links in 24 hours, per account |
| Bank-transfer orders (orders.create) | 20 orders per hour, per account |
| Discount code quotes (orders.quote) | 30 per hour, per account |
| Facebook claim codes (claims.redeem) | 10 attempts per hour, per account |
| The /mcp endpoint | 300 per minute, per IP |
Every error comes back in the same JSON shape, with a requestId to quote when reporting it. Some add details: invalid_input lists the rejected fields in details.issues, and unprocessable gives the reason in details.reason.
{
"error": {
"code": "not_found",
"message": "Content item was not found",
"requestId": "…"
}
}| Status | Error |
|---|---|
| 400 | invalid_input |
| 401 | unauthenticated |
| 403 | forbidden |
| 403 | insufficient_scope |
| 404 | not_found |
| 405 | method_not_allowed |
| 409 | conflict |
| 422 | unprocessable |
| 429 | too_many_requests |
| 500 | internal_error |
| 503 | service_unavailable |
MCP setup
Declare it once in an MCP client and replace <API key> with the key you created (JSON config does not expand environment variables; use your client's own variable syntax if it has one). It uses the same API key as REST.
{
"mcpServers": {
"modernengineer": {
"type": "http",
"url": "https://api.modernengineer.dev/mcp",
"headers": {
"Authorization": "Bearer <API key>"
}
}
}
}Tool list
Every verb an API key can call. Each has a REST path and an MCP tool with the same parameters. Managing API keys, connected apps and card billing belongs to the account pages on the web: an API key's tools/list leaves those tools out, so they are not covered here.
| Verb | REST | MCP tool | Access |
|---|---|---|---|
| catalog.list | GET /catalog | catalog_list | No key |
| catalog.get | GET /catalog/{locale}/{slug} | catalog_get | No key |
| articles.list | GET /articles | articles_list | No key |
| articles.get | GET /articles/{locale}/{slug} | articles_get | Key required |
| content.list | GET /content | content_list | Key required |
| content.search | GET /content/search | content_search | No key |
| content.get | GET /content/{locale}/{slug} | content_get | Key required |
| packs.download | POST /packs/{slug}/download | packs_download | Key required |
| pack-versions.get | GET /pack-versions/{slug} | pack-versions_get | No key |
| visuals.issueUrl | POST /visuals/{locale}/{slug}/url | visuals_issueUrl | Key required |
| visuals.issueFlowUrl | POST /visuals/{locale}/{slug}/flow/url | visuals_issueFlowUrl | Key required |
| visuals.issueMotionUrl | POST /visuals/{locale}/{slug}/motion/url | visuals_issueMotionUrl | Key required |
| spotlight.list | GET /spotlight | spotlight_list | No key |
| prices.list | GET /prices | prices_list | No key |
| orders.quote | POST /orders/quote | orders_quote | Key required |
| orders.create | POST /orders | orders_create | Key required |
| orders.list | GET /orders | orders_list | Key required |
| orders.get | GET /orders/{code} | orders_get | Key required |
| claims.redeem | POST /claims/facebook | claims_redeem | Key required |
| entitlements.status | GET /entitlements/status | entitlements_status | Key required |
| preferences.get | GET /preferences | preferences_get | Key required |
| preferences.update | PATCH /preferences | preferences_update | Key required |