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_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 inDOCONDA_API_KEY (from API keys), sent to the
remote server as Authorization: Bearer. InferenceClientModel uses your Hugging Face token.
Pin
mcp<2: version 2 of mcp is not yet compatible with the smolagents MCP integration.With the remote server
agent.run returns the agent’s final answer, with the presentation’s download links.
With the local server
Tools
The agent gets the eight tools of the MCP server; see the tools for what each one does. A failed call returns{ "error": "<code>", "message": "…" }, so the agent can correct itself.
Troubleshooting
- Import or connection errors from
mcp— Pinmcp<2; version 2 doesn’t work with smolagents yet. 401from the remote server —DOCONDA_API_KEYis missing or invalid, so theAuthorizationheader is empty or wrong.- The download link stopped working — File links expire after 5 minutes; the agent calls
get_documentfor fresh ones.
Useful links
- MCP server: local and remote setup.
- doconda-examples on GitHub: ready-to-run scripts.
- API reference.