Skip to main content
Connect your Hugging Face smolagents agent to Doconda so it can convert, create and edit Word, PowerPoint, Excel and PDF files. smolagents loads the tools 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), 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 — Pin mcp<2; version 2 doesn’t work with smolagents yet.
  • 401 from the remote server — DOCONDA_API_KEY is missing or invalid, so the Authorization header is empty or wrong.
  • The download link stopped working — File links expire after 5 minutes; the agent calls get_document for fresh ones.