Lets an AI agent manage hosts, snippets, dashboard metrics, and audit trails for a self-hosted SSH, RDP, and VNC manager.
Also known as sujirodev/termix-mcp, termix-mcp
- Stars
- 1
- Tools
- 78
- Downloads, 30 days
- 104
- Latest version
- 0.1.0
- Last commit
- Nov 15, 2026
- License
- MIT
What is Termix MCP?
Termix lets an AI agent manage hosts, snippets, dashboard metrics, and audit trails for a self-hosted SSH, RDP, and VNC manager. It exposes 78 tools, such as termix_get_audit_forwarding, termix_get_branding, termix_get_encryption_status.
Summary generated from the project's README
About Termix MCP server
Termix provides an interface for AI agents to interact with a self-hosted manager for SSH, RDP, and VNC connections. It allows clients like Claude Desktop, Cursor, or VS Code to manage remote hosts, execute code snippets, monitor dashboard metrics, and review audit trails. The server is built on the termix-sdk and offers a curated set of tools designed to be secure by default, avoiding persistent SSH sessions or the exposure of secrets.
To use this server, you must provide a Termix API key and the base URL via environment variables. Users can control the level of access by configuring toolsets or enabling a read-only mode to prevent destructive actions. The server supports various configurations, including the ability to redact secrets in all outputs and limit the number of items returned in listings to maintain performance.
Written from the project's README. Every use case is checked against a quote from it.
How to install Termix MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Termix MCP in Claude Code
$ claude mcp add --env 'TERMIX_API_KEY=<YOUR_TERMIX_API_KEY>' --env 'TERMIX_URL=<TERMIX_URL>' termix-mcp -- uvx termix-mcpInstall Termix MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"termix-mcp": {
"command": "uvx",
"args": [
"termix-mcp"
],
"env": {
"TERMIX_API_KEY": "<YOUR_TERMIX_API_KEY>",
"TERMIX_URL": "<TERMIX_URL>"
}
}
}
}Install Termix MCP in VS Code
.vscode/mcp.json
{
"servers": {
"termix-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"termix-mcp"
],
"env": {
"TERMIX_API_KEY": "<YOUR_TERMIX_API_KEY>",
"TERMIX_URL": "<TERMIX_URL>"
}
}
}
}Install Termix MCP in VS Code CLI
$ code --add-mcp '{"name":"termix-mcp","type":"stdio","command":"uvx","args":["termix-mcp"],"env":{"TERMIX_API_KEY":"<YOUR_TERMIX_API_KEY>","TERMIX_URL":"<TERMIX_URL>"}}'Install Termix MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"termix-mcp": {
"command": "uvx",
"args": [
"termix-mcp"
],
"env": {
"TERMIX_API_KEY": "<YOUR_TERMIX_API_KEY>",
"TERMIX_URL": "<TERMIX_URL>"
}
}
}
}Install Termix MCP in Codex
$ codex mcp add termix-mcp --env 'TERMIX_API_KEY=<YOUR_TERMIX_API_KEY>' --env 'TERMIX_API_KEY=<YOUR_TERMIX_API_KEY>' --env 'TERMIX_URL=<TERMIX_URL>' --env 'TERMIX_URL=<TERMIX_URL>' -- uvx termix-mcpInstall Termix MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.termix-mcp] command = "uvx" args = ["termix-mcp"] [mcp_servers.termix-mcp.env] TERMIX_API_KEY = "<YOUR_TERMIX_API_KEY>" TERMIX_URL = "<TERMIX_URL>"
Install Termix MCP in Gemini CLI
$ gemini mcp add -s user -e 'TERMIX_API_KEY=<YOUR_TERMIX_API_KEY>' -e 'TERMIX_API_KEY=<YOUR_TERMIX_API_KEY>' -e 'TERMIX_URL=<TERMIX_URL>' -e 'TERMIX_URL=<TERMIX_URL>' termix-mcp uvx -- termix-mcpInstall Termix MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"termix-mcp": {
"command": "uvx",
"args": [
"termix-mcp"
],
"env": {
"TERMIX_API_KEY": "<YOUR_TERMIX_API_KEY>",
"TERMIX_URL": "<TERMIX_URL>"
}
}
}
}Needs a key before it starts
Started on 16 Nov 2026 with no keys, it stopped and asked for one, so a client sees no tools until you set the variables above.
Termix MCP tools 78
Detected from the READMEtermix_get_audit_forwardingtermix_get_brandingtermix_get_encryption_statustermix_get_host_defaultstermix_get_termix_id_statustermix_list_sso_providerstermix_update_brandingtermix_acknowledge_alert_firingtermix_create_alert_ruletermix_delete_alert_ruletermix_list_alert_rulestermix_get_session_log
| termix_get_audit_forwarding | — | |
| termix_get_branding | — | |
| termix_get_encryption_status | — | |
| termix_get_host_defaults | — | |
| termix_get_termix_id_status | — | |
| termix_list_sso_providers | — | |
| termix_update_branding | — | |
| termix_acknowledge_alert_firing | — | |
| termix_create_alert_rule | — | |
| termix_delete_alert_rule | — | |
| termix_list_alert_rules | — | |
| termix_get_session_log | — |
Show all 78 toolsShow fewer tools
termix_list_audit_eventstermix_list_session_logstermix_get_automationtermix_list_automationstermix_list_fleetstermix_run_automationtermix_create_credentialtermix_delete_credentialtermix_get_credentialtermix_list_credentialstermix_reveal_credentialtermix_update_credentialtermix_get_dashboard_summarytermix_get_homepagetermix_list_open_tabstermix_list_workspacestermix_get_containertermix_get_container_logstermix_get_container_statstermix_list_containerstermix_restart_containertermix_start_containertermix_stop_containertermix_create_foldertermix_delete_filetermix_list_filestermix_move_filetermix_read_filetermix_rename_filetermix_write_filetermix_create_hosttermix_delete_hosttermix_disable_host_autostarttermix_enable_host_autostarttermix_get_hosttermix_get_network_topologytermix_list_host_folderstermix_list_host_tagstermix_list_hoststermix_update_hosttermix_get_host_metricstermix_get_host_statustermix_get_metrics_historytermix_get_proxmox_statstermix_list_active_alertstermix_list_host_statusestermix_create_snippettermix_delete_snippettermix_get_snippettermix_list_snippetstermix_run_snippettermix_update_snippettermix_get_preferencestermix_get_system_infotermix_list_api_keystermix_create_tunneltermix_delete_tunneltermix_get_tunneltermix_list_tunnel_presetstermix_list_tunnelstermix_assign_roletermix_get_usertermix_list_credential_accesstermix_list_folder_accesstermix_list_rolestermix_list_users
| termix_list_audit_events | — | |
| termix_list_session_logs | — | |
| termix_get_automation | — | |
| termix_list_automations | — | |
| termix_list_fleets | — | |
| termix_run_automation | — | |
| termix_create_credential | — | |
| termix_delete_credential | — | |
| termix_get_credential | — | |
| termix_list_credentials | — | |
| termix_reveal_credential | — | |
| termix_update_credential | — | |
| termix_get_dashboard_summary | — | |
| termix_get_homepage | — | |
| termix_list_open_tabs | — | |
| termix_list_workspaces | — | |
| termix_get_container | — | |
| termix_get_container_logs | — | |
| termix_get_container_stats | — | |
| termix_list_containers | — | |
| termix_restart_container | — | |
| termix_start_container | — | |
| termix_stop_container | — | |
| termix_create_folder | — | |
| termix_delete_file | — | |
| termix_list_files | — | |
| termix_move_file | — | |
| termix_read_file | — | |
| termix_rename_file | — | |
| termix_write_file | — | |
| termix_create_host | — | |
| termix_delete_host | — | |
| termix_disable_host_autostart | — | |
| termix_enable_host_autostart | — | |
| termix_get_host | — | |
| termix_get_network_topology | — | |
| termix_list_host_folders | — | |
| termix_list_host_tags | — | |
| termix_list_hosts | — | |
| termix_update_host | — | |
| termix_get_host_metrics | — | |
| termix_get_host_status | — | |
| termix_get_metrics_history | — | |
| termix_get_proxmox_stats | — | |
| termix_list_active_alerts | — | |
| termix_list_host_statuses | — | |
| termix_create_snippet | — | |
| termix_delete_snippet | — | |
| termix_get_snippet | — | |
| termix_list_snippets | — | |
| termix_run_snippet | — | |
| termix_update_snippet | — | |
| termix_get_preferences | — | |
| termix_get_system_info | — | |
| termix_list_api_keys | — | |
| termix_create_tunnel | — | |
| termix_delete_tunnel | — | |
| termix_get_tunnel | — | |
| termix_list_tunnel_presets | — | |
| termix_list_tunnels | — | |
| termix_assign_role | — | |
| termix_get_user | — | |
| termix_list_credential_access | — | |
| termix_list_folder_access | — | |
| termix_list_roles | — | |
| termix_list_users | — |
Configuration
TERMIX_API_KEYRequiredSecretTermix API key (tmx_...)
TERMIX_API_KEYRequiredSecretTermix API key (tmx_...)
TERMIX_URLRequiredBase URL of the Termix instance
TERMIX_URLRequiredBase URL of the Termix instance
TERMIX_MCP_READ_ONLYHide and block every write tool
TERMIX_MCP_TOOLSETSdefault, all, or a comma-separated list (hosts,snippets,files,...)
| Name | Description | |
|---|---|---|
| TERMIX_API_KEY | Termix API key (tmx_...) | RequiredSecret |
| TERMIX_API_KEY | Termix API key (tmx_...) | RequiredSecret |
| TERMIX_URL | Base URL of the Termix instance | Required |
| TERMIX_URL | Base URL of the Termix instance | Required |
| TERMIX_MCP_READ_ONLY | Hide and block every write tool | |
| TERMIX_MCP_TOOLSETS | default, all, or a comma-separated list (hosts,snippets,files,...) |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHubtermix-mcp
MCP server for Termix, the self-hosted SSH/RDP/VNC manager. Lets an agent (Claude Desktop, Claude Code, Cursor, VS Code...) list and operate your Termix's hosts, snippets, dashboard, metrics and audit trail, built on top of termix-sdk.
Not a 1:1 wrapper of the Termix API: it's a curated set of tools, secure by default (no secrets, no persistent SSH session, no destructive tools outside of explicit toolsets).
Install
uvx termix-mcp
Alternatives: pip install termix-mcp or the ghcr.io/sujirodev/termix-mcp image.
Requires a Termix API key (tmx_...) with the minimum RBAC permissions for what the agent will do - see SECURITY.md.
Configure in your client
Claude Desktop / Claude Code (claude_desktop_config.json or .mcp.json):
{
"mcpServers": {
"termix": {
"command": "uvx",
"args": ["termix-mcp"],
"env": {
"TERMIX_URL": "https://termix.example.com",
"TERMIX_API_KEY": "tmx_xxxxxxxxxxxxxxxxxxxxxxxx"
}
}
}
}
Cursor / VS Code: same format, in each one's MCP configuration file.
Install via the MCP Registry
termix-mcp is published in the official MCP Registry under the name io.github.sujirodev/termix-mcp, with both a PyPI (uvx) package and an OCI (Docker) image listed - see server.json.
Clients that support registry-based discovery can find and install it directly from there instead of hand-writing the JSON config above:
curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=io.github.sujirodev/termix-mcp"
Then follow your client's own "add from registry" flow, searching for io.github.sujirodev/termix-mcp. You'll still need to set TERMIX_URL and TERMIX_API_KEY yourself - the registry entry doesn't carry your credentials.
You say / what happens
| You say | What the tool does |
|---|---|
| "what hosts do I have registered?" | termix_list_hosts |
| "show me the metrics for host X" | termix_get_host_metrics |
| "run snippet Y on host X" | termix_run_snippet (blocked in read-only mode) |
| "create a new host for this server" | termix_create_host (blocked in read-only mode) |
| "what audit activity happened this week?" | termix_list_audit_events |
Environment variables
| Variable | Default | Description |
|---|---|---|
TERMIX_URL |
required | Termix base URL |
TERMIX_API_KEY |
required | tmx_... API key (JWT/TOTP are not supported) |
TERMIX_SERVICE_URLS |
empty | JSON {"database": "http://..."} for installs without a proxy |
TERMIX_VERIFY_SSL |
true |
Validates the TLS certificate |
TERMIX_TIMEOUT |
30 |
Timeout per request (s) |
TERMIX_MAX_RETRIES |
2 |
Passed through to the SDK |
TERMIX_MCP_READ_ONLY |
false |
Hides and blocks write tools |
TERMIX_MCP_TOOLSETS |
default |
default, all, or a list hosts,snippets,files |
TERMIX_MCP_ENABLED_TOOLS |
empty | Allowlist by tool name |
TERMIX_MCP_DISABLED_TOOLS |
empty | Denylist by tool name |
TERMIX_MCP_REDACT_SECRETS |
true |
Masks secrets in all outputs |
TERMIX_MCP_MAX_ITEMS |
50 |
Default item limit for listings |
TERMIX_MCP_TRANSPORT |
stdio |
stdio or http |
TERMIX_MCP_HTTP_HOST / _PORT |
127.0.0.1 / 8765 |
HTTP transport bind |
TERMIX_MCP_HTTP_PATH |
generated and logged | Secret path of the HTTP endpoint |
TERMIX_MCP_LOG_LEVEL |
INFO |
Log level (stderr on stdio, stdout on http) |
Toolsets
Enabled by default: hosts, snippets, dashboard, metrics, system, audit.
Opt-in (TERMIX_MCP_TOOLSETS=hosts,files,docker,...): credentials, files, docker, tunnels, alerts, automations, users.
Disabled and explicit (never included in all): admin, dangerous.
TERMIX_MCP_READ_ONLY=true hides and blocks every tool that isn't read-only, in any toolset.
Tools
| Tool | Toolset | Read-only | Destructive | Flags |
|---|---|---|---|---|
termix_get_audit_forwarding |
admin | yes | no | admin |
termix_get_branding |
admin | yes | no | admin |
termix_get_encryption_status |
admin | yes | no | admin |
termix_get_host_defaults |
admin | yes | no | admin |
termix_get_termix_id_status |
admin | yes | no | admin |
termix_list_sso_providers |
admin | yes | no | admin |
termix_update_branding |
admin | no | no | admin |
termix_acknowledge_alert_firing |
alerts | no | no | - |
termix_create_alert_rule |
alerts | no | no | - |
termix_delete_alert_rule |
alerts | no | yes | - |
termix_list_alert_rules |
alerts | yes | no | - |
termix_get_session_log |
audit | yes | no | - |
termix_list_audit_events |
audit | yes | no | - |
termix_list_session_logs |
audit | yes | no | - |
termix_get_automation |
automations | yes | no | - |
termix_list_automations |
automations | yes | no | - |
termix_list_fleets |
automations | yes | no | - |
termix_run_automation |
automations | no | no | data-access |
termix_create_credential |
credentials | no | no | - |
termix_delete_credential |
credentials | no | yes | - |
termix_get_credential |
credentials | yes | no | - |
termix_list_credentials |
credentials | yes | no | - |
termix_reveal_credential |
credentials | yes | no | data-access |
termix_update_credential |
credentials | no | no | - |
termix_get_dashboard_summary |
dashboard | yes | no | - |
termix_get_homepage |
dashboard | yes | no | - |
termix_list_open_tabs |
dashboard | yes | no | - |
termix_list_workspaces |
dashboard | yes | no | - |
termix_get_container |
docker | yes | no | data-access |
termix_get_container_logs |
docker | yes | no | data-access |
termix_get_container_stats |
docker | yes | no | data-access |
termix_list_containers |
docker | yes | no | data-access |
termix_restart_container |
docker | no | no | data-access |
termix_start_container |
docker | no | no | data-access |
termix_stop_container |
docker | no | no | data-access |
termix_create_folder |
files | no | no | data-access |
termix_delete_file |
files | no | yes | data-access |
termix_list_files |
files | yes | no | data-access |
termix_move_file |
files | no | no | data-access |
termix_read_file |
files | yes | no | data-access |
termix_rename_file |
files | no | no | data-access |
termix_write_file |
files | no | no | data-access |
termix_create_host |
hosts | no | no | - |
termix_delete_host |
hosts | no | yes | - |
termix_disable_host_autostart |
hosts | no | no | - |
termix_enable_host_autostart |
hosts | no | no | - |
termix_get_host |
hosts | yes | no | - |
termix_get_network_topology |
hosts | yes | no | - |
termix_list_host_folders |
hosts | yes | no | - |
termix_list_host_tags |
hosts | yes | no | - |
termix_list_hosts |
hosts | yes | no | - |
termix_update_host |
hosts | no | no | - |
termix_get_host_metrics |
metrics | yes | no | - |
termix_get_host_status |
metrics | yes | no | - |
termix_get_metrics_history |
metrics | yes | no | - |
termix_get_proxmox_stats |
metrics | yes | no | - |
termix_list_active_alerts |
metrics | yes | no | - |
termix_list_host_statuses |
metrics | yes | no | - |
termix_create_snippet |
snippets | no | no | - |
termix_delete_snippet |
snippets | no | yes | - |
termix_get_snippet |
snippets | yes | no | - |
termix_list_snippets |
snippets | yes | no | - |
termix_run_snippet |
snippets | no | no | - |
termix_update_snippet |
snippets | no | no | - |
termix_get_preferences |
system | yes | no | - |
termix_get_system_info |
system | yes | no | - |
termix_list_api_keys |
system | yes | no | - |
termix_create_tunnel |
tunnels | no | no | data-access |
termix_delete_tunnel |
tunnels | no | no | data-access |
termix_get_tunnel |
tunnels | yes | no | - |
termix_list_tunnel_presets |
tunnels | yes | no | - |
termix_list_tunnels |
tunnels | yes | no | - |
termix_assign_role |
users | no | no | admin |
termix_get_user |
users | yes | no | admin |
termix_list_credential_access |
users | yes | no | admin |
termix_list_folder_access |
users | yes | no | admin |
termix_list_roles |
users | yes | no | admin |
termix_list_users |
users | yes | no | admin |
Total: 78 tools.
Contributing
See CONTRIBUTING.md.
Security
See SECURITY.md for the threat model.
License
Termix MCP questions
How do I add Termix MCP to Claude Code?
Run claude mcp add --env 'TERMIX_API_KEY=<YOUR_TERMIX_API_KEY>' --env 'TERMIX_URL=<TERMIX_URL>' termix-mcp -- uvx termix-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Termix MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Termix MCP provide?
It exposes 78 tools, including termix_get_audit_forwarding, termix_get_branding, termix_get_encryption_status, termix_get_host_defaults, termix_get_termix_id_status.
What does the Termix MCP server allow an agent to do?
It allows an agent to list and operate Termix hosts, snippets, dashboard, metrics, and audit trails.
How do I install the Termix MCP server?
You can install it using uvx termix-mcp, via pip install termix-mcp, or by using the Docker image ghcr.io/sujirodev/termix-mcp.
Is there a read-only mode available?
Yes, setting the TERMIX_MCP_READ_ONLY environment variable to true will hide and block all tools that are not read-only.
What authentication is required?
The server requires a Termix API key (starting with tmx_) and the Termix base URL.