mcp-server-ipex

mcp-server-ipex

MCP server for the IPEX B2B REST API

console application
Install
apt install mcp-server-ipex
Description

An 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.

๐ŸŒ Homepage๐Ÿ“ฆ GitHub๐Ÿ› Issues๐Ÿ“‹ Package details

mcp-server-ipex

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).

Install

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

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.

Package "mcp-server-ipex" not found

This package may not be indexed in our database yet. Please try again later or check the package repository directly.

Browse Repository