mcpbeat Sign in

Superuser MCP Server

by fitzyracing1 Your server? Claim it
local only

Superuser runs on your own machine — the client starts it, so there is no endpoint to ping. 71 installs a week from pypi. Last commit 26 Oct 2026.

Permission-gated superuser (sysadmin) MCP agent with enterprise guardrails and audit.

Installs per day peak 234 · avg 17 · +8% w/w
a month agotoday
71
Installs / week
pypi · superuser
3
Stars
5 open issues
26 Oct 2026
Last commit
from GitHub
—
License
Python

What the code does

We read the source, 7 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add superuser -- uvx superuser
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "superuser": {
      "command": "uvx",
      "args": [
        "superuser"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.superuser]
command = "uvx"
args = ["superuser"]
.cursor/mcp.json
{
  "mcpServers": {
    "superuser": {
      "command": "uvx",
      "args": [
        "superuser"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "superuser": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "superuser"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: SUPERUSER_HUMAN_OWNER (Human accountable for the agent's actions (recorded in every audit entry)), SUPERUSER_APPROVAL_AT (Minimum risk level that triggers the human-approval gate: LOW, MEDIUM, HIGH, or CRITICAL), AI_DEFENSE_INSPECTION_API_KEY (Cisco AI Defense Inspection API key for runtime tool-call/response inspection), DUO_TOKEN_URL (Cisco Duo OAuth 2.1 token endpoint (client-credentials) for per-tool-call authorization), DUO_CLIENT_ID (Cisco Duo OAuth client ID for the agent's non-human identity), DUO_CLIENT_SECRET (Cisco Duo OAuth client secret), STRIPE_API_KEY (Stripe secret API key for usage-based (metered) billing).

Alternatives to Superuser

same job, measured the same way
mcp-mail
by annseraf

Self-hosted IMAP/SMTP email for any MCP client, with per-client permissions and audit log.

826 installs/wk local only
ScopeGate
by alifanov

Permission gateway for AI agents: scoped MCP endpoints over 27 services, audited and revocable.

answering
Vorim MCP Server
by vorim-ai-labs

AI agent identity, permissions, trust scores, and tamper-evident audit trails via Vorim AI

87 installs/wk local only
Vorim MCP Server
by kzino

AI agent identity, permissions, trust scores, and tamper-evident audit trails via Vorim AI

local only
Toolstile
by toolstile

Managed MCP gateway with OAuth, per-agent permissions, shared accounts and activity logs.

answering
Toolstile
by akshitkrnagpal

Managed MCP gateway with OAuth, per-agent permissions, shared accounts and activity logs.

answering
BT Ops MCP
by tangchangzhe

Secure MCP server for BT Panel operations with scoped permissions and audited writes.

70 installs/wk local only
Shield
by bolyra

Stdio MCP auth proxy: wrap any MCP server with per-tool permission enforcement.

48 installs/wk local only

Superuser — questions

Answers built from our own checks of this server.

Why is there no uptime for Superuser?
Superuser runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package superuser was installed 71 times last week.
How do I connect Superuser?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls superuser straight from pypi; nothing to host, nothing to sign up for.
How many people use Superuser?
The pypi package superuser was installed 71 times in the last week. Week over week that is +8%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Superuser open source?
We cannot say either way: written in Python, 3 stars on GitHub and 5 open issues, but we could not determine the licence, and without one the code is not open source by default.