infomaniak-mcp-agent

You → Claude: "audit the example.com hosting and tell me which mailboxes are over quota" Claude → MCP: infomaniak_audit_account → infomaniak_list_mail_hostings → infomaniak_list_mailboxes Claude → You: 3 mailboxes >85% — paul@ (94%), notify@ (88%), team@ (87%). Want me to add an alert?

Infomaniak is one of the very fewindependent, Swiss-owned, open-source-friendly cloud providersin Europe — running its own datacentres in Switzerland, on hydro and wind power, with no parent in the US or China. Its product range is huge (web hosting, mail, kDrive, kChat, DNS, AI cloud, Swiss Backup, …) but its API is split between a documented public surface and a private manager-only one — which means automating real workflows usually requires a browser session, custom scripts, or both.

This project closes that gap by exposingeverythingthrough a single MCP server, so Claude or any other MCP client can run real account operations through natural language: provision a hosting, rotate a DNS record, create a mailbox, audit your domains for upcoming expirations, browse your kDrive — without ever forcing you to leave the chat or write a script.

🎒 Built in the open, in real time, by vibe-coding

This project was built rapidly by an LLM driving a terminal session ("vibe-coding"), with live tests against a real Infomaniak account at every step.It works perfectly on the maintainer's local setupand the full pipeline is green (TypeScript strict, ESLint, Prettier, 78 tests, build, CodeQL, gitleaks).

We move fast and ship often. Don't be shy.

Once installed, you can ask Claude things like:

- "List every domain on my account that expires in less than 60 days, sorted by date."
- "Create a new sitestaging.example.comon hostingWP1234567, PHP 8.3, root in/sites/staging."
- "Add a TXT record onexample.comfor the new Postmark DKIM, then verify it resolves."
- "How much disk does the databasemyprefix_wp123456use, and which application is wired to it?"
- "Create a mailboxhello@example.comwith a 16-character random password and forward it to my Gmail."
- "Show me which kDrives I'm an admin on and how full they are."
- "Audit my whole account: any locked product, expiring SSL, broken DNSSEC, ongoing operations?"
- "Undo the last DNS change I made through this session."

It will not silently mutate anything destructive: every change goes through aplan + confirmation tokenround-trip. You stay in control even if the model gets creative.

Why "agentic" and not "wrapper"

Most MCP servers expose one tool per HTTP endpoint and call it a day. This one is built differently:

- Guided dialogues— creating a site walks you through "which organization? which hosting? root domain or subdomain? what type? recap?" instead of asking you to know the right tool to call upfront.
- Two-phase commit— every destructive operation returns aplanwith a single-use confirmation token (60 s TTL). Nothing is mutated until you call back with the token.
- Pre-flight checks— the server checks for conflicts (existing FQDN, busy hosting, expired domain)beforehitting the API.
- Actionable errors— every error tells you what happened, why, and the next step you can take.
- Introspection—infomaniak_overview,infomaniak_helpandinfomaniak_explaingive the agent context-on-demand instead of forcing it to memorize a tool catalog.
- Session memory—infomaniak_historylists every destructive action of the current session, andinfomaniak_undoreverses the ones that are reversible.

Available on npm — the recommended path is to letnpxfetch the latest release on demand:

(no install step needed;npxresolves the latest version on first invocation and caches it).

Or install globally if you prefer a stable binary in your$PATH:

If you'd rather pin to a specific commit (or hack on the source), install from this repo:

git clone https://github.com/Mogacode-ma/infomaniak-mcp-agent.git cd infomaniak-mcp-agent npm ci npm run build # resulting binary: ./dist/server.js

Add to~/Library/Application Support/Claude/claude_desktop_config.json(macOS) or%AppData%\Claude\claude_desktop_config.json(Windows):