GoMami MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GoMami MCP list my GoMami servers and their current status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
GoMami MCP
An unofficial Model Context Protocol server for managing GoMami servers from Claude Code and other MCP clients. It is read-only by default and has no third-party dependencies.
Not affiliated with GoMami. This is an independent community project. "GoMami" is used only to describe the service this tool works with.
Alpha. The read-only connection, account and server list calls have been tested against the live API. All other tools have only been tested against a local mock, so try them on a disposable server first.
Requirements
Python 3.10 or newer
macOS or Linux
A GoMami API token
Related MCP server: iotamine-mcp
Setup
Sign in at
gomami.ioand open Create API Token. Tokens have full account access and are shown only once.Save the token. Run this, paste the token (nothing is displayed), then press Enter:
(umask 077; mkdir -p ~/.config/gomami-mcp; IFS= read -rs t; printf '%s\n' "$t" > ~/.config/gomami-mcp/token; unset t)Clone this repository and add the server to Claude Code:
claude mcp add gomami --scope user -- python3 /absolute/path/to/gomami-mcp/src/gomami_mcp.pyIn a new session, ask your assistant to run
verify_connection.
Other MCP clients can use the same command with this configuration:
{
"mcpServers": {
"gomami": {
"command": "python3",
"args": ["/absolute/path/to/gomami-mcp/src/gomami_mcp.py"],
"env": { "GOMAMI_MCP_ACCESS": "read" }
}
}
}Configuration
Variable | Default | Purpose |
|
| Access tier: |
| empty | Comma-separated server IDs that can be read but not changed. |
| empty | Token value. Takes priority over |
Tools
All 29 operations in the GoMami API reference are available.
Tier | Tools |
|
|
| All of the above, plus |
| All of the above, plus |
Safety
Add production servers to
GOMAMI_MCP_PROTECTED_SERVERS. This is enforced by the server and cannot be overridden by a tool call.State-changing tools need confirmation text, such as
REBUILD <server-id>. This prevents mistakes, but a model can fill it in by itself.VNC passwords and connection tokens are never returned to the chat.
Reset passwords are saved under
~/.config/gomami-mcp/secrets/with mode600.Write requests are never retried automatically.
See SECURITY.md for details and limits.
Known limitations
The API reference does not say what value
set_isoneeds to eject an ISO.The API reference describes
GET /server/{id}/vncas a toggle, which looks like a typo. It is placed in theoperatetier to be safe.The API is behind Cloudflare. Blocked requests are reported clearly, and this project does not try to work around them.
Development
python3 -m unittest discover -s tests -vTests use a local mock and never contact GoMami.
License
Available Tools
12 toolsget_accountAccountARead-onlyIdempotent
Read the account name, email address and timezone.
Inputs: no named parameters.
get_resource_packResource pack detailsARead-onlyIdempotent
Read a resource pack's options, including the createId values needed to create a server.
Inputs: resourcePackId (required).
get_serverServer detailsARead-onlyIdempotent
Read a server's configuration, network and traffic period. Set state=true to include its live state.
Inputs: serverId (required), state.
get_taskTask detailsCRead-onlyIdempotent
Read the status of one task.
Inputs: taskId (required), serverId (required).
list_isosISOsBRead-onlyIdempotent
List the ISO images available to this server.
Inputs: serverId (required).
list_os_templatesOS templatesARead-onlyIdempotent
List the OS templates available for a rebuild.
Inputs: serverId (required).
list_resource_packsResource packsBRead-onlyIdempotent
List resource packs and their usage.
Inputs: no named parameters.
list_serversServersCRead-onlyIdempotent
List the servers on the account.
Inputs: page, results.
list_ssh_keysSSH keysCRead-onlyIdempotent
List the SSH public keys on the account.
Inputs: page, results.
list_swap_optionsSwap optionsBRead-onlyIdempotent
List the swap sizes available for a rebuild.
Inputs: serverId (required).
list_tasksTasksBRead-onlyIdempotent
List a server's recent tasks.
Inputs: serverId (required), page, results.
verify_connectionVerify connectionARead-onlyIdempotent
Check that the API is reachable and the token is valid.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool targets a clearly distinct resource and action: account, SSH keys, servers, OS templates, swap options, ISOs, tasks, and resource packs. The get/list pairs are differentiated by singular versus collection semantics, and rebuild-related list tools are still distinct resources.
All tool names use consistent snake_case verb_noun form, such as get_account, list_servers, get_server, and list_resource_packs. No mixed casing or vague standalone verbs appear.
Twelve tools is well-scoped for a hosting/account management MCP surface. Each tool covers a distinct read or verification operation without obvious redundancy.
The surface is almost entirely read-only: it can list and inspect servers, tasks, templates, and resource packs but cannot create, rebuild, start, stop, or delete servers. The mention of createId values for creating a server and templates for rebuilds highlights missing lifecycle operations, leaving important workflows as dead ends.
Maintenance
Related MCP Connectors
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
Hosted MCP for Celesto cloud computers: create, exec, ports, start/stop/delete.
SSH client, server management and one remote MCP URL for your machines, with human approvals.
Hosted remote MCP for protected account access, permissions, activity history and supported undo.
Related MCP Servers
AlicenseBqualityDmaintenanceManage Hostodo VPS infrastructure from MCP clients and AI agents with scoped tokens and audit logs.471MIT- FlicenseAqualityBmaintenanceEnables Claude, Cursor, and other MCP clients to manage Iotamine cloud VPS accounts via the Iotamine REST API, including VPS lifecycle, monitoring, billing, and support operations.78-
- AlicenseNot gradedqualityCmaintenanceEnables Google Gemini and any MCP-compatible client to securely monitor and manage hypervisor guests — starting, stopping, rebooting, snapshotting, rolling back, and backing up VMs and containers — through the Model Context Protocol over Streamable HTTP with OAuth 2.0/OIDC authentication.MIT
- AlicenseNot gradedqualityAmaintenanceEnables MCP clients such as Claude Code, Claude Desktop, and Cursor to list hosts, read metrics, inspect containers, follow logs, and, when permitted, run commands, restart containers, manage authorized_keys, and edit host lists under per-host policy, Touch ID-backed credentials, deny-lists, rate limits, and an audit log.MIT