Skip to main content
Connect your Mastra agent to Doconda so it can convert, create and edit Word, PowerPoint, Excel and PDF files. Wrap the SDK tools with createTool, or load them from the MCP server with MCPClient.

Capabilities

  • Create a Word, PowerPoint, Excel or PDF file, or an artifact, from a request or from Markdown the agent wrote.
  • Edit a file: only what is asked changes, and get_report lists 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 in DOCONDA_API_KEY (from API keys). Mastra’s provider/model format reads the provider key from your environment, for example ANTHROPIC_API_KEY.

With the SDK tools

text is the agent’s answer, with the presentation’s download links. createTool takes each tool’s JSON Schema as is, with no conversion to Zod.

With the MCP client

Tools

The agent gets the eight Doconda tools; see the tools for what each one does. With MCPClient, tool names arrive prefixed with the server name (doconda_create_document, …). A failed call returns { "error": "<code>", "message": "…" } instead of throwing, so the model can correct itself.

Troubleshooting

  • Doconda: pass { apiKey } or set DOCONDA_API_KEY. — The SDK found no key: set DOCONDA_API_KEY, or pass { apiKey } to Doconda.
  • A tool result has "error": "insufficient_balance" — The project’s balance can’t cover the document: top up in the dashboard, or ask for quality: "fast".
  • The download link stopped working — File links expire after 5 minutes; the agent calls get_document for fresh ones.