mcp-server-ipex
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-server-ipex show me the last 10 calls for VoIP number 420777123456"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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)Related MCP server: TCXC MCP Server
Configuration (environment)
Variable | Secret | Default | Description |
| no | - | API user name (required) |
| yes | - | API password (required) |
| no |
| API base URL ( |
| no |
| Verify the server TLS certificate |
| no |
|
|
| no |
| 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 | READ_ONLY |
| Health | READ_ONLY |
| Get Calls | READ_ONLY |
| Get Calls Technical Overview | READ_ONLY |
| List Connectors | READ_ONLY |
| List Customers | READ_ONLY |
| List Ict Price Lists | READ_ONLY |
| List Invoices | READ_ONLY |
| List Pbx | READ_ONLY |
| List Phone Numbers V1 | READ_ONLY |
| List Requests | READ_ONLY |
| Get Rights | READ_ONLY |
| List Services | READ_ONLY |
| List Wholesale Invoices | READ_ONLY |
| List Phone Numbers | READ_ONLY |
| Get Account | READ_ONLY |
| Get Connector Analysis | READ_ONLY |
| List Connector Invoices All | READ_ONLY |
| Get Connector | READ_ONLY |
| List Containers | READ_ONLY |
| Get Customer | READ_ONLY |
| Update Customer | MUTATE |
| Patch Customer | ASSIGN |
| Get Free Units History | READ_ONLY |
| Get Helpdesk | READ_ONLY |
| Get Ict Price List | READ_ONLY |
| List Internet Types | READ_ONLY |
| Get Internet | READ_ONLY |
| List Invoice Item Ids | READ_ONLY |
| Get Invoice Item | READ_ONLY |
| Get Invoices By Payment Type | READ_ONLY |
| Get Mobile | READ_ONLY |
| Get Provider Settings | READ_ONLY |
| Get Report Customers | READ_ONLY |
| Get Report Numbers | READ_ONLY |
| Get Request | READ_ONLY |
| Search Ruian | READ_ONLY |
| Search Services Fulltext | READ_ONLY |
| List Shared Services | READ_ONLY |
| Get Service | READ_ONLY |
| Get Support | READ_ONLY |
| Get Tariff Plan | READ_ONLY |
| Check Ticketing User | READ_ONLY |
| Get Current User | READ_ONLY |
| List Voip Profiles | READ_ONLY |
| Get Voip | READ_ONLY |
| Get Phone Number Diagnostic | READ_ONLY |
| List Connector Invoices | READ_ONLY |
| List Connector Phone Numbers | READ_ONLY |
| List Container Roaming Profiles | READ_ONLY |
| List Container Phone Numbers | READ_ONLY |
| List Container Data Packs | READ_ONLY |
| List Container Flat Packs | READ_ONLY |
| List Container Simcards | READ_ONLY |
| Get Customer Name | READ_ONLY |
| List Customer Users | READ_ONLY |
| Get Ict Price List Item | READ_ONLY |
| Get Invoices Print | READ_ONLY |
| List Mobile Portation Dates | READ_ONLY |
| Get Mobile Credit | READ_ONLY |
| Add Mobile Credit | EXTERNAL_EFFECT |
| Get Report Ctu | READ_ONLY |
| Get Report Top Customers | READ_ONLY |
| Get Ruian Address | READ_ONLY |
| Get Service Properties | READ_ONLY |
| Get Sms Integration | READ_ONLY |
| Get Tariff Plan Price | READ_ONLY |
| List Tariff Plan Trunk Types | READ_ONLY |
| Get Voip Credit | READ_ONLY |
| Add Voip Credit | EXTERNAL_EFFECT |
| Get Voip State | READ_ONLY |
| Get Report Provider Customers Count | READ_ONLY |
| Get Report Provider Requests Count | READ_ONLY |
| Get Report Zoom Provider | READ_ONLY |
| Get Report Connector Phone Numbers Count | READ_ONLY |
| Get Report Customer Services Count | READ_ONLY |
| Get Report Customer Requests Count | READ_ONLY |
| Get Report Zoom Customer | READ_ONLY |
| Get Report Customer Invoices Sum | READ_ONLY |
| Send Sms | EXTERNAL_EFFECT |
Development
pytest # no live backend needed
python3 -m mcprack.manifest sync --check ... # keep server.json in sync with the toolsPackage: mcp-server-ipex, module mcp_server_ipex, license MIT.
Available Tools
75 toolsaliveAliveARead-onlyIdempotent
Alive check route. IPEX API: GET /alive.
Inputs: no named parameters.
check_ticketing_userCheck Ticketing UserBRead-onlyIdempotent
Get requestor user by username. IPEX API: GET /v1/ticketing/check-user.
Inputs: no named parameters.
get_accountGet AccountBRead-onlyIdempotent
Get provider user. IPEX API: GET /v1/accounts/{username}.
Inputs: username (required).
get_callsGet CallsCRead-onlyIdempotent
Call listing (výpis hovorů). IPEX API: GET /v1/calls.
Inputs: dateFrom (required), dateTo, number, showUID, +9 more.
get_calls_technical_overviewGet Calls Technical OverviewCRead-onlyIdempotent
VoIP technical overview. IPEX API: GET /v1/calls/technical-overview.
Inputs: dateTo, number, dateFrom.
get_connectorGet ConnectorCRead-onlyIdempotent
Connector detail. IPEX API: GET /v1/connectors/{connectorId}.
Inputs: connectorId (required).
get_connector_analysisGet Connector AnalysisDRead-onlyIdempotent
Connector analysis. IPEX API: GET /v1/analysis/connector.
Inputs: periodFrom (required), periodTo.
get_current_userGet Current UserBRead-onlyIdempotent
Get the authenticated user. IPEX API: GET /v1/users/me.
Inputs: detail.
get_customerGet CustomerCRead-onlyIdempotent
Customer detail. IPEX API: GET /v1/customers/{id}.
Inputs: id (required).
get_customer_nameGet Customer NameBRead-onlyIdempotent
Customer name for the given id. IPEX API: GET /v1/customers/customername/{id}.
Inputs: id (required).
get_free_units_historyGet Free Units HistoryCRead-onlyIdempotent
Free units usage history. IPEX API: GET /v1/freeUnits/history.
Inputs: year (required), month (required), number.
get_helpdeskGet HelpdeskCRead-onlyIdempotent
Get service helpdesk detail. IPEX API: GET /v1/helpdesk/{id}.
Inputs: id (required).
get_ict_price_listGet Ict Price ListCRead-onlyIdempotent
Get pricelist detail. IPEX API: GET /v1/ictPriceList/{id}.
Inputs: id (required).
get_ict_price_list_itemGet Ict Price List ItemBRead-onlyIdempotent
Get pricelist item. IPEX API: GET /v1/ictPriceList/items/{itemId}.
Inputs: itemId (required).
get_internetGet InternetBRead-onlyIdempotent
Get internet service detail. IPEX API: GET /v1/internet/{id}.
Inputs: id (required).
get_invoice_itemGet Invoice ItemCRead-onlyIdempotent
Get virtual service detail. IPEX API: GET /v1/invoiceItem/{id}.
Inputs: id (required).
get_invoices_by_payment_typeGet Invoices By Payment TypeCRead-onlyIdempotent
Invoicing base data by payment type. IPEX API: GET /v1/invoices/{paymentType}.
Inputs: paymentType (required), analysis, monthOffset.
get_invoices_printGet Invoices PrintBRead-onlyIdempotent
Printable output of invoicing base data. IPEX API: GET /v1/invoices/{paymentType}/{fileFormat}.
Inputs: fileFormat (required), paymentType (required), include, customerId, +1 more.
get_mobileGet MobileCRead-onlyIdempotent
Mobile number detail. IPEX API: GET /v1/mobile/{number}.
Inputs: number (required), iccid, detail.
get_mobile_creditGet Mobile CreditBRead-onlyIdempotent
Credit history of a mobile. IPEX API: GET /v1/mobile/{number}/credit.
Inputs: number (required).
get_phone_number_diagnosticGet Phone Number DiagnosticCRead-onlyIdempotent
Number diagnostic detail. IPEX API: GET /v2/phone-numbers/diagnostic.
Inputs: number (required), full.
get_provider_settingsGet Provider SettingsCRead-onlyIdempotent
Provider settings. IPEX API: GET /v1/providers/settings.
Inputs: no named parameters.
get_report_connector_phone_numbers_countGet Report Connector Phone Numbers CountBRead-onlyIdempotent
Phone number count of a connector. IPEX API: GET /v1/reports/connectors/{connectorId}/phoneNumbers/count.
Inputs: connectorId (required).
get_report_ctuGet Report CtuCRead-onlyIdempotent
ČTÚ statistics. IPEX API: GET /v1/reports/cz/ctu.
Inputs: byType, dateTo, dateFrom, statsType.
get_report_customer_invoices_sumGet Report Customer Invoices SumCRead-onlyIdempotent
Sum of invoices of a customer. IPEX API: GET /v1/reports/customers/{customerId}/invoices/sum/{monthOffset}.
Inputs: customerId (required), monthOffset (required).
get_report_customer_requests_countGet Report Customer Requests CountCRead-onlyIdempotent
Order count of a customer. IPEX API: GET /v1/reports/customers/{customerId}/requests/count.
Inputs: customerId (required).
get_report_customersGet Report CustomersCRead-onlyIdempotent
Customer count. IPEX API: GET /v1/reports/customers.
Inputs: no named parameters.
get_report_customer_services_countGet Report Customer Services CountCRead-onlyIdempotent
Service count of a customer. IPEX API: GET /v1/reports/customers/{customerId}/services/count.
Inputs: customerId (required), type.
get_report_numbersGet Report NumbersCRead-onlyIdempotent
Service count. IPEX API: GET /v1/reports/numbers.
Inputs: show, status, customerId, numberType, +1 more.
get_report_provider_customers_countGet Report Provider Customers CountCRead-onlyIdempotent
Customer count (provider). IPEX API: GET /v1/reports/providers/customers/count.
Inputs: no named parameters.
get_report_provider_requests_countGet Report Provider Requests CountCRead-onlyIdempotent
Order count (provider). IPEX API: GET /v1/reports/providers/requests/count.
Inputs: state.
get_report_top_customersGet Report Top CustomersCRead-onlyIdempotent
Top customers. IPEX API: GET /v1/reports/providers/top-customers.
Inputs: top, order.
get_report_zoom_customerGet Report Zoom CustomerCRead-onlyIdempotent
Zoom call detail (customer). IPEX API: GET /v1/reports/zoom/customer/{customerId}/{month}.
Inputs: month (required), customerId (required).
get_report_zoom_providerGet Report Zoom ProviderCRead-onlyIdempotent
Zoom call detail (provider). IPEX API: GET /v1/reports/zoom/provider/{month}.
Inputs: month (required).
get_requestGet RequestCRead-onlyIdempotent
Order detail. IPEX API: GET /v1/requests/{requestId}.
Inputs: requestId (required).
get_rightsGet RightsBRead-onlyIdempotent
List of rights. IPEX API: GET /v1/rights.
Inputs: no named parameters.
get_ruian_addressGet Ruian AddressCRead-onlyIdempotent
Address detail (RUIAN). IPEX API: GET /v1/ruian/address/{ruianId}.
Inputs: ruianId (required).
get_serviceGet ServiceCRead-onlyIdempotent
Get service. IPEX API: GET /v1/services/{serviceId}.
Inputs: serviceId (required).
get_service_propertiesGet Service PropertiesCRead-onlyIdempotent
Get service properties. IPEX API: GET /v1/services/{serviceId}/properties.
Inputs: serviceId (required).
get_sms_integrationGet Sms IntegrationCRead-onlyIdempotent
Get SMS service detail. IPEX API: GET /v1/sms/integration/{serviceId}.
Inputs: serviceId (required).
get_supportGet SupportCRead-onlyIdempotent
Get guaranteed support detail. IPEX API: GET /v1/support/{id}.
Inputs: id (required).
get_tariff_planGet Tariff PlanCRead-onlyIdempotent
Tariff plan detail. IPEX API: GET /v1/tariffPlans/{tariffPlanId}.
Inputs: tariffPlanId (required), type.
get_tariff_plan_priceGet Tariff Plan PriceCRead-onlyIdempotent
Price of a tariff plan. IPEX API: GET /v1/tariffPlans/{tariffPlanId}/price.
Inputs: tariffPlanId (required), number, cdrType.
get_voipGet VoipCRead-onlyIdempotent
Landline number detail. IPEX API: GET /v1/voip/{number}.
Inputs: number (required), iccid, detail.
get_voip_creditGet Voip CreditBRead-onlyIdempotent
Credit history of a landline. IPEX API: GET /v1/voip/{number}/credit.
Inputs: number (required).
get_voip_stateGet Voip StateBRead-onlyIdempotent
Landline number state. IPEX API: GET /v1/voip/{number}/state.
Inputs: number (required), iccid.
healthHealthCRead-onlyIdempotent
Return status on dependent system. IPEX API: GET /health.
Inputs: no named parameters.
list_connector_invoicesList Connector InvoicesBRead-onlyIdempotent
Billing list for one connector. IPEX API: GET /v1/connectors/{connectorId}/invoices.
Inputs: connectorId (required), dateTo, detail, dateFrom, +1 more.
list_connector_invoices_allList Connector Invoices AllCRead-onlyIdempotent
Billing list for all connectors. IPEX API: GET /v1/connectors/invoices.
Inputs: dateTo (required), dateFrom (required), detail.
list_connector_phone_numbersList Connector Phone NumbersBRead-onlyIdempotent
Phone numbers of a connector. IPEX API: GET /v1/connectors/{connectorId}/phoneNumbers.
Inputs: connectorId (required), number, status, category, +5 more.
list_connectorsList ConnectorsCRead-onlyIdempotent
List of all connectors. IPEX API: GET /v1/connectors.
Inputs: type, showPrice, customerId, connectorId.
list_container_data_packsList Container Data PacksCRead-onlyIdempotent
Data packs of a container. IPEX API: GET /v1/containers/{containerId}/dataPacks.
Inputs: containerId (required), type, tariffPlanId.
list_container_flat_packsList Container Flat PacksCRead-onlyIdempotent
Flat packs of a container. IPEX API: GET /v1/containers/{containerId}/flatPacks.
Inputs: containerId (required), tariffPlanId.
list_container_phone_numbersList Container Phone NumbersCRead-onlyIdempotent
Phone numbers of a container. IPEX API: GET /v1/containers/{containerId}/phoneNumbers.
Inputs: containerId (required), detail, number, status, +5 more.
list_container_roaming_profilesList Container Roaming ProfilesCRead-onlyIdempotent
Roaming profiles of a container. IPEX API: GET /v1/containers/{containerId}/roamingProfiles.
Inputs: containerId (required).
list_containersList ContainersBRead-onlyIdempotent
List of containers (ústředny) by type. IPEX API: GET /v1/containers/{type}.
Inputs: type (required).
list_container_simcardsList Container SimcardsCRead-onlyIdempotent
SIM cards of a container. IPEX API: GET /v1/containers/{containerId}/simcards.
Inputs: containerId (required), iccid, limit, status, +1 more.
list_customersList CustomersCRead-onlyIdempotent
Customer listing. IPEX API: GET /v1/customers.
Inputs: id, tin, city, note, +15 more.
list_customer_usersList Customer UsersBRead-onlyIdempotent
All users of a customer. IPEX API: GET /v1/customers/{customerId}/users.
Inputs: customerId (required).
list_ict_price_listsList Ict Price ListsBRead-onlyIdempotent
Get all pricelists. IPEX API: GET /v1/ictPriceList.
Inputs: page, orderBy, orderDir, pageSize.
list_internet_typesList Internet TypesBRead-onlyIdempotent
List internet service types. IPEX API: GET /v1/internet/types.
Inputs: no named parameters.
list_invoice_item_idsList Invoice Item IdsCRead-onlyIdempotent
List of inserted ids (hints). IPEX API: GET /v1/invoiceItem/idList.
Inputs: no named parameters.
list_invoicesList InvoicesCRead-onlyIdempotent
Invoicing base data (list of services). IPEX API: GET /v1/invoices.
Inputs: customerId (required), monthOffset.
list_mobile_portation_datesList Mobile Portation DatesCRead-onlyIdempotent
Possible porting days. IPEX API: GET /v1/mobile/availablePortationDates/{cvop}.
Inputs: cvop (required).
list_pbxList PbxCRead-onlyIdempotent
PBX info. IPEX API: GET /v1/pbx.
Inputs: id, serviceId, customerId.
list_phone_numbersList Phone NumbersCRead-onlyIdempotent
List of phone numbers. IPEX API: GET /v2/phone-numbers.
Inputs: limit, order, number, offset, +5 more.
list_phone_numbers_v1List Phone Numbers V1BRead-onlyIdempotent
Deprecated list of phone numbers. IPEX API: GET /v1/phone-numbers.
Inputs: limit, order, number, offset, +5 more.
list_requestsList RequestsCRead-onlyIdempotent
Order list. IPEX API: GET /v1/requests.
Inputs: login, detail, changedTo, requestId, +8 more.
list_servicesList ServicesCRead-onlyIdempotent
List of services. IPEX API: GET /v1/services.
Inputs: detail, number, result, status, +5 more.
list_tariff_plan_trunk_typesList Tariff Plan Trunk TypesBRead-onlyIdempotent
Price list of trunk types for a tariff. IPEX API: GET /v1/tariffPlans/{tariffPlanId}/trunkTypes.
Inputs: tariffPlanId (required), customer_price_higher.
list_voip_profilesList Voip ProfilesBRead-onlyIdempotent
List of landline profiles. IPEX API: GET /v1/voip/profiles.
Inputs: no named parameters.
list_wholesale_invoicesList Wholesale InvoicesCRead-onlyIdempotent
List of wholesale invoices. IPEX API: GET /v1/wholesale-invoices.
Inputs: page, months, orderBy, orderDir, +1 more.
search_ruianSearch RuianCRead-onlyIdempotent
Addresses found by fulltext (RUIAN). IPEX API: GET /v1/ruian/{fulltext}.
Inputs: fulltext (required), detail.
search_services_fulltextSearch Services FulltextCRead-onlyIdempotent
Service full text search. IPEX API: GET /v1/services/fulltext.
Inputs: type, customerId, fullTextSearch.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Give AI agents secure access to RevDesk calling, SMS, phone numbers, caller IDs, and usage.
Place calls, send WhatsApp, manage contacts, leads and campaigns, and read call records and billing
Global B2B intelligence for AI agents: 35M+ companies, 1.6M sanctions, KYB pack. 78 tools.
Lets AI agents analyze API metrics, request logs, and traces, and manage apps and alerts.
Related MCP Servers
FlicenseBqualityFmaintenanceEnables interaction with Telnyx's telephony, messaging, and AI assistant APIs to manage phone numbers, send messages, make calls, and create AI assistants. Includes webhook support for real-time event handling and comprehensive tools for voice, SMS, cloud storage, and embeddings.4625-- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with the TelecomsXChange wholesale telecom API for voice termination, SMS, DID management, eSIM, and account operations through 55 tools and 7 guided workflows using natural language.3MIT
- AlicenseAqualityBmaintenanceProvides read-only access to Yeastar P-Series PBX System APIs, enabling querying of extensions, groups, trunks, routes, IVR menus, ring groups, queues, live call and agent status, contacts, call detail records, reports, and system metadata for AI assistants.262Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to query and manage a web hosting billing platform through its External API — clients, tickets, invoices, domains, orders, products, and system data. It defaults to read-only with per-domain opt-in for writes, two-step confirmation for billing and destructive actions, and automatic redaction of secrets, card data, and PII.1MIT