Capabilities
- Create a Word, PowerPoint, Excel or PDF file, or an artifact, from a request or from Markdown with the workflow’s data.
- Edit a file: only what is asked changes, and
get_reportlists every change. - Convert a file to another format with no AI, for example any file to Markdown so the agent can read it.
- Read what people saved in an artifact, such as poll votes.
Setup
This integration uses a Doconda API key (from API keys), stored in an n8n Bearer Auth credential. Paste the key without the wordBearer.
As an AI Agent tool
- Add an AI Agent node and, on its Tool input, an MCP Client Tool node.
- Endpoint:
https://api.eu.doconda.com/mcp. - Server Transport:
HTTP Streamable. - Authentication:
Bearer Auth, with a new credential where you paste your API key. - Tools to Include:
All, or only the ones you want (for examplecreate_document).
With an HTTP request
For workflows without an agent (always the same document, filled with data from the workflow), use an HTTP Request node:- Method:
POST· URL:https://api.eu.doconda.com/v1/documents - Authentication:
Bearer Authwith your API key. - Body (JSON):
outputs. If it takes
longer, the response is a 202 with the document still in progress (status queued or running) and no outputs
yet. In that case, loop until it finishes:
- Add a Wait node (for example, 15 seconds).
- Add an HTTP Request node with
GET https://api.eu.doconda.com/v1/documents/{{ $json.id }}. - Add an If node that goes back to the Wait while
statusisqueuedorrunning.
outputs; they expire after 5 minutes.
Tools
The MCP Client Tool node exposes the eight Doconda tools; see the tools for what each one does. A failed call returns{ "error": "<code>", "message": "…" }, so the agent can correct itself.
Troubleshooting
401from the endpoint — The credential holdsBearer ak_eu_…instead of the key alone, or the key is invalid.- The HTTP response has no
outputs— The document wasn’t ready within 120 s and the response is a202: add the Wait loop above. 402withinsufficient_balance— The project’s balance can’t cover the document: top up in the dashboard.- The download link stopped working — File links expire after 5 minutes: request the document again with
GET.
Useful links
- MCP server: remote setup and permissions.
- Create a document: what
POST /v1/documentsaccepts. - Errors: every error code.
- API reference.