Kontomanager

Provides tools to read account data, manage bills, and modify SIM settings for Kontomanager brands yesss, Georg, and XOXO.

python

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "dhofer-mcp-server-kontomanager": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/absolute/path/to/mcp-server-kontomanager",
        "python",
        "src/server.py"
      ],
      "env": {
        "KONTOMANAGER_BRAND": "yesss",
        "KONTOMANAGER_PASSWORD": "your_secret_password",
        "KONTOMANAGER_USERNAME": "43681..."
      }
    }
  }
}

You can use this MCP server to programmatically manage Kontomanager for yesss, Georg, and XOXO. It exposes actions like reading account data, checking usage, downloading bills, and adjusting SIM settings through a practical set of tools, enabling you to automate common tasks from an MCP client or an LLM-powered workflow.

How to use

Use an MCP client to call the available tools and perform real-world tasks on your Kontomanager account. You can retrieve an overview of your account, list numbers, check recent usage, view and download bills, and adjust settings like roaming and call forwarding. Choose high-level workflows for common actions, such as disabling voicemail, by invoking the corresponding tools in the right sequence.

How to install

Prerequisites you need to prepare before starting: ensure you have Python installed (version 3.8+ is recommended) and that your MCP client can run local commands via uv. You will also need Git to clone the repository.

Steps to set up and run the MCP server from your environment:

# 1. Clone the repository
git clone https://github.com/dhofer/mcp-server-kontomanager.git

# 2. Note the absolute path to the cloned repo (you will use this in your MCP client config)
# Example: /absolute/path/to/mcp-server-kontomanager

Configure your MCP client to start the server using the following command structure. Replace the absolute path with the location you cloned to, and fill in your Kontomanager credentials.

{
  "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"
      }
    }
  }
}

Additional setup notes

Set the environment variables shown in the example whenever you deploy the MCP server. These values connect you to your Kontomanager account for the specified brand and credentials.

Available tools

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

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.

switch_active_phone_number

Switches the active phone number for the session.

toggle_roaming

Enable or disable international roaming.

set_sim_setting

Enable or disable a specific SIM setting.

set_call_forwarding_rule

Configure a specific call forwarding rule (e.g., forward when busy to a specific number).

Built by

VeilStrat

AI signals for GTM teams