SkillFoxx

Selectel balance MCP server

Selectel MCP Server

A Selectel billing MCP server: balance and spend predictions via a service user, with automatic token refresh and an audit log

  • 0 ★ on the repository
  • Last commit
MCP server

Extended access

Why this level

  • It stores the Selectel service user password in its own database
  • It reads the account's financial data, though it does not change payments itself
All reasons and checks
Russian stack

eduardguselnikov/mcp_selectel_billingAuthor:EduardGuselnikov

Install

Services

Manual install

docker compose up --build

Running via Docker Compose after configuring .env; migrations apply automatically.

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • It stores the Selectel service user password in its own database
  • It reads the account's financial data, though it does not change payments itself

This is third-party code. Review the repository files before installing.

What it does

The server provides three tools: connecting a Selectel account via a service user, getting the current balance, and getting the spend prediction. Credentials are entered once via .env, the REST API or the connect_selectel_account tool, after which a FastAPI application with PostgreSQL stores them and refreshes the Selectel access token every 24 hours with no user involvement. Every MCP tool call is written to an audit log. There is a separate stdio entry point for Hermes Agent and a regular HTTP mode via docker compose.

Who it is for. For those who want an agent to watch their Selectel balance and spend forecast without manually refreshing a token.

Good fit when

  • You only need the Selectel balance and spend forecast, not resource management
  • You need the Selectel token refreshed automatically once a day
  • You need an audit log of all tool calls

Not a fit when

  • You need to manage Selectel servers, networks or storage: this covers only billing
  • You are not ready to run PostgreSQL to store tokens and credentials

Example request

Check the Selectel balance and tell me if the funds will last until the end of the month based on the spend forecast

MCP

Transport
stdio, http
Authentication
API key

Environment variables

SELECTEL_ACCOUNT_ID required
The Selectel account ID.
SELECTEL_SERVICE_USER_NAME required
The Selectel service user name.
SELECTEL_SERVICE_USER_PASSWORD required, secret
The Selectel service user password.
DATABASE_URL required, secret
The PostgreSQL or sqlite connection string used to store the token and audit log.

Limitations

The README explicitly calls the project an MVP. Functionality is limited to the balance and spend forecast; there is no Selectel resource management. Storing credentials and the token needs PostgreSQL, though a local SQLite option exists for running without Docker. It requires a Selectel service user with a password that is stored in the server's database.

How to disable. Stop docker compose or the server process and remove it from your MCP client configuration.

FAQ

Do I need to refresh the Selectel token manually?

No, the server refreshes the token itself every 24 hours after the account is first connected.

Can it run without Docker?

Yes, locally via venv and pip, but you need a separately running PostgreSQL or sqlite for storage.

Discussion

No questions or reviews yet.

All Selectel tools
Russian stack

A FastMCP Selectel Cloud Platform server for projects, resources and quotas, planned as the first of six service-specific MCPs

MCP serverExtended access
Russian stack

An unofficial Selectel cloud MCP server: OpenStack servers, S3 storage, billing and one-call Docker app deploys

MCP serverBroad access1

selvpc (Selectel VPC)

python-selvpcclient

Official

Python client and selvpc CLI for the Selectel cloud platform API

CLIBroad access8

An MCP server for Tally Prime: reports, masters and vouchers from the accounting program are available to Claude and ChatGPT.

MCP serverBroad access110

README in short

The Russian README describes an MVP MCP server for getting the Selectel balance via a service user: connecting the account once, automatic token refresh, three MCP tools and a call audit log. It gives the stack (FastAPI, PostgreSQL, SQLAlchemy 2.x, Alembic, Docker), the project structure, and three run paths: docker compose, running locally without Docker, and .env configuration.

README badge

Report a problem