Infomaniak MCP Server

A Model Context Protocol (MCP) server for interacting with the Infomaniak API. This server enables AI assistants like Claude to manage Infomaniak services including domains, email, web hosting, kDrive, and more.

✨ Features

• 🌐 Domain Management - List domains, full DNS record CRUD operations
• 📧 Email Services - Manage mailboxes, aliases, and mail configurations
• 🖥️ Web Hosting - Manage sites, PHP versions, and MySQL databases
• 💾 kDrive - Access and manage kDrive cloud storage
• 🔒 Swiss Backup - View and manage backup products
• 🖧 VPS & Servers - Control VPS instances and dedicated servers
• 📜 SSL Certificates - View certificate information
• 💰 Invoicing - Access billing and invoice data
• 🔧 Generic API - Make custom API calls for advanced operations

📋 Prerequisites

• Node.js 18 or higher
• An Infomaniak account with API access
• An API token from Infomaniak

🔑 Getting Your API Token

1. Log in to your Infomaniak Manager
2. Navigate to Account → API Tokens or visit token management
3. Click "Create a token"
4. Select the appropriate scopes for your needs:
   • account - Account management
   • domain - Domain management
   • mail - Email services
   • web - Web hosting
   • drive - kDrive access
   • swiss_backup - Backup services
   • vps - VPS management
   • dedicated - Dedicated servers
   • certificate - SSL certificates
   • invoicing - Billing access
5. Copy and securely store your token

📦 Installation

Using npm (recommended)

npm install -g infomaniak-mcp-server

From source

git clone https://github.com/YOUR_USERNAME/infomaniak-mcp-server.git
cd infomaniak-mcp-server
npm install
npm run build

⚙️ Configuration

Claude Desktop

Add to your Claude Desktop configuration file:

| OS | Path | |----|------| | macOS | ~/Library/Application Support/Claude/claude_desktop_config.json | | Windows | %APPDATA%\Claude\claude_desktop_config.json | | Linux | ~/.config/Claude/claude_desktop_config.json |

