Madoo documentation
Madoo is a workflow engine for AI media generation: images, video, audio, 3D and documents (PDF). You describe the work as a graph of nodes — inputs, processing steps, outputs — publish it, and run it as many times as you need, one item or thousands, with the same result every time.
This documentation is written for AI agents first and for people too. Every page opens with the situation in which it is worth reading; read the page that fits your task instead of reading everything.
Where to go
Section titled “Where to go”| Your task | Read |
|---|---|
| Understand what Madoo is for and which way of working with it fits you | What Madoo is |
Understand why an account can no longer change or run anything (subscription_blocked), how it is reactivated and how long its data is kept |
When a subscription ends |
Understand why a request was refused with credit_cap_reached although there are credits, when work starts again, and who can change a daily or monthly limit |
Usage limits |
Understand why AI generation stopped (ai_spend_paused, AI_SPEND_PAUSED), when it resumes, and what the “AI today / AI month” rows mean |
AI safety limits |
| Build or change a workflow, or explain a validation error | How workflows are built |
| Process a list of items, or make one file from many results | Iteration |
| Look at what a run produced before delivering it — pages, slides, video frames, sound | Checking what a run produced |
| Generate, check and correct until a result is accepted — the product kept, the brand colours held | Repeat until accepted |
| Read structured data, compute, decide, choose, check — orders, records, spreadsheets, AI answers in JSON | Data and decisions |
| Judge content with a model and route on the answer — is this photo usable, which team for this message, which variant fits the brief, what kind of document | Decisions with a model |
| Write or read text — messages, listings, summaries, translations, JSON from a model, prompts for other AI steps | Text |
| Prepare, correct, brand, generate or edit images — product photos, catalogues, social formats, try-on | Images |
| Edit, caption, dub, finish or generate video and audio — reels, subtitles, voice-overs, podcasts | Video and audio |
| Create, change or fill a document template (brochures, sheets, price lists, certificates, posters) | Document templates |
| Integrate Madoo into a product or a backend, or connect an AI assistant | Public API and MCP |
| Connect Claude, ChatGPT, Cursor or another assistant to Madoo | MCP server |
| Author a workflow definition through the API | Authoring workflows |
| Author or render a document template | Design templates |
For AI agents
Section titled “For AI agents”Every page is also available as plain markdown: add .md to its address (this page is /index.md).
/llms.txt is the entry point for agents: it points to /llms-full.txt, the whole
documentation in one file, and to a shorter version of it.