MCP server (/mcp/v1)
Overview
The platform web server is a Model Context Protocol (MCP) server: agents and assistants (Claude Code, IDEs, desktop clients) connect to it to work with the platform through tools.
Tools execute platform API requests on behalf of the integration channel user, with their roles and restrictions.
Only REST API (/rest/…, secret fields are masked) and /api commands needed by tools are available (GET,
read-only: routing, representation, and normalization tests, trace, registrar, states, hunt, script,
conf, esg/active, b2bua/regerror, b2bua/activecalls, lic/read, system/{state,node,nodes,roles,sites,domains,version}); other paths and integration channels
(/rest/v1/service/integration_points) — 403.
All tools only read data.
Channel preparation, client connection, and examples of questions to the agent — article Working with the platform via an AI agent (MCP).
Connection
Connection endpoint: http(s)://<server>/mcp/v1, Streamable HTTP transport.
Example for Claude Code:
claude mcp add --transport http era http://<server>/mcp/v1 --header "Authorization: Bearer <token>"
Where <token> is the token_local value of the integration channel of type mcp.
Authentication
-
Every request — with the
Authorization: Bearer <token>header, the token of an integration channel of typemcp. Tokens of channels of other types, session identifiers, and cookies are not accepted. -
Channel settings apply: validity period, address restriction (
remoteipmask), client certificate. -
Without a token or with an invalid token — response
401with theWWW-Authenticate: Bearerheader. An invalid token counts as a failed login attempt: after a series of failures the address is blocked, as with password guessing; a blocked address receives403, and the block is extended. -
A request with the
Originheader (from a browser) is accepted only ifOriginmatches the server address (scheme, name, port), otherwise403.
Protocol
-
Protocol versions:
2025-11-25,2025-06-18,2025-03-26(negotiated duringinitialize). -
The server does not create sessions (
Mcp-Session-Idis not issued): every request is processed independently, on any web server. -
Requests —
POSTwith a single JSON-RPC message (for version2025-03-26— also a batch of up to 100 messages); responses —application/json.GETandDELETE—405: there are no server notifications or session termination. -
Methods:
initialize,ping,tools/list,tools/call,resources/list,resources/templates/list,resources/read,prompts/list,prompts/get.
Tools
| Tool | Purpose | API request |
|---|---|---|
|
Sections and classes of the dynamic model at tree level |
|
|
Class description: storage mode, properties and types, |
|
|
Reading a class collection: |
|
|
Class entity by id ( |
|
|
Stat service indicator dictionary (as the |
|
|
Objects of the domain configuration collection (accounts, rules, routes, providers, scripts, settings, roles…): |
|
|
Configuration collection object by id, |
|
|
Routing test without a call |
|
|
Representation test (which number and name the callee sees) without a call, domains — the channel domain |
|
|
Test of domain provider number normalization (worker domain only); provider login and address hidden |
|
|
Call legs of the last ~20 minutes (without addresses and media) |
|
|
Call closure by callid (master domain only) |
|
|
SIP call diagram as plantuml text (up to 3 minutes) |
|
|
Call activity diagram as plantuml text (up to 3 minutes) |
|
|
Domain account registrations (without addresses): active, count by domains, unregistered, with missing forks |
|
|
Domain provider registrations on esg servers: registration state and ping, online trunks (worker domain only; without provider login and address) |
|
|
Recent account registration errors: time, account, user agent, reason, Call-ID (without addresses) |
|
|
Current calls on b2bua servers: state, time, leg Call-ID |
|
|
Hunt group state: resources, queue, summary |
|
|
States (presence) of accounts, numbers, users, and voicemail boxes |
|
|
Running scripts (svc, ivr) |
|
|
Domain license: limits; for the master domain — products, features, terms |
|
|
Active domain conferences and their participants |
|
|
System deviation report (master domain only): for each key — a hint and a section of the article System state warnings; |
|
|
Sites, nodes by servers, microservices by nodes, domains by sites, version (master domain only) |
|
|
State of one node: availability, microservices, CPU, memory, disk, interfaces, queues, hashes (master domain only) |
|
|
Help search (all words, word forms, phrase in quotes) |
— |
|
Help page as text by |
— |
-
The tool list (
tools/list) contains only those available to the channel: by domain type and roles (IAM) — the same as applied by the tool API (token roles — channel user roles andopts.rolesbyopts.roles_mode;/apiand the model tree — only for a channel with a user); theconfig_*collection list is narrowed the same way. On call, rights are checked by the API as usual. -
Collections with scripts, attachments, and free content (
uc/ivrscripts,service/svcscripts,service/svctasks,domain/mservices,domain/roleapps,uc/cpd/templates) are unavailable toconfig_*tools: code and parameters may contain credentials not covered by masking. -
Arguments are validated against the tool schema; only validated segments from arguments enter the request path (class name, id, collection from the list). An argument error and an API error (code, message, explanation) are returned to the agent as a result with
isError. -
Secret fields —
*****(masking for mcp channels); filtering and sorting by them — error422. -
Large responses are truncated: the result contains
truncated: trueand a hint (nextoffset— for tools withoffset,mask,filter,aggr); an object larger than the allowed size — an error suggesting to selectmaskfields. -
Call closure and diagrams are executed one at a time per channel and callid: a repeat while collection is not complete receives the response "already in progress".
-
Help tools are available if help is installed on the web server.
User data (iam/users, address book, etc.) and infrastructure data (server addresses, node names, paths — system_* tools)
are provided to the agent as is and passed to the model provider
used by the agent. Limit the channel user roles to the necessary sections.
|
Prompts
-
system_check— system state analysis: collect the report, group warnings by importance, explain what is happening, clarify by nodes and license, suggest actions. Available to a master domain channel with thesystem_statetool; in Claude Code — the/mcperasystem_checkcommand.
Resources
-
era://docs/index— list of help pages;era://docs/{+path}— help page. -
era://dict/stat— stat service indicator dictionary (code, name, kind, filter, filter and argument labels, value editor, archive levels) and rules for selecting value collections and counters; rights — as formodel_querytostat/Indicators.
Limitations
-
Request body size — no more than 1 MB (
413), body transfer — no longer than 15 seconds (408). -
Content-Type: application/json(otherwise415); theAcceptheader, if passed, must allowapplication/json(otherwise406). -
Rate: no more than 120 tool calls and resource reads per minute and 4 simultaneous per channel (on each web server; calls in a batch are counted separately); exceeding — the
rate limitedresponse with a retry time. Values are changed by the node parameterws_mcp_limits(#{rate ⇒ N, parallel ⇒ M}). -
Call timeouts: 30 seconds; call closure and system state — 60 seconds; diagrams — 190 seconds.
-
The web server log — one line per request: client address, method, tool, domain, channel, result, API response codes, duration, size. Call arguments are not recorded.