{
  "mcpServers": {
    "infomaniak": {
      "command": "npx",
      "args": ["-y", "infomaniak-mcp-server"],
      "env": {
        "INFOMANIAK_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Or if installed globally or from source:

{
  "mcpServers": {
    "infomaniak": {
      "command": "node",
      "args": ["/path/to/infomaniak-mcp-server/build/index.js"],
      "env": {
        "INFOMANIAK_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | INFOMANIAK_API_TOKEN | Yes | - | Your Infomaniak API token | | MCP_TRANSPORT | No | stdio | Transport mode: stdio or http | | MCP_PORT | No | 3000 | HTTP server port (when using http transport) | | MCP_STATELESS | No | false | Set to true for stateless mode |

🌐 HTTP Transport

The server supports HTTP transport with SSE streaming, enabling web-based MCP clients and remote connections.

Starting in HTTP Mode

# Using npx
MCP_TRANSPORT=http MCP_PORT=3000 INFOMANIAK_API_TOKEN=your-token npx infomaniak-mcp-server

# From source
MCP_TRANSPORT=http MCP_PORT=3000 INFOMANIAK_API_TOKEN=your-token node build/index.js

HTTP Endpoints

| Endpoint | Method | Description | |----------|--------|-------------| | /health | GET | Health check - returns server status | | /mcp | POST | Send JSON-RPC messages (initialize, tool calls, etc.) | | /mcp | GET | Open SSE stream for server-to-client notifications | | /mcp | DELETE | Terminate a session | | /mcp/sessions | GET | List active sessions (for debugging) |

Session Modes

• Stateful (default): Maintains session state across requests. Each client gets a unique session ID returned in the Mcp-Session-Id header after initialization.
• Stateless: Each request is independent. Set MCP_STATELESS=true for serverless deployments.

Docker Deployment

FROM node:20-alpine
WORKDIR /app
RUN npm install -g infomaniak-mcp-server
ENV MCP_TRANSPORT=http
ENV MCP_PORT=3000
EXPOSE 3000
CMD ["infomaniak-mcp-server"]

# Build and run
docker build -t infomaniak-mcp .
docker run -p 3000:3000 -e INFOMANIAK_API_TOKEN=your-token infomaniak-mcp

Connecting from Web Clients

// Step 1: Initialize session
const initResponse = await fetch('http://localhost:3000/mcp', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json, text/event-stream'
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'initialize',
    params: { protocolVersion: '2025-03-26', capabilities: {}, clientInfo: { name: 'my-client', version: '1.0.0' } },
    id: 1
  })
});
const sessionId = initResponse.headers.get('Mcp-Session-Id');

// Step 2: Use session for subsequent requests
const response = await fetch('http://localhost:3000/mcp', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json, text/event-stream',
    'Mcp-Session-Id': sessionId
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'tools/list',
    id: 2
  })
});

🛠️ Available Tools

Account & Profile

| Tool | Description | |------|-------------| | infomaniak_ping | Test API connectivity | | infomaniak_get_profile | Get current user profile | | infomaniak_list_accounts | List all accessible accounts | | infomaniak_get_account | Get account details | | infomaniak_list_products | List account products |

Domain Management

| Tool | Description | |------|-------------| | infomaniak_list_domains | List all domains | | infomaniak_get_domain | Get domain details | | infomaniak_list_dns_records | List DNS records | | infomaniak_create_dns_record | Create DNS record (A, AAAA, CNAME, MX, TXT, etc.) | | infomaniak_update_dns_record | Update DNS record | | infomaniak_delete_dns_record | Delete DNS record |

Email Services

| Tool | Description | |------|-------------| | infomaniak_list_mail_services | List mail services | | infomaniak_get_mail_service | Get mail service details | | infomaniak_list_mailboxes | List mailboxes | | infomaniak_get_mailbox | Get mailbox details | | infomaniak_create_mailbox | Create new mailbox | | infomaniak_update_mailbox | Update mailbox | | infomaniak_delete_mailbox | Delete mailbox | | infomaniak_add_mailbox_alias | Add email alias | | infomaniak_delete_mailbox_alias | Remove email alias |

Web Hosting

| Tool | Description | |------|-------------| | infomaniak_list_web_hostings | List web hostings | | infomaniak_get_web_hosting | Get hosting details | | infomaniak_list_sites | List sites | | infomaniak_get_site | Get site details | | infomaniak_create_site | Create new site | | infomaniak_update_site | Update site | | infomaniak_delete_site | Delete site | | infomaniak_list_databases | List databases | | infomaniak_get_database | Get database details | | infomaniak_create_database | Create database | | infomaniak_delete_database | Delete database |

Cloud Storage

| Tool | Description | |------|-------------| | infomaniak_list_kdrives | List kDrives | | infomaniak_get_kdrive | Get kDrive details | | infomaniak_list_swiss_backups | List Swiss Backups | | infomaniak_get_swiss_backup | Get backup details | | infomaniak_list_swiss_backup_slots | List backup slots |

Infrastructure

| Tool | Description | |------|-------------| | infomaniak_list_vps | List VPS instances | | infomaniak_get_vps | Get VPS details | | infomaniak_reboot_vps | Reboot VPS | | infomaniak_shutdown_vps | Shutdown VPS | | infomaniak_boot_vps | Boot VPS | | infomaniak_list_dedicated_servers | List dedicated servers | | infomaniak_get_dedicated_server | Get server details | | infomaniak_reboot_dedicated_server | Reboot server |

Certificates & Billing

| Tool | Description | |------|-------------| | infomaniak_list_certificates | List SSL certificates | | infomaniak_get_certificate | Get certificate details | | infomaniak_list_invoices | List invoices | | infomaniak_get_invoice | Get invoice details |

Advanced

| Tool | Description | |------|-------------| | infomaniak_api_call | Make custom API calls to any endpoint |

💬 Usage Examples

List all accounts

"List all my Infomaniak accounts"

Manage DNS Records

"Add an A record for www.example.com pointing to 192.168.1.100"
"Show all DNS records for mydomain.ch"
"Delete the TXT record with ID 12345 from example.com"

Create a Mailbox

"Create a new email address [email protected] with password SecurePass123"

Check Infrastructure

"Show me the status of all my VPS instances"
"Reboot my VPS with ID 456"

Custom API Call

"Make a GET request to /1/account to see all account details"

🔧 Development

Setup

git clone https://github.com/YOUR_USERNAME/infomaniak-mcp-server.git
cd infomaniak-mcp-server
npm install

Build

npm run build

Watch Mode

npm run dev

Test with MCP Inspector

INFOMANIAK_API_TOKEN=your-token npm run inspector

⚠️ API Rate Limits

The Infomaniak API has a rate limit of 60 requests per minute. Be mindful of request frequency when using automation.

🐛 Troubleshooting

"INFOMANIAK_API_TOKEN environment variable is required"

Ensure you've set the INFOMANIAK_API_TOKEN in your MCP client configuration.

"Infomaniak API Error (401)"

Your API token may be invalid or expired. Generate a new token from Infomaniak Manager.

"Infomaniak API Error (403)"

Your token doesn't have the required scope. Create a new token with appropriate permissions.

"Infomaniak API Error (429)"

Rate limit exceeded. Wait before making more requests.

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'feat: add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🔗 Resources

• Infomaniak API Documentation
• Infomaniak Getting Started
• Model Context Protocol
• MCP TypeScript SDK

🙏 Acknowledgments

• Infomaniak for their comprehensive API
• Anthropic for the Model Context Protocol
• The open-source community