Skip to main content
Glama

Termix MCP

Version License

A small tool that lets Claude read and change a Termix server through its API.

It runs on your own computer. Your API key stays on your computer.

What Claude can do with it

  • Check that Termix is up and the key works (termix_health).

  • List, read, add, change, and delete hosts (termix_hosts).

  • Add many hosts at once (termix_add_many_hosts).

  • List stored credentials, with secrets hidden (termix_credentials).

  • Manage roles: make roles, put users in them, share hosts or folders with a role (termix_roles).

  • Call any other Termix API route (termix_call).

Related MCP server: drumfire-proxmox-mcp

Safety

  • Read calls run right away.

  • Add and change calls do not run until Claude asks you and sets confirm.

  • Delete calls also need the exact phrase typed back, like DELETE /host/db/host/3.

  • Passwords and keys are hidden in everything Claude sees.

  • Creating credentials, logins, and key making are blocked. Do those in the Termix web page yourself.

  • The API key is never printed. It is removed from error messages.

Set up

1. Make an API key

  1. Open Termix.

  2. Look in your user profile or admin settings for API keys. Menu names can differ a little by version.

  3. Best: make a separate key just for Claude, so you can delete it on its own later.

Do not paste the key in a chat. Put it only in the config file below. If it ever lands in a chat, delete that key and make a new one.

2. Add the tool to Claude

Open the Claude desktop app settings and find the MCP servers config file. Add the block from claude_desktop_config.example.json. Change the key.

  • TERMIX_URL: your server, like http://192.168.1.142:8081

  • TERMIX_API_KEY: your key

  • TERMIX_VERIFY_TLS: set to false only for a self-signed https address

That file now holds a secret. Do not share it. Do not put it on GitHub.

If you do not have uvx, use Python instead:

pip install git+https://github.com/drmogie/termix-mcp

Then use "command": "termix-mcp" and no args.

Restart the Claude desktop app.

3. Try it

Ask Claude: "Check Termix." Then: "List my Termix hosts."

Host field names

The Termix docs do not list the host fields. To see the exact names for your version:

  1. Add one host by hand in the Termix web page.

  2. Ask Claude to list hosts.

  3. Claude copies those field names when adding more.

Tests

pip install mcp
python -m unittest discover tests

The tests use a fake Termix server. They do not touch your real one.

Docs

Termix API: https://docs.termix.site/api/

Available Tools

6 tools
termix_add_many_hostsA

Add several hosts in one go. Each item is the same data you would give to termix_hosts add. Needs confirm=true. Reports each result on its own, so one bad row does not stop the rest.

Inputs: hosts (required), confirm. Returns: object

termix_callA

Call any other Termix API route. Docs: https://docs.termix.site/api/

method: GET, POST, PUT, PATCH, or DELETE path: like /host/db/host or /health GET runs right away. POST, PUT, PATCH need confirm=true. DELETE needs confirm=true and confirm_phrase="DELETE ". Password and key routes are blocked. Secrets in answers are hidden.

Inputs: path (required), method (required), body, query, +2 more. Returns: object

termix_credentialsA

List or read stored credentials. Read-only. Secrets are hidden.

action: list | get Use the credential id inside a host's data to link a host to a credential.

Inputs: action, credential_id. Returns: object

termix_healthA

Check that the Termix server is up and the API key works.

Calls the health check, then lists hosts to test the key.

Inputs: no named parameters. Returns: object

termix_hostsA

List, read, add, change, or delete Termix hosts.

action: list | get | add | update | delete host_id: needed for get, update, delete data: the host fields for add and update (see the README for the field names; run action=list once to see the exact fields your Termix version uses) add and update need confirm=true. delete also needs confirm_phrase="DELETE /host/db/host/". Passwords and keys are hidden in all output. Enter those in the Termix web page.

Inputs: data, action, confirm, host_id, +1 more. Returns: object

termix_rolesA

Manage Termix roles, who is in them, and which hosts they can reach.

Read actions (run right away): list all roles members users in a role (needs role_id) user_roles roles of one user (needs user_id) users all users, to find a user_id host_access who a host is shared with (needs host_id) folder_access standing share rules for a folder (needs folder) Change actions (need confirm=true, so ask the user first): create needs name (lowercase, digits, _ or -) and display_name update needs role_id, and display_name and/or description assign needs role_id and user_id share_host needs host_id, and role_ids and/or user_ids share_folder needs folder, and role_ids and/or user_ids (also covers hosts added to that folder later) update_access needs host_id, access_id, permission_level and/or duration_hours Destructive actions (need confirm=true and confirm_phrase="METHOD /path"): delete delete a role (needs role_id) unassign take a role off a user (needs role_id and user_id) revoke_access remove a host share (needs host_id and access_id) delete_folder_rule remove a folder share rule (needs access_id) Sharing uses the host's saved credential. No passwords pass through here.

Inputs: name, action, folder, confirm, +11 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 6 tools

    Disambiguation3/5

    Most tools have distinct resource focus, but termix_add_many_hosts overlaps with termix_hosts add, and termix_call can duplicate nearly any other tool. termix_health also overlaps with termix_call GET /health and host listing, though descriptions provide some guidance.

    Naming Consistency4/5

    All names use the same termix_ prefix and snake_case, which is predictable. The suffix style is not strictly verb_noun—resources are mostly nouns with actions as parameters—but it remains readable and consistent.

    Tool Count5/5

    Six tools is well within a reasonable range and covers the domain without excessive fragmentation. The generic escape hatch and batch-add tool each serve a clear purpose.

    Completeness4/5

    Core host CRUD, batch host creation, role/access management, credential reads, and health checks are covered. Minor gaps exist—credential writes are intentionally omitted and some operations rely on the generic call tool—but agents have workarounds.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables Claude to execute commands on remote servers via SSH, with support for SSH config, private keys, password auth, and agent forwarding.
      78 npm
      ISC
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables Claude to manage a Proxmox cluster through chat: inventory, power control, configuration changes, VM/container creation and cloning, snapshots, network/firewall/cluster visibility, guest command execution, and file writes via the QEMU Guest Agent.
      22 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables Claude to read and modify an Nginx Proxy Manager instance through its API, covering proxy, redirection, and 404 hosts, streams, certificates, access lists, audit logs, and any other API endpoint. Changes are merged into existing objects and guarded by read, change, and destructive safety levels that require user confirmation before anything is altered.
      4
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables Claude to inspect and configure PiKVM devices through the web API and SSH, including power control, screenshots, keyboard input, virtual drives, health checks, configuration, and services, with safeguards that require confirmation for changes.
      15
      MIT