mcp-server-ipex
# mcp-server-ipex
MCP server for the [IPEX B2B REST API](https://restapi.ipex.cz/documentation) (customers, services,
VoIP/mobile numbers, calls, invoices, PBX, connectors, reports). Built on FastMCP and
[`python3-ipex-b2b`](https://github.com/Spoje-NET/python3-ipex-b2b). stdio transport (works with mcprack).
## Install
```sh
apt install mcp-server-ipex # server
apt install mcprack-mcp-server-ipex # registers it in the local mcprack catalog (read-only)
```
## Configuration (environment)
| Variable | Secret | Default | Description |
|---|---|---|---|
| `IPEX_LOGIN` | no | - | API user name (required) |
| `IPEX_PASSWORD` | **yes** | - | API password (required) |
| `IPEX_URL` | no | `https://restapi.ipex.cz` | API base URL (`https://testapi.ipex.cz` for tests) |
| `IPEX_VERIFY_SSL` | no | `true` | Verify the server TLS certificate |
| `IPEX_READ_ONLY` | no | `true` | `false` also registers the tools that change data |
| `IPEX_MAX_RESPONSE_CHARS` | no | `60000` | Truncate larger responses (and say so) |
Credentials are never tool parameters and never appear in errors.
## Read-only mode
By default only read tools are registered. `IPEX_READ_ONLY=false` adds `add_voip_credit`,
`add_mobile_credit`, `send_sms`, `patch_customer` and `update_customer`. Credit and SMS have real,
irreversible effects - the assistant should ask the user for confirmation first.
The library `python3-ipex-b2b` covers every API operation; the other mutating ones
(deactivate, port-in, delete, ...) are intentionally not exposed as tools.
## Tools (80)
| Tool | Title | Annotation class |
|---|---|---|
| `alive` | Alive | READ_ONLY |
| `health` | Health | READ_ONLY |
| `get_calls` | Get Calls | READ_ONLY |
| `get_calls_technical_overview` | Get Calls Technical Overview | READ_ONLY |
| `list_connectors` | List Connectors | READ_ONLY |
| `list_customers` | List Customers | READ_ONLY |
| `list_ict_price_lists` | List Ict Price Lists | READ_ONLY |
| `list_invoices` | List Invoices | READ_ONLY |
| `list_pbx` | List Pbx | READ_ONLY |
| `list_phone_numbers_v1` | List Phone Numbers V1 | READ_ONLY |
| `list_requests` | List Requests | READ_ONLY |
| `get_rights` | Get Rights | READ_ONLY |
| `list_services` | List Services | READ_ONLY |
| `list_wholesale_invoices` | List Wholesale Invoices | READ_ONLY |
| `list_phone_numbers` | List Phone Numbers | READ_ONLY |
| `get_account` | Get Account | READ_ONLY |
| `get_connector_analysis` | Get Connector Analysis | READ_ONLY |
| `list_connector_invoices_all` | List Connector Invoices All | READ_ONLY |
| `get_connector` | Get Connector | READ_ONLY |
| `list_containers` | List Containers | READ_ONLY |
| `get_customer` | Get Customer | READ_ONLY |
| `update_customer` | Update Customer | MUTATE |
| `patch_customer` | Patch Customer | ASSIGN |
| `get_free_units_history` | Get Free Units History | READ_ONLY |
| `get_helpdesk` | Get Helpdesk | READ_ONLY |
| `get_ict_price_list` | Get Ict Price List | READ_ONLY |
| `list_internet_types` | List Internet Types | READ_ONLY |
| `get_internet` | Get Internet | READ_ONLY |
| `list_invoice_item_ids` | List Invoice Item Ids | READ_ONLY |
| `get_invoice_item` | Get Invoice Item | READ_ONLY |
| `get_invoices_by_payment_type` | Get Invoices By Payment Type | READ_ONLY |
| `get_mobile` | Get Mobile | READ_ONLY |
| `get_provider_settings` | Get Provider Settings | READ_ONLY |
| `get_report_customers` | Get Report Customers | READ_ONLY |
| `get_report_numbers` | Get Report Numbers | READ_ONLY |
| `get_request` | Get Request | READ_ONLY |
| `search_ruian` | Search Ruian | READ_ONLY |
| `search_services_fulltext` | Search Services Fulltext | READ_ONLY |
| `list_shared_services` | List Shared Services | READ_ONLY |
| `get_service` | Get Service | READ_ONLY |
| `get_support` | Get Support | READ_ONLY |
| `get_tariff_plan` | Get Tariff Plan | READ_ONLY |
| `check_ticketing_user` | Check Ticketing User | READ_ONLY |
| `get_current_user` | Get Current User | READ_ONLY |
| `list_voip_profiles` | List Voip Profiles | READ_ONLY |
| `get_voip` | Get Voip | READ_ONLY |
| `get_phone_number_diagnostic` | Get Phone Number Diagnostic | READ_ONLY |
| `list_connector_invoices` | List Connector Invoices | READ_ONLY |
| `list_connector_phone_numbers` | List Connector Phone Numbers | READ_ONLY |
| `list_container_roaming_profiles` | List Container Roaming Profiles | READ_ONLY |
| `list_container_phone_numbers` | List Container Phone Numbers | READ_ONLY |
| `list_container_data_packs` | List Container Data Packs | READ_ONLY |
| `list_container_flat_packs` | List Container Flat Packs | READ_ONLY |
| `list_container_simcards` | List Container Simcards | READ_ONLY |
| `get_customer_name` | Get Customer Name | READ_ONLY |
| `list_customer_users` | List Customer Users | READ_ONLY |
| `get_ict_price_list_item` | Get Ict Price List Item | READ_ONLY |
| `get_invoices_print` | Get Invoices Print | READ_ONLY |
| `list_mobile_portation_dates` | List Mobile Portation Dates | READ_ONLY |
| `get_mobile_credit` | Get Mobile Credit | READ_ONLY |
| `add_mobile_credit` | Add Mobile Credit | EXTERNAL_EFFECT |
| `get_report_ctu` | Get Report Ctu | READ_ONLY |
| `get_report_top_customers` | Get Report Top Customers | READ_ONLY |
| `get_ruian_address` | Get Ruian Address | READ_ONLY |
| `get_service_properties` | Get Service Properties | READ_ONLY |
| `get_sms_integration` | Get Sms Integration | READ_ONLY |
| `get_tariff_plan_price` | Get Tariff Plan Price | READ_ONLY |
| `list_tariff_plan_trunk_types` | List Tariff Plan Trunk Types | READ_ONLY |
| `get_voip_credit` | Get Voip Credit | READ_ONLY |
| `add_voip_credit` | Add Voip Credit | EXTERNAL_EFFECT |
| `get_voip_state` | Get Voip State | READ_ONLY |
| `get_report_provider_customers_count` | Get Report Provider Customers Count | READ_ONLY |
| `get_report_provider_requests_count` | Get Report Provider Requests Count | READ_ONLY |
| `get_report_zoom_provider` | Get Report Zoom Provider | READ_ONLY |
| `get_report_connector_phone_numbers_count` | Get Report Connector Phone Numbers Count | READ_ONLY |
| `get_report_customer_services_count` | Get Report Customer Services Count | READ_ONLY |
| `get_report_customer_requests_count` | Get Report Customer Requests Count | READ_ONLY |
| `get_report_zoom_customer` | Get Report Zoom Customer | READ_ONLY |
| `get_report_customer_invoices_sum` | Get Report Customer Invoices Sum | READ_ONLY |
| `send_sms` | Send Sms | EXTERNAL_EFFECT |
## Development
```sh
pytest # no live backend needed
python3 -m mcprack.manifest sync --check ... # keep server.json in sync with the tools
```
Package: `mcp-server-ipex`, module `mcp_server_ipex`, license MIT.
TDQS
Scored across 75 tools
Most tools map to distinct REST paths and are separable by resource (connectors, containers, customers, invoices, reports), but there are several near-duplicate clusters: list_phone_numbers vs the deprecated list_phone_numbers_v1, and a dense family of get_report_* count/sum tools whose one-line descriptions (e.g. 'Customer count' vs 'Customer count (provider)') are easy to misselect. get_invoice_item is described as 'Get virtual service detail', which blurs it against get_service, and get_customer/get_customer_name/list_customers require reading the path to distinguish.
Strong overall verb_noun snake_case pattern (get_*, list_*, search_*, check_*) applied uniformly across ~70 tools. Minor deviations: bare 'alive' and 'health', plus the '_v1' version suffix on the deprecated phone-number tool, break the pattern slightly.
75 tools is far beyond a well-scoped set and effectively a 1:1 dump of every GET endpoint in the IPEX API, forcing the agent to sift through many narrow report and per-resource sub-lists. The surface could be consolidated (generic report tool, parameterized sub-resource listings) without losing capability.
The surface is entirely read-only: every tool is a GET, with no create/update/delete for orders, customers, services, or invoices, so lifecycle workflows (e.g. placing an order, modifying a service) dead-end. Coverage of reads is broad, but for a provisioning/billing API this is a significant functional gap.