Skip to main content
Glama
mcp-server-ipex

mcp-server-ipex

by Spoje-NET

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

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.

Available Tools

75 tools
aliveAliveA
Read-onlyIdempotent

Alive check route. IPEX API: GET /alive.

Inputs: no named parameters.

check_ticketing_userCheck Ticketing UserB
Read-onlyIdempotent

Get requestor user by username. IPEX API: GET /v1/ticketing/check-user.

Inputs: no named parameters.

get_accountGet AccountB
Read-onlyIdempotent

Get provider user. IPEX API: GET /v1/accounts/{username}.

Inputs: username (required).

get_callsGet CallsC
Read-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 OverviewC
Read-onlyIdempotent

VoIP technical overview. IPEX API: GET /v1/calls/technical-overview.

Inputs: dateTo, number, dateFrom.

get_connectorGet ConnectorC
Read-onlyIdempotent

Connector detail. IPEX API: GET /v1/connectors/{connectorId}.

Inputs: connectorId (required).

get_connector_analysisGet Connector AnalysisD
Read-onlyIdempotent

Connector analysis. IPEX API: GET /v1/analysis/connector.

Inputs: periodFrom (required), periodTo.

get_current_userGet Current UserB
Read-onlyIdempotent

Get the authenticated user. IPEX API: GET /v1/users/me.

Inputs: detail.

get_customerGet CustomerC
Read-onlyIdempotent

Customer detail. IPEX API: GET /v1/customers/{id}.

Inputs: id (required).

get_customer_nameGet Customer NameB
Read-onlyIdempotent

Customer name for the given id. IPEX API: GET /v1/customers/customername/{id}.

Inputs: id (required).

get_free_units_historyGet Free Units HistoryC
Read-onlyIdempotent

Free units usage history. IPEX API: GET /v1/freeUnits/history.

Inputs: year (required), month (required), number.

get_helpdeskGet HelpdeskC
Read-onlyIdempotent

Get service helpdesk detail. IPEX API: GET /v1/helpdesk/{id}.

Inputs: id (required).

get_ict_price_listGet Ict Price ListC
Read-onlyIdempotent

Get pricelist detail. IPEX API: GET /v1/ictPriceList/{id}.

Inputs: id (required).

get_ict_price_list_itemGet Ict Price List ItemB
Read-onlyIdempotent

Get pricelist item. IPEX API: GET /v1/ictPriceList/items/{itemId}.

Inputs: itemId (required).

get_internetGet InternetB
Read-onlyIdempotent

Get internet service detail. IPEX API: GET /v1/internet/{id}.

Inputs: id (required).

get_invoice_itemGet Invoice ItemC
Read-onlyIdempotent

Get virtual service detail. IPEX API: GET /v1/invoiceItem/{id}.

Inputs: id (required).

get_invoices_by_payment_typeGet Invoices By Payment TypeC
Read-onlyIdempotent

Invoicing base data by payment type. IPEX API: GET /v1/invoices/{paymentType}.

Inputs: paymentType (required), analysis, monthOffset.

get_invoices_printGet Invoices PrintB
Read-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 MobileC
Read-onlyIdempotent

Mobile number detail. IPEX API: GET /v1/mobile/{number}.

Inputs: number (required), iccid, detail.

get_mobile_creditGet Mobile CreditB
Read-onlyIdempotent

Credit history of a mobile. IPEX API: GET /v1/mobile/{number}/credit.

Inputs: number (required).

get_phone_number_diagnosticGet Phone Number DiagnosticC
Read-onlyIdempotent

Number diagnostic detail. IPEX API: GET /v2/phone-numbers/diagnostic.

Inputs: number (required), full.

get_provider_settingsGet Provider SettingsC
Read-onlyIdempotent

Provider settings. IPEX API: GET /v1/providers/settings.

Inputs: no named parameters.

get_report_connector_phone_numbers_countGet Report Connector Phone Numbers CountB
Read-onlyIdempotent

Phone number count of a connector. IPEX API: GET /v1/reports/connectors/{connectorId}/phoneNumbers/count.

Inputs: connectorId (required).

get_report_ctuGet Report CtuC
Read-onlyIdempotent

ČTÚ statistics. IPEX API: GET /v1/reports/cz/ctu.

Inputs: byType, dateTo, dateFrom, statsType.

get_report_customer_invoices_sumGet Report Customer Invoices SumC
Read-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 CountC
Read-onlyIdempotent

Order count of a customer. IPEX API: GET /v1/reports/customers/{customerId}/requests/count.

Inputs: customerId (required).

get_report_customersGet Report CustomersC
Read-onlyIdempotent

Customer count. IPEX API: GET /v1/reports/customers.

Inputs: no named parameters.

get_report_customer_services_countGet Report Customer Services CountC
Read-onlyIdempotent

Service count of a customer. IPEX API: GET /v1/reports/customers/{customerId}/services/count.

Inputs: customerId (required), type.

get_report_numbersGet Report NumbersC
Read-onlyIdempotent

Service count. IPEX API: GET /v1/reports/numbers.

Inputs: show, status, customerId, numberType, +1 more.

get_report_provider_customers_countGet Report Provider Customers CountC
Read-onlyIdempotent

Customer count (provider). IPEX API: GET /v1/reports/providers/customers/count.

Inputs: no named parameters.

get_report_provider_requests_countGet Report Provider Requests CountC
Read-onlyIdempotent

Order count (provider). IPEX API: GET /v1/reports/providers/requests/count.

Inputs: state.

get_report_top_customersGet Report Top CustomersC
Read-onlyIdempotent

Top customers. IPEX API: GET /v1/reports/providers/top-customers.

Inputs: top, order.

get_report_zoom_customerGet Report Zoom CustomerC
Read-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 ProviderC
Read-onlyIdempotent

Zoom call detail (provider). IPEX API: GET /v1/reports/zoom/provider/{month}.

Inputs: month (required).

get_requestGet RequestC
Read-onlyIdempotent

Order detail. IPEX API: GET /v1/requests/{requestId}.

Inputs: requestId (required).

get_rightsGet RightsB
Read-onlyIdempotent

List of rights. IPEX API: GET /v1/rights.

Inputs: no named parameters.

get_ruian_addressGet Ruian AddressC
Read-onlyIdempotent

Address detail (RUIAN). IPEX API: GET /v1/ruian/address/{ruianId}.

Inputs: ruianId (required).

get_serviceGet ServiceC
Read-onlyIdempotent

Get service. IPEX API: GET /v1/services/{serviceId}.

Inputs: serviceId (required).

get_service_propertiesGet Service PropertiesC
Read-onlyIdempotent

Get service properties. IPEX API: GET /v1/services/{serviceId}/properties.

Inputs: serviceId (required).

get_sms_integrationGet Sms IntegrationC
Read-onlyIdempotent

Get SMS service detail. IPEX API: GET /v1/sms/integration/{serviceId}.

Inputs: serviceId (required).

get_supportGet SupportC
Read-onlyIdempotent

Get guaranteed support detail. IPEX API: GET /v1/support/{id}.

Inputs: id (required).

get_tariff_planGet Tariff PlanC
Read-onlyIdempotent

Tariff plan detail. IPEX API: GET /v1/tariffPlans/{tariffPlanId}.

Inputs: tariffPlanId (required), type.

get_tariff_plan_priceGet Tariff Plan PriceC
Read-onlyIdempotent

Price of a tariff plan. IPEX API: GET /v1/tariffPlans/{tariffPlanId}/price.

Inputs: tariffPlanId (required), number, cdrType.

get_voipGet VoipC
Read-onlyIdempotent

Landline number detail. IPEX API: GET /v1/voip/{number}.

Inputs: number (required), iccid, detail.

get_voip_creditGet Voip CreditB
Read-onlyIdempotent

Credit history of a landline. IPEX API: GET /v1/voip/{number}/credit.

Inputs: number (required).

get_voip_stateGet Voip StateB
Read-onlyIdempotent

Landline number state. IPEX API: GET /v1/voip/{number}/state.

Inputs: number (required), iccid.

healthHealthC
Read-onlyIdempotent

Return status on dependent system. IPEX API: GET /health.

Inputs: no named parameters.

list_connector_invoicesList Connector InvoicesB
Read-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 AllC
Read-onlyIdempotent

Billing list for all connectors. IPEX API: GET /v1/connectors/invoices.

Inputs: dateTo (required), dateFrom (required), detail.

list_connector_phone_numbersList Connector Phone NumbersB
Read-onlyIdempotent

Phone numbers of a connector. IPEX API: GET /v1/connectors/{connectorId}/phoneNumbers.

Inputs: connectorId (required), number, status, category, +5 more.

list_connectorsList ConnectorsC
Read-onlyIdempotent

List of all connectors. IPEX API: GET /v1/connectors.

Inputs: type, showPrice, customerId, connectorId.

list_container_data_packsList Container Data PacksC
Read-onlyIdempotent

Data packs of a container. IPEX API: GET /v1/containers/{containerId}/dataPacks.

Inputs: containerId (required), type, tariffPlanId.

list_container_flat_packsList Container Flat PacksC
Read-onlyIdempotent

Flat packs of a container. IPEX API: GET /v1/containers/{containerId}/flatPacks.

Inputs: containerId (required), tariffPlanId.

list_container_phone_numbersList Container Phone NumbersC
Read-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 ProfilesC
Read-onlyIdempotent

Roaming profiles of a container. IPEX API: GET /v1/containers/{containerId}/roamingProfiles.

Inputs: containerId (required).

list_containersList ContainersB
Read-onlyIdempotent

List of containers (ústředny) by type. IPEX API: GET /v1/containers/{type}.

Inputs: type (required).

list_container_simcardsList Container SimcardsC
Read-onlyIdempotent

SIM cards of a container. IPEX API: GET /v1/containers/{containerId}/simcards.

Inputs: containerId (required), iccid, limit, status, +1 more.

list_customersList CustomersC
Read-onlyIdempotent

Customer listing. IPEX API: GET /v1/customers.

Inputs: id, tin, city, note, +15 more.

list_customer_usersList Customer UsersB
Read-onlyIdempotent

All users of a customer. IPEX API: GET /v1/customers/{customerId}/users.

Inputs: customerId (required).

list_ict_price_listsList Ict Price ListsB
Read-onlyIdempotent

Get all pricelists. IPEX API: GET /v1/ictPriceList.

Inputs: page, orderBy, orderDir, pageSize.

list_internet_typesList Internet TypesB
Read-onlyIdempotent

List internet service types. IPEX API: GET /v1/internet/types.

Inputs: no named parameters.

list_invoice_item_idsList Invoice Item IdsC
Read-onlyIdempotent

List of inserted ids (hints). IPEX API: GET /v1/invoiceItem/idList.

Inputs: no named parameters.

list_invoicesList InvoicesC
Read-onlyIdempotent

Invoicing base data (list of services). IPEX API: GET /v1/invoices.

Inputs: customerId (required), monthOffset.

list_mobile_portation_datesList Mobile Portation DatesC
Read-onlyIdempotent

Possible porting days. IPEX API: GET /v1/mobile/availablePortationDates/{cvop}.

Inputs: cvop (required).

list_pbxList PbxC
Read-onlyIdempotent

PBX info. IPEX API: GET /v1/pbx.

Inputs: id, serviceId, customerId.

list_phone_numbersList Phone NumbersC
Read-onlyIdempotent

List of phone numbers. IPEX API: GET /v2/phone-numbers.

Inputs: limit, order, number, offset, +5 more.

list_phone_numbers_v1List Phone Numbers V1B
Read-onlyIdempotent

Deprecated list of phone numbers. IPEX API: GET /v1/phone-numbers.

Inputs: limit, order, number, offset, +5 more.

list_requestsList RequestsC
Read-onlyIdempotent

Order list. IPEX API: GET /v1/requests.

Inputs: login, detail, changedTo, requestId, +8 more.

list_servicesList ServicesC
Read-onlyIdempotent

List of services. IPEX API: GET /v1/services.

Inputs: detail, number, result, status, +5 more.

list_shared_servicesList Shared ServicesC
Read-onlyIdempotent

List of shared services. IPEX API: GET /v1/services/shared.

Inputs: customerId.

list_tariff_plan_trunk_typesList Tariff Plan Trunk TypesB
Read-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 ProfilesB
Read-onlyIdempotent

List of landline profiles. IPEX API: GET /v1/voip/profiles.

Inputs: no named parameters.

list_wholesale_invoicesList Wholesale InvoicesC
Read-onlyIdempotent

List of wholesale invoices. IPEX API: GET /v1/wholesale-invoices.

Inputs: page, months, orderBy, orderDir, +1 more.

search_ruianSearch RuianC
Read-onlyIdempotent

Addresses found by fulltext (RUIAN). IPEX API: GET /v1/ruian/{fulltext}.

Inputs: fulltext (required), detail.

search_services_fulltextSearch Services FulltextC
Read-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

    C2.5/5.0

    Scored across 75 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness2/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      F
      maintenance
      Enables 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.
      46
      25
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      3
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides 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.
      26
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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.
      1
      MIT