Kontomanager
About
An unofficial server for managing Austrian mobile accounts for brands like yesss!, Georg, and XOXO.
Details
- Author
- dhofer
- Categories
- Cloud Service, Other, Developer Tools, Infrastructure
Jump to
Setup
Install Kontomanager in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/dhofer/mcp-server-kontomanager
Follow the installation instructions in the repository README, then restart your MCP client.
An unofficialMCPserver for the Austrian mobile brandsyesss!,Georg, andXOXO.
This server acts as a bridge, exposing the functionalities of the Kontomanager web interface through a structured set of MCP tools. It allows you to programmatically read account information, check usage, download bills, and modify settings like call forwardings.
This server is designed with atool-firstapproach for broad client support. It provides a comprehensive set of functions mirroring the web portal:
- Read Account Data: Fetch usage, credit, plan details, phone numbers, and call history.
- Manage Bills: List past bills and download their PDF content.
- Modify Settings: Change SIM settings like roaming and configure detailed call forwarding rules.
- High-Level Workflows: Use simple tools for common actions like disabling voicemail.
The server exposes all functionality through tools, which can be called by an MCP client or an LLM.
- get_account_usage(): Retrieves the main account overview, including plan details, usage statistics, and credit balance.
- get_phone_numbers(): Lists all phone numbers associated with the logged-in account.
- list_bills(): Fetches a list of available bills (metadata only).
- download_bill(bill_number, document_type): Fetches a specific bill or its itemized record (EGN) and returns its binary content (PDF).
- get_call_history(): Retrieves a list of recent calls and SMS messages.
- get_sim_settings(): Reads the current state of all SIM-related settings (e.g., roaming status, data barring).
- get_call_forwarding_settings(): Reads the current call forwarding and voicemail settings.
You can interact with this server using natural language in a compatible MCP client. The client's LLM will select and execute the appropriate tools.
- "What's my current data usage and credit?"
- → Callsget_account_usage()
- → Callsdownload_bill(bill_number='8177', document_type='bill')
- → Callsdownload_bill(bill_number='8177', document_type='egn')
- → Callsset_call_forwarding_rule(condition='wtel', target='a', target_number='+436811234567')
The server requires your Kontomanager credentials. These must be provided via environment variables, which you will set in your MCP client's configuration file.
- KONTOMANAGER_BRAND: The brand of your mobile carrier. Supported values:"yesss","georg","xoxo".
- KONTOMANAGER_USERNAME: Your login phone number or username.
- KONTOMANAGER_PASSWORD: Your Kontomanager account password.
This project is an MCP server and is designed to be launched and managed by an MCP client. You do not run it standalone.
git clone https://github.com/dhofer/mcp-server-kontomanager.git
Configure your MCP client:Add a new server definition to your MCP client's configuration file. The command will useuv runto execute the server from its local directory. Make sure to use theabsolute pathto the cloned repository.
{ "mcpServers": { "kontomanager": { "command": "uv", "args": [ "run", "--directory", "/absolute/path/to/mcp-server-kontomanager", "python", "src/server.py" ], "env": { "KONTOMANAGER_BRAND": "yesss", "KONTOMANAGER_USERNAME": "43681...", "KONTOMANAGER_PASSWORD": "your_secret_password" } } } }
When you use this MCP server, any data retrieved by the tools (like your account usage, phone numbers, or bill details) is sent to the Large Language Model (LLM) that powers your MCP client.This means a third-party company (e.g., OpenAI, Google, Anthropic) will process this potentially sensitive information.Please be aware of the privacy implications and review your LLM provider's policies before using this server.
This server provides tools that can change your mobile account settings in real-time. Actions liketoggle_roamingorset_call_forwarding_rulecan lead tosignificant, real-world charges on your phone bill, especially if misconfigured. You are solely responsible for any and all costs incurred as a result of using these tools.Use them with extreme caution.
This project is, for all intents and purposes,vibe coded. It was built based on intuition and the specific needs of the developer. While it aims to be functional, it may not follow the strictest engineering practices and has limited tests. Pull requests for improving robustness, adding tests, or refining the code are highly encouraged!
Disclaimer:This is an unofficial project and is not affiliated with, endorsed, or supported by A1 Telekom Austria AG or any of its brands. The Kontomanager website structure can change at any time, which may break the functionality of this server. Use at your own risk.
Get prescriptive CDK advice, explain CDK Nag rules, check suppressions, generate Bedrock Agent schemas, and discover AWS Solutions Constructs patterns.
Interact with the Appwrite API to manage your backend services.
A Node.js server for the Model Context Protocol that provides access to the Autodesk Platform Services (APS) API with fine-grained access control.
An experimental MCP server providing access to the Autodesk Platform Services (APS) API.
An example MCP server deployed on Cloudflare Workers, without authentication.
A template for deploying a remote, authentication-free MCP server on Cloudflare Workers. Tools are defined directly in the source code.
A remote MCP server deployable on Cloudflare Workers or runnable locally, requiring no authentication or external data files.
Integrate with the Codehooks.io serverless backend platform.
Deploy and manage applications, databases, domains, and git repos via MCP
An open MCP service providing a standardized interface compatible with various MCP clients.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
