A complete reference for the Make.com API and blueprint management — covering scenario CRUD, blueprint JSON structure, expression syntax, router filters, error handlers, connections, webhooks, data stores, execution history, and Make-to-n8n migration mapping. Built from real production work at D1DX.
| Topic | What it covers |
|---|---|
| API Basics | Base URL, auth, pagination, team ID requirement, MCP usage |
| Scenarios | List, get, activate/deactivate, create, delete |
| Blueprints | Get and push blueprints, full JSON structure, key module names reference |
| Expression Syntax | {{1.body}} references, ifempty, lower, formatDate, parseDate, toNumber, length |
| Router Filters | Condition structure, AND/OR logic, full operator reference |
| Error Handlers | Ignore, Resume, Rollback, Break, Commit handler types |
| Connections | List, get, test connection health |
| Webhooks (Hooks) | List, get, create, delete; production URL retrieval |
| Data Stores | List stores, read/write records |
| Execution History | List scenario execution logs, status values |
| Make-to-n8n Migration | Module mapping table, expression syntax translation table |
| Critical Gotchas | Blueprint-as-string encoding, zone prefix requirement, connection ID portability, pull-before-edit, activation after push |
For the best experience, pair this skill with the official Make.com cloud MCP at https://eu1.make.com/mcp/stateless (or eu2/us1/us2 for your zone). It uses Streamable HTTP transport with Bearer-header auth, runs in Make's infrastructure, and exposes 200+ modules and scenarios directly to your AI agent — no local node process to install or orphan.
Example Claude Code config (.mcp.json):
{
"mcpServers": {
"make": {
"type": "http",
"url": "https://eu1.make.com/mcp/stateless",
"headers": {
"Authorization": "Bearer YOUR_MAKE_API_KEY"
}
}
}
}Note on the legacy stdio fork. D1DX previously maintained
github:D1DX/make-mcp— a Node-based stdio MCP server. It is retired as of 2026-05-08 for unfixable orphan-storm failure modes on macOS Sequoia (a v1.4.2 watchdog gap reproduced under Codex). Use the cloud MCP above instead. Recovery for any consumer still running the fork:pkill -9 -f make-mcp-server.
git clone https://github.com/D1DX/make-skill.git
cp -r make-skill ~/.claude/skills/makeOr as a git submodule:
git submodule add https://github.com/D1DX/make-skill.git path/to/skills/makeCopy SKILL.md (and supporting files) into your agent's prompt or knowledge directory. The skill is structured markdown — works with any LLM agent that reads reference files.
make-skill/
├── SKILL.md — Main skill file
└── README.md — This file
Distilled from managing 257 Make.com scenarios at D1DX and executing a large-scale migration to n8n. Covers API patterns, blueprint engineering, and migration mappings developed through hands-on scenario auditing, blueprint editing, and cross-platform porting.
Built by Daniel Rudaev at D1DX.
MIT License — Copyright (c) 2026 Daniel Rudaev @ D1DX