utils MCP server
Commit Nov 9, 2026Connects AI assistants to utility portals like DESCO and NESCO to check balances and usage through local modular connectors.
Also known as bixbd/utils-mcp
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 9, 2026
- License
- MIT
What is utils MCP?
utils connects AI assistants to utility portals like DESCO and NESCO to check balances and usage through local modular connectors.
Summary generated from the project's README
About utils MCP server
Checking utility balances and usage through an AI assistant is what utils-mcp enables for users of various AI clients. This local MCP server uses modular connectors to link your assistant to specific service portals like DESCO and NESCO. By running locally on your machine, it ensures that your login credentials stay within your own environment, using your computer's secure keychain or environment variables to manage access.
Developers can integrate this server into Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, or Gemini CLI. The setup process is straightforward, requiring Node.js 18 or newer. You can use the npx setup command to automatically configure your AI applications or manually add the server to your configuration files. The system is designed for privacy, as sessions live only in memory and account numbers are masked before the AI sees them.
What you can do with it
- 1Check prepaid electricity balancesAsk your AI assistant to retrieve the current prepaid balance for your DESCO account.
Written from the project's README. Every use case is checked against a quote from it.
Configuration
DESCO_PASSWORDDESCO_USERNAME
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablebixbd/utils-mcp is public and reachablegithub.com/bixbd/utils-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-09github.com/bixbd/utils-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubutils-mcp
Let your AI assistant use everyday utility portals for you. Ask in plain language, get the answer, and keep your credentials on your own computer.
Beta. Published on npm under the
nexttag. More connectors are coming.
"What's my DESCO prepaid balance?"
utils-mcp is a local MCP server. Each utility portal is a small connector that gives your AI a few clear tools. You turn on only the connectors you need.
Quick start
Claude Desktop, no terminal: download utils-mcp.mcpb from the latest release, double-click it, click Install, and enter your DESCO login in the form. Your password is kept in your computer's secure keychain. Then ask: "What's my DESCO prepaid balance?"
Any other AI app (2 steps): you need Node.js 18 or newer (the normal installer is fine) and any AI app that supports MCP.
1. Run the setup
npx -y @bixbd/utils-mcp@next setup
It asks for your portal login, finds your AI apps (Claude Desktop, Claude Code, Cursor, Windsurf, VS Code, Gemini CLI) and adds itself to them. Nothing else to install or edit.
2. Restart your AI app and ask: "What's my DESCO prepaid balance?"
Another AI app, or you prefer to do it by hand
Any app that can run an MCP server works. Add this to its MCP settings (the format is the same everywhere):
{
"mcpServers": {
"utils": {
"command": "npx",
"args": ["-y", "@bixbd/utils-mcp@next"],
"env": { "DESCO_USERNAME": "your-username", "DESCO_PASSWORD": "your-password" }
}
}
}
Claude Code: claude mcp add utils -e DESCO_USERNAME=your-username -e DESCO_PASSWORD=your-password -- npx -y @bixbd/utils-mcp@next
Several accounts per portal, choosing connectors, and troubleshooting are in the server guide.
Available connectors
| Connector | What you can ask | Credentials |
|---|---|---|
desco |
List linked DESCO prepaid accounts, check the balance, see the realtime-reading status | DESCO_USERNAME, DESCO_PASSWORD |
Don't see your portal? Request a connector or build one.
Your data and safety
- It runs on your computer. There is no hosted service and no account with us.
- Credentials are read from environment variables you set, and are sent only to the portal over HTTPS.
- Sessions live in memory and are never written to disk. Account numbers are masked in what the AI sees.
- Connectors are unofficial and not affiliated with the portals. Use only accounts you own or may access.
Contribute
Help is welcome, from a bug report to a whole new connector.
- How to contribute: ways to help, setup, commit and PR rules.
- Adding a connector: step-by-step guide with the standard and checklist.
- Releasing: for maintainers.
Repo layout
packages/server The MCP server and CLI. The only npm package: @bixbd/utils-mcp
packages/core defineConnector/defineTool, auth strategies, HTTP client (bundled, not published)
packages/testkit Conformance checks, fakePortal, replayFetch (dev only)
connectors/* One folder per portal, bundled into the server (not published)
tools/* Generator, repo rules, commit and secret checks, release scripts
docs/ Guides
Everything ships as one npm package, @bixbd/utils-mcp. The other folders are workspaces used for development.
MIT License. Built in the open by BixBD.
NESCO prepaid (beta): set NESCO_METER_ID to an authorized 8–11 digit meter or customer number. Tools: nesco_get_meter_status, nesco_get_recharge_history, nesco_get_monthly_usage. Successful account responses remain unverified; see connector documentation.
RapidPass smart card (beta): set RAPIDPASS_COOKIES (cookie header from a logged-in browser; safest) or RAPIDPASS_EMAIL/RAPIDPASS_PASSWORD. Tools: rapidpass_get_cards, rapidpass_get_travel_history, rapidpass_get_recharge_transactions (the last needs a verified email); see connector documentation.
utils MCP questions
How do I install utils-mcp on Claude Desktop?
Download the utils-mcp.mcpb file from the latest release, double-click it, click Install, and enter your login credentials.
Is my data safe with this server?
Yes, the server runs locally on your computer with no hosted service, and credentials are sent only to the portal over HTTPS.
What utility portals are currently supported?
Currently, it supports DESCO, NESCO prepaid (beta), and RapidPass smart card (beta).