RadiusStack MCP Server
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., "@RadiusStack MCP Server show current live stats and list the first 10 users"
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.
RadiusStack MCP Server
A stdio Model Context Protocol server for safe, targeted RadiusStack operations.
Tools
Tool | RadiusStack permission | Purpose |
| reports read-only | Current live statistics |
| users read-only | Paginated users, with passwords redacted |
| users read-only | Usage/authentication statistics for one user |
| users read-write | Create one RADIUS user |
| users read-write | Change selected user properties, including disabled state |
The server deliberately does not proxy arbitrary API routes, return user passwords, manage API keys, control HA, restart containers, operate certificates, or delete users.
Related MCP server: unifi-safe-mcp
Install and configure
The scoped npm package will be available after the first release is published. Until then, install from a checked-out repository with
npm installand use thenodecommand below.
Create a dedicated RadiusStack API administrator/key with only the permissions required by the tools you plan to use. For read-only monitoring, grant reports: read-only and users: read-only. For user creation/updates, additionally grant users: read-write. Do not use a platform administrator key.
Claude Desktop
Add this to your Claude Desktop MCP configuration:
{
"mcpServers": {
"radiusstack": {
"command": "npx",
"args": ["-y", "@radiusstack/mcp-server"],
"env": {
"RADIUSSTACK_URL": "https://radius.example.com",
"RADIUSSTACK_API_KEY": "replace-with-dedicated-least-privilege-key"
}
}
}
}Other MCP clients
Run npx -y @radiusstack/mcp-server as a stdio MCP server, setting RADIUSSTACK_URL and RADIUSSTACK_API_KEY in the client environment. RADIUSSTACK_URL must be an http or https URL; use HTTPS outside a trusted LAN.
Development
npm install
npm test
RADIUSSTACK_URL=https://radius.example.com RADIUSSTACK_API_KEY=... npm startPublishing
Create the public GitHub repository
deangoldhill/radiusstack-mcp-serverand push this directory.Create the public npm organization/scope
@radiusstack(or changenameinpackage.jsonto an available unscoped package name).Authenticate with the npm account that owns the scope:
npm login.From a clean release checkout, run
npm test && npm publish --access public.Create and push a signed tag such as
v0.1.0. The included GitHub Action can publish later tagged releases when anNPM_TOKENrepository secret is configured.Confirm installation from a clean machine:
npx -y @radiusstack/mcp-server --help.
Use semantic versioning. Publish only from a clean, reviewed commit; package contents can be checked before upload with npm pack --dry-run.
Security notes
API keys are supplied only through environment variables and are never logged or returned.
radiusstack_list_usersstrips the RadiusStack API's password field before emitting tool output.The MCP tools are intentionally allowlisted and expose no generic request or command-execution capability.
MCP clients should require user confirmation for mutations. The creation and update tools are marked as non-read-only.
License
MIT
Available Tools
5 toolsradiusstack_create_userCreate RadiusStack userB
Create a RADIUS user. This changes RadiusStack. Confirm the requested username and settings before calling.
Inputs: password (required), username (required), planId, profile, +3 more.
radiusstack_get_live_statsGet RadiusStack live statisticsBRead-onlyIdempotent
Read current RadiusStack live statistics. Requires reports read permission.
Inputs: no named parameters.
radiusstack_get_user_statsGet RadiusStack user statisticsARead-onlyIdempotent
Read usage and authentication statistics for one RadiusStack user.
Inputs: username (required).
radiusstack_list_usersList RadiusStack usersARead-onlyIdempotent
List RadiusStack users. Password fields are removed before results are returned.
Inputs: page, search, pageSize.
radiusstack_update_userUpdate RadiusStack userB
Update selected RadiusStack user settings. This changes RadiusStack. Confirm changes before calling.
Inputs: username (required), planId, profile, disabled, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a distinct resource and action: live server stats, user listing, per-user stats, user creation, and user update. The two stats tools are clearly separated by scope (global live stats vs. single-user usage/auth stats).
All tools use the same radiusstack_ prefix followed by a clear verb_noun pattern. The naming is predictable and consistent across the entire surface.
Five tools are well within the ideal range for a focused RADIUS user-management server. Each tool maps to a meaningful operation and there is no obvious bloat.
The set covers listing, creating, updating, and reading stats for users, but lacks user deletion and a direct get-user/profile operation. These are notable lifecycle gaps for a user-management domain and may force workarounds.
Maintenance
Related MCP Connectors
Scoped, audited SSH exec, sessions, and SFTP on your saved servers without exposing credentials
Manage remote servers, SSH terminals, files, databases and proxies with scoped access and approvals.
Manage API keys, identities, permissions, rate-limit overrides and verification analytics.
Read-only access to an OnlyFans agency's OnlyStack data: fans, chats, earnings and creators.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables policy-enforced access to dangerous tools like file read/write/delete and shell execution, with approval workflows, risk classification, and audit logging.-
- AlicenseDqualityDmaintenanceEnables read-only, bounded access to UniFi Network appliance health, devices, and active clients through three safe MCP tools with TLS verification and redirect rejection.3MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to securely invoke only allowlisted, read-only tools on a local Kali Linux host over an encrypted network with OAuth2 authentication and least-privilege enforcement.2Apache 2.0
- AlicenseAqualityBmaintenanceEnables AI clients to check status, read non-secret settings, schedules, and subject rules, and—when explicitly allowed—update settings and existing subject rules. It also supports local diagnostic workflows while excluding passwords, credentials, arbitrary SQL, files, and shell commands.131MIT