MCP server for the IPEX B2B REST API
console applicationapt install mcp-server-ipexAn MCP (Model Context Protocol) server exposing the IPEX B2B REST API (restapi.ipex.cz) as tools for an LLM agent, built on fastmcp and python3-ipex-b2b.
Read tools cover customers, services, phone numbers, calls, invoices, PBX, connectors, price lists and reports. Credit top-ups, SMS and customer updates are registered only when IPEX_READ_ONLY=false. Credentials are read from the environment and are never tool parameters.
MCP server for the IPEX B2B REST API (customers, services,
VoIP/mobile numbers, calls, invoices, PBX, connectors, reports). Built on FastMCP and
python3-ipex-b2b. stdio transport (works with mcprack).
apt install mcp-server-ipex # server
apt install mcprack-mcp-server-ipex # registers it in the local mcprack catalog (read-only)
| 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.
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.
| 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 |
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.
This package may not be indexed in our database yet. Please try again later or check the package repository directly.