iotamine-mcp

An MCP server for the Iotamine cloud VPS platform. Connect it to Claude Desktop, Claude Code, Cursor, or any other MCP-compatible client to let it read your VPS instances, billing, quota, and infrastructure directly.

This is a thin, read-only wrapper around the real Iotamine REST API — the exact same API your dashboard already uses. It doesn't duplicate any account logic, store any of your data, or run any service of its own; it just translates MCP tool calls into ordinary API requests on your behalf, using your own API key.

Every tool in this server is read-only. Nothing here can start, stop, create, resize, or destroy a VPS, or spend money. (Write actions are planned for a future release, gated behind a separate read_write-scoped key — see Scopes below.)

Setup

1. Get an API key

From your Iotamine dashboard → API Keys → Create Key. Leave the scope as Read-only — that's all this server needs.

2. Install and run

Using uv (recommended — no separate install step):

uvx iotamine-mcp

Or with pip:

pip install iotamine-mcp
iotamine-mcp

3. Add it to your MCP client

Claude Code:

claude mcp add iotamine uvx --args iotamine-mcp --env IOTAMINE_API_KEY="your-key-here"

Claude Desktop / Cursor (claude_desktop_config.json or your client's equivalent):

{
  "mcpServers": {
    "iotamine": {
      "command": "uvx",
      "args": ["iotamine-mcp"],
      "env": {
        "IOTAMINE_API_KEY": "your-key-here"
      }
    }
  }
}

Set IOTAMINE_API_KEY as an environment variable in your client's config, not hardcoded anywhere else — the same rule any API key deserves.

Tools

Tool	What it returns
`list_vps`	Every VPS instance on the account
`get_vps`	Full detail for one VPS by id
`get_quota`	Resource limits, current usage, and tier
`get_account_balance`	Wallet balance and basic profile
`list_invoices`	Every invoice, most recent first
`get_usage_billing`	Current unbilled usage + historical billed cost
`list_os_images`	Available operating systems
`list_regions`	Available Points of Presence
`list_ip_addresses`	Every standalone IP address on the account
`list_volumes`	Every standalone storage volume on the account
`list_ssh_keys`	Every SSH key saved on the account

Scopes

An Iotamine API key has a scope — read-only (default) or read & write. This server only ever needs a read-only key. If you paste a read & write key instead, nothing changes: every tool here still only ever sends GET requests.

Configuration

Environment variable	Required	Default
`IOTAMINE_API_KEY`	Yes	—
`IOTAMINE_API_URL`	No	`https://iotamine.com/api/`

Development

python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iotamine_mcp-0.1.0.tar.gz (8.0 kB view details)

Uploaded Sep 14, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

iotamine_mcp-0.1.0-py3-none-any.whl (8.7 kB view details)

Uploaded Sep 14, 2026 Python 3

File details

Details for the file iotamine_mcp-0.1.0.tar.gz.

File metadata

Download URL: iotamine_mcp-0.1.0.tar.gz
Upload date: Sep 14, 2026
Size: 8.0 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for iotamine_mcp-0.1.0.tar.gz
Algorithm	Hash digest
SHA256	`5e54a1270fcd1bffc27824c483efa044bc904ed47cc6d8585e68e894f3be0bda`
MD5	`51d4aae3341c2a6c8ae2cf6ff2432886`
BLAKE2b-256	`6af03c840e62aad290594d9b97a02dc1895e16df80cf9733a3ddb33990a59b87`

See more details on using hashes here.

Provenance

The following attestation bundles were made for iotamine_mcp-0.1.0.tar.gz:

Publisher: publish.yml on piyushladhar/iotamine-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: iotamine_mcp-0.1.0.tar.gz
- Subject digest: 5e54a1270fcd1bffc27824c483efa044bc904ed47cc6d8585e68e894f3be0bda
- Sigstore transparency entry: 2831894187
- Sigstore integration time: Sep 14, 2026
Source repository:
- Permalink: piyushladhar/iotamine-mcp@2bc3fc60c46312c0f5f9bfa15513e4b590aadc12
- Branch / Tag: refs/tags/v0.1.0
- Owner: https://github.com/piyushladhar
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@2bc3fc60c46312c0f5f9bfa15513e4b590aadc12
- Trigger Event: release