Skip to main content
Glama
placetel-web-api-mcp-server

placetel-web-api-mcp-server

placetel-web-api-mcp-server

npm version CI License: MIT Node.js

MCP (Model Context Protocol) server exposing the complete Placetel Web API v2 — all 124 endpoints as individual, well-annotated tools. Built with the MCP TypeScript SDK (registerTool), Zod validation, and a shared axios client with automatic rate-limit (HTTP 429 / Retry-After) handling.

  • Base URL: https://api.placetel.de/v2

  • Auth: Bearer token via PLACETEL_API_KEY

  • Transport: stdio (local server for Claude Desktop / Claude Code)

Tool catalog (124 tools)

Tools are named placetel_<verb>_<resource> (snake_case). Read-only tools carry readOnlyHint, deletes carry destructiveHint. Full table with methods, paths and annotations: docs/BUILD-PLAN.md.

Domain

Tools

Domain

Tools

AI

1

Prompts

5

Call Center

8

Provisionings

9

Call detail records

1

Recordings

3

Calls

4

Routing plans (+objects)

7

Contacts

5

Routings

5

CTI

15

Sip Users

8

Devices

1

SIM Cards

2

Faxes

4

Sites

2

Groups

5

SMS

1

Microsoft Teams

5

Subscriptions

3

Numbers

8

Webex

14

Users (incl. /me)

8

Total

124

Every data tool accepts response_format (markdown default, or json). List tools accept page / per_page (note: not every endpoint honors per_page; Placetel list endpoints return bare arrays, so has_more is a heuristic).

Related MCP server: planfix-mcp

Setup

npm install
cp .env.example .env        # then put your Placetel API key into .env
npm run build

.env:

PLACETEL_API_KEY=your_api_key_here

Get your key at https://web.placetel.de/integrations/web_api. Never commit .env — it is gitignored.

Run

npm start          # runs dist/index.js over stdio
npm run smoke      # starts the server, lists tools, prints TOOL_COUNT

Register in an MCP client (e.g. Claude Desktop / Claude Code)

Using the published npm package (no local checkout needed):

{
  "mcpServers": {
    "placetel": {
      "command": "npx",
      "args": ["-y", "placetel-web-api-mcp-server"],
      "env": { "PLACETEL_API_KEY": "your_api_key_here" }
    }
  }
}

The env value may reference an existing OS environment variable, e.g. "PLACETEL_API_KEY": "${MY_PLACETEL_KEY}".

Alternatively point at a local build with "command": "node" and "args": ["<absolute-path>/dist/index.js"].

Development

npm run dev        # tsx watch on src/index.ts
npm run build      # tsc -> dist/
npm test           # build, then the offline test suite (no API key, no network)

Tests

npm test calls every tool through a real MCP client (in-memory transport) and checks the HTTP request it would send against a contract generated from the public Placetel spec (test/fixtures/placetel-contract.json): method, path, query and body fields, required fields, annotations, and both response formats. Requests are intercepted on the axios level, so nothing leaves the machine. The run ends with TOOL_COVERAGE=<passed>/<registered> and SPEC_UNCOVERED=<operations without a tool>.

To refresh the contract after an API change, run node scripts/build-contract.mjs (fetches https://api.placetel.de/v2/swagger_doc.json; not part of npm test or CI).

  • src/index.ts — entry point, registers all tool modules, connects stdio.

  • src/services/ — shared client, error mapping, pagination, formatting.

  • src/tools/ — one module per API domain (contacts.ts is the hand-written reference; the rest are generated to the same pattern from the Swagger spec).

  • evaluation.xml — 10 read-only QA pairs (mcp-builder Phase 4).

Notes & limits

  • CTI, Webex, Microsoft Teams and SIM-card tools require the corresponding Placetel add-on products / real devices; they are implemented and type-checked but may not be exercisable on every account.

  • Error messages are actionable (401 → check key, 404 → check id, 422 → validation detail, 429 → rate limited).

Releasing

Publishing to npm is automated via GitHub Actions (.github/workflows/publish.yml) and runs when a GitHub Release is published:

  1. Bump the version and update CHANGELOG.md: npm version patch|minor|major

  2. Push the tag: git push --follow-tags

  3. Publish a GitHub Release for that tag: gh release create vX.Y.Z --generate-notes

The workflow then builds and runs npm publish --provenance. It requires the repository secret NPM_TOKEN — an npm Automation token (Access Tokens → Classic → Automation), which bypasses 2FA. A plain repo push does not republish npm; only a new release with a bumped version does.

Available Tools

124 tools
placetel_activate_numberActivate a numberC

Activate a number. (POST /numbers/{id}/activation)

Inputs: id (required), response_format.

placetel_activate_number_profileActivates a profile for a numberC
Idempotent

Activates a profile for a number. (PUT /numbers/{number_id}/profiles)

Inputs: id (required), number_id (required), response_format.

placetel_add_subscriptionAdd a subscriptionC
Idempotent

Add a subscription. (PUT /subscriptions)

Inputs: url (required), service (required), phone, hungup, +5 more.

placetel_assign_webex_user_licenseAssign Webex license to userC

Assign Webex license to user. (POST /webex/users/{id}/license)

Inputs: id (required), package (required), extension, location_id, +2 more.

placetel_configure_webex_number_fax_settingsConfigure a number as a fax numberC
Idempotent

Configure a number as a fax number. (PUT /webex/numbers/{number_or_id}/fax_settings)

Inputs: faxpin (required), faxheader (required), number_or_id (required), email, +5 more.

placetel_create_call_center_agentCreate an agentC

Create an agent. (POST /call_center_agents)

Inputs: name (required), extension_sip (required), extension_pstn (required), extension_type (required), +4 more.

placetel_create_call_center_queueCreate a queueC

Create a queue. (POST /call_center_queues)

Inputs: name (required), priority, num_loops, prompt_id, +12 more.

placetel_create_contactCreate contactC

Create a new contact. Provide any subset of contact fields (all optional). Returns the created contact object.

Inputs: fax, tags, color, email, +18 more.

placetel_create_faxCreate outbound faxC

Create outbound fax. (POST /faxes)

Inputs: file (required), email (required), to_number (required), from_number (required), +2 more.

placetel_create_groupCreate a groupC

Create a group. (POST /groups)

Inputs: name (required), type (required), member_ids, description, +1 more.

placetel_create_number_profileCreates a new profile for a numberC

Creates a new profile for a number. (POST /numbers/{number_id}/profiles)

Inputs: name (required), number_id (required), response_format.

placetel_create_promptCreate a promptC

Create a prompt. (POST /prompts)

Inputs: name (required), voice (required), file, text, +2 more.

placetel_create_provisioningCreates a phone provisioningsC

Creates a phone provisionings. (POST /provisionings)

Inputs: mac (required), name (required), phone_model (required), keys, +7 more.

placetel_create_routingCreate a routing objectC

Create a routing object. (POST /routings)

Inputs: name (required), api, ivr, group, +9 more.

placetel_create_routing_planCreate a routing planC

Create a routing plan. (POST /routing_plans)

Inputs: did, name, description, response_format, +1 more.

placetel_create_sip_userCreate a sip userC

Create a sip user. (POST /sip_users)

Inputs: name (required), type (required), did, callerid, +12 more.

placetel_create_sip_user_short_codeCreate short codeC

Create short code. (POST /sip_users/{id}/short_codes)

Inputs: id (required), code (required), action (required), number, +3 more.

placetel_create_userCreate new subuserC

Create new subuser. (POST /users)

Inputs: last_name (required), first_name (required), did, email, +6 more.

placetel_create_webex_userCreate a Webex userC

Create a Webex user. (POST /webex/users)

Inputs: email (required), last_name (required), first_name (required), package, +4 more.

placetel_create_webex_workspaceCreate a Webex workspaceC

Create a Webex workspace. (POST /webex/workspaces)

Inputs: calling (required), location_id (required), display_name (required), supported_devices (required), +3 more.

placetel_cti_answerAnswerC

Answer. (POST /cti/{mac}/answer)

Inputs: mac (required), line (required), call_id (required), response_format.

placetel_cti_blind_transferBlind transferC

Blind transfer. (POST /cti/{mac}/blind_transfer)

Inputs: mac (required), line (required), number (required), call_id (required), +1 more.

placetel_cti_complete_conferenceComplete conferenceC

Complete conference. (POST /cti/{mac}/complete_conference)

Inputs: mac (required), line (required), call_id (required), response_format.

placetel_cti_complete_transferComplete transferC

Complete transfer. (POST /cti/{mac}/complete_transfer)

Inputs: mac (required), line (required), call_id (required), response_format.

placetel_cti_declineDeclineC

Decline. (POST /cti/{mac}/decline)

Inputs: mac (required), line (required), call_id (required), response_format.

placetel_cti_dialDialC

Dial. (POST /cti/{mac}/dial)

Inputs: mac (required), line (required), number (required), response_format.

placetel_cti_dial_digitDial digitC

Dial digit. (POST /cti/{mac}/dial_digit)

Inputs: mac (required), line (required), digit (required), call_id (required), +1 more.

placetel_cti_hangupHangupC

Hangup. (POST /cti/{mac}/hangup)

Inputs: mac (required), line (required), call_id (required), response_format.

placetel_cti_holdHoldC

Hold. (POST /cti/{mac}/hold)

Inputs: mac (required), line (required), call_id (required), response_format.

placetel_cti_resumeResumeC

Resume. (POST /cti/{mac}/resume)

Inputs: mac (required), line (required), call_id (required), response_format.

placetel_cti_send_dtmf_digitsSend DTMF DigitsC

Send DTMF Digits. (POST /cti/{mac}/send_dtmf_digits)

Inputs: mac (required), digits (required), response_format.

placetel_cti_start_conferenceStart conferenceC

Start conference. (POST /cti/{mac}/start_conference)

Inputs: mac (required), line (required), call_id (required), response_format.

placetel_cti_start_transferStart transferC

Start transfer. (POST /cti/{mac}/start_transfer)

Inputs: mac (required), line (required), call_id (required), response_format.

placetel_deactivate_numberDeactivate a numberC
DestructiveIdempotent

Deactivate a number. (DELETE /numbers/{id}/activation) Destructive.

Inputs: id (required), response_format.

placetel_delete_callDelete a callC
DestructiveIdempotent

Delete a call. (DELETE /calls/{id}) Destructive.

Inputs: id (required), response_format.

placetel_delete_contactDelete contactA
DestructiveIdempotent

Delete a contact by id. Destructive and irreversible.

Inputs: id (required).

placetel_delete_faxDelete a faxC
DestructiveIdempotent

Delete a fax. (DELETE /faxes/{id}) Destructive.

Inputs: id (required), response_format.

placetel_delete_groupDelete a groupC
DestructiveIdempotent

Delete a group. (DELETE /groups/{id}) Destructive.

Inputs: id (required), response_format.

placetel_delete_number_profileDelete a profile for a numberC
DestructiveIdempotent

Delete a profile for a number. (DELETE /numbers/{number_id}/profiles/{id}) Destructive.

Inputs: id (required), number_id (required), response_format.

placetel_delete_promptDelete a promptB
DestructiveIdempotent

Delete a prompt. (DELETE /prompts/{id}) Destructive.

Inputs: id (required), response_format.

placetel_delete_provisioningDelete a phone provisioningsC
DestructiveIdempotent

Delete a phone provisionings. (DELETE /provisionings/{id}) Destructive.

Inputs: id (required), response_format.

placetel_delete_provisioning_custom_configurationDelete a phone provisionings custom configuration keyB
DestructiveIdempotent

Delete a phone provisionings custom configuration key. (DELETE /provisionings/{id}/custom_configurations/{custom_configuration_id}) Destructive.

Inputs: id (required), custom_configuration_id (required), response_format.

placetel_delete_recordingDelete a recordingC
DestructiveIdempotent

Delete a recording. (DELETE /recordings/{id}) Destructive.

Inputs: id (required), response_format.

placetel_delete_routingDelete a routing objectB
DestructiveIdempotent

Delete a routing object. (DELETE /routings/{number_or_id}) Destructive.

Inputs: number_or_id (required), response_format.

placetel_delete_routing_planDelete a routing planC
DestructiveIdempotent

Delete a routing plan. (DELETE /routing_plans/{id}) Destructive.

Inputs: id (required), response_format.

placetel_delete_sip_userDelete a sip userB
DestructiveIdempotent

Delete a sip user. (DELETE /sip_users/{id}) Destructive.

Inputs: id (required), response_format.

placetel_delete_sip_user_short_codeDelete short codeC
DestructiveIdempotent

Delete short code. (DELETE /sip_users/{id}/short_codes/{code_id}) Destructive.

Inputs: id (required), code_id (required), response_format.

placetel_delete_subscriptionDelete a subscriptionC
DestructiveIdempotent

Delete a subscription. (DELETE /subscriptions/{id}) Destructive.

Inputs: id (required), response_format.

placetel_delete_userDelete a subuserB
DestructiveIdempotent

Delete a subuser. (DELETE /users/{id}) Destructive.

Inputs: id (required), response_format.

placetel_delete_webex_userDelete a Webex userB
DestructiveIdempotent

Delete a Webex user. (DELETE /webex/users/{id}) Destructive.

Inputs: id (required), response_format.

placetel_disconnect_microsoft_teams_userDisconnect userC
DestructiveIdempotent

Disconnect user. (DELETE /microsoft_teams/users/{sip_user_id}) Destructive.

Inputs: sip_user_id (required), response_format.

placetel_get_ai_statusAI integration statusC
Read-onlyIdempotent

AI integration status. (GET /ai/status) Read-only.

Inputs: response_format.

placetel_get_callRetrieve a callC
Read-onlyIdempotent

Retrieve a call. (GET /calls/{id}) Read-only.

Inputs: id (required), response_format.

placetel_get_contactGet contactB
Read-onlyIdempotent

Retrieve a single contact by its numeric id. Read-only.

Inputs: id (required), response_format.

placetel_get_cti_configGet config paramsC
Read-onlyIdempotent

Get config params. (GET /cti/{mac}) Read-only.

Inputs: mac (required), params, response_format.

placetel_get_faxFetch specific faxB
Read-onlyIdempotent

Fetch specific fax. (GET /faxes/{id}) Read-only.

Inputs: id (required), response_format.

placetel_get_groupFetch a groupB
Read-onlyIdempotent

Fetch a group. (GET /groups/{id}) Read-only.

Inputs: id (required), response_format.

placetel_get_meMeC
Read-onlyIdempotent

Me. (GET /me) Read-only.

Inputs: response_format.

placetel_get_microsoft_teams_integrationIntegrationC
Read-onlyIdempotent

Integration. (GET /microsoft_teams/integration) Read-only.

Inputs: response_format.

placetel_get_numberRetrieve a numberC
Read-onlyIdempotent

Retrieve a number. (GET /numbers/{id}) Read-only.

Inputs: id (required), response_format.

placetel_get_promptRetrieve a promptC
Read-onlyIdempotent

Retrieve a prompt. (GET /prompts/{id}) Read-only.

Inputs: id (required), response_format.

placetel_get_provisioningRetrieve a phone provisioningsB
Read-onlyIdempotent

Retrieve a phone provisionings. (GET /provisionings/{id}) Read-only.

Inputs: id (required), response_format.

placetel_get_provisioning_custom_configurationsRetrieve a phone provisionings custom configurationsC
Read-onlyIdempotent

Retrieve a phone provisionings custom configurations. (GET /provisionings/{id}/custom_configurations) Read-only.

Inputs: id (required), response_format.

placetel_get_recordingFetch specific recordingC
Read-onlyIdempotent

Fetch specific recording. (GET /recordings/{id}) Read-only.

Inputs: id (required), response_format.

placetel_get_routingRetrieve routingC
Read-onlyIdempotent

Retrieve routing. (GET /routings/{number_or_id}) Read-only.

Inputs: number_or_id (required), response_format.

placetel_get_routing_planGet a routing planC
Read-onlyIdempotent

Get a routing plan. (GET /routing_plans/{id}) Read-only.

Inputs: id (required), response_format.

placetel_get_sim_cardRetrieve a SIM cardC
Read-onlyIdempotent

Retrieve a SIM card. (GET /sim_cards/{id}) Read-only.

Inputs: id (required), response_format.

placetel_get_sip_userFetch a sip userC
Read-onlyIdempotent

Fetch a sip user. (GET /sip_users/{id}) Read-only.

Inputs: id (required), response_format.

placetel_get_siteRetrieve a siteC
Read-onlyIdempotent

Retrieve a site. (GET /sites/{id}) Read-only.

Inputs: id (required), response_format.

placetel_get_userFetch user by IDC
Read-onlyIdempotent

Fetch user by ID. (GET /users/{id}) Read-only.

Inputs: id (required), response_format.

placetel_get_webex_number_fax_settingsFetch fax settings for a numberC
Read-onlyIdempotent

Fetch fax settings for a number. (GET /webex/numbers/{number_or_id}/fax_settings) Read-only.

Inputs: number_or_id (required), response_format.

placetel_get_webex_user_licenseFetch Webex license for userC
Read-onlyIdempotent

Fetch Webex license for user. (GET /webex/users/{id}/license) Read-only.

Inputs: id (required), response_format.

placetel_get_webex_user_numbersFetch numbers for userB
Read-onlyIdempotent

Fetch numbers for user. (GET /webex/users/{id}/numbers) Read-only.

Inputs: id (required), page, per_page, response_format.

placetel_get_webex_workspaceFetch a single Webex workspaceC
Read-onlyIdempotent

Fetch a single Webex workspace. (GET /webex/workspaces/{id}) Read-only.

Inputs: id (required), response_format.

placetel_import_microsoft_teams_userImport userC

Import user. (POST /microsoft_teams/users)

Inputs: ms_uuid (required), sip_user_id (required), response_format.

placetel_initiate_callInitiate a callC

Initiate a call. (POST /calls)

Inputs: sipuid (required), target (required), from_name, response_format.

placetel_list_call_center_agentsFetch all call center agentsB
Read-onlyIdempotent

Fetch all call center agents. (GET /call_center_agents) Read-only.

Inputs: page, per_page, response_format.

placetel_list_call_center_callsFetch all call center callsC
Read-onlyIdempotent

Fetch all call center calls. (GET /call_center_calls) Read-only.

Inputs: date, page, per_page, queue_ids, +1 more.

placetel_list_call_center_queuesFetch all call center queuesA
Read-onlyIdempotent

Fetch all call center queues. (GET /call_center_queues) Read-only.

Inputs: page, per_page, response_format.

placetel_list_call_detail_recordsGet call detail recordsC
Read-onlyIdempotent

Get call detail records. (GET /call_detail_records) Read-only.

Inputs: date, page, per_page, response_format.

placetel_list_callsFetch all incoming callsC
Read-onlyIdempotent

Fetch all incoming calls. (GET /calls) Read-only.

Inputs: page, order, per_page, filter_date, +4 more.

placetel_list_contactsList contactsA
Read-onlyIdempotent

Fetch all contacts of the Placetel account. Supports field filters, number search and pagination. Read-only.

Returns a list of contact objects (id, first_name, last_name, company, phone/mobile numbers, email, tags, ...).

Inputs: page, per_page, filter_email, search_number, +5 more.

placetel_list_devicesFetch all devicesC
Read-onlyIdempotent

Fetch all devices. (GET /devices) Read-only.

Inputs: page, per_page, response_format.

placetel_list_faxesFetch in- and outbound faxesB
Read-onlyIdempotent

Fetch in- and outbound faxes. (GET /faxes) Read-only.

Inputs: page, order, per_page, filter_type, +3 more.

placetel_list_groupsFetch all groupsC
Read-onlyIdempotent

Fetch all groups. (GET /groups) Read-only.

Inputs: page, per_page, filter_name, filter_type, +2 more.

placetel_list_microsoft_teams_usersFetch all usersC
Read-onlyIdempotent

Fetch all users. (GET /microsoft_teams/users) Read-only.

Inputs: page, per_page, response_format, filter_sync_status.

placetel_list_number_profilesList profiles for a numberC
Read-onlyIdempotent

List profiles for a number. (GET /numbers/{number_id}/profiles) Read-only.

Inputs: number_id (required), response_format.

placetel_list_numbersGet all numbersC
Read-onlyIdempotent

Get all numbers. (GET /numbers) Read-only.

Inputs: page, per_page, filter_name, filter_number, +5 more.

placetel_list_promptsFetch all promptsC
Read-onlyIdempotent

Fetch all prompts. (GET /prompts) Read-only.

Inputs: page, per_page, filter_name, response_format, +1 more.

placetel_list_provisioningsGet all phone provisioningsC
Read-onlyIdempotent

Get all phone provisionings. (GET /provisionings) Read-only.

Inputs: page, search, per_page, webuser_id, +1 more.

placetel_list_recordingsFetch call recordingsC
Read-onlyIdempotent

Fetch call recordings. (GET /recordings) Read-only.

Inputs: page, order, per_page, filter_to, +4 more.

placetel_list_routing_plan_routingsGet a routing plans objectsC
Read-onlyIdempotent

Get a routing plans objects. (GET /routing_plans/{id}/routings) Read-only.

Inputs: id (required), response_format.

placetel_list_routing_plansGet all routing plansA
Read-onlyIdempotent

Get all routing plans. (GET /routing_plans) Read-only.

Inputs: page, per_page, response_format.

placetel_list_routingsGet all routingsC
Read-onlyIdempotent

Get all routings. (GET /routings) Read-only.

Inputs: page, per_page, response_format, filter_updated_at_gte, +1 more.

placetel_list_sim_cardsFetch all SIM cardsB
Read-onlyIdempotent

Fetch all SIM cards. (GET /sim_cards) Read-only.

Inputs: page, per_page, filter_status, response_format.

placetel_list_sip_usersFetch all sip usersB
Read-onlyIdempotent

Fetch all sip users. (GET /sip_users) Read-only.

Inputs: page, per_page, filter_did, filter_name, +3 more.

placetel_list_sip_user_short_codesShort codesC
Read-onlyIdempotent

Short codes. (GET /sip_users/{id}/short_codes) Read-only.

Inputs: id (required), response_format.

placetel_list_sitesGet all sitesC
Read-onlyIdempotent

Get all sites. (GET /sites) Read-only.

Inputs: page, per_page, response_format.

placetel_list_subscriptionsList subscriptionsC
Read-onlyIdempotent

List subscriptions. (GET /subscriptions) Read-only.

Inputs: response_format.

placetel_list_usersFetch all usersC
Read-onlyIdempotent

Fetch all users. (GET /users) Read-only.

Inputs: page, per_page, filter_type, filter_email, +4 more.

placetel_list_webex_usersFetch all Webex usersC
Read-onlyIdempotent

Fetch all Webex users. (GET /webex/users) Read-only.

Inputs: page, per_page, filter_login, response_format, +2 more.

placetel_list_webex_workspacesList all Webex workspacesB
Read-onlyIdempotent

List all Webex workspaces. (GET /webex/workspaces) Read-only.

Inputs: display_name, response_format.

placetel_pick_call_center_callPick a call center callC

Pick a call center call. (POST /call_center_calls/{id}/{pick})

Inputs: id (required), pick (required), sipuid (required), response_format.

placetel_reconfigure_provisioningTrigger reconfiguration of a phoneC

Trigger reconfiguration of a phone. (POST /provisionings/{id}/reconfigure)

Inputs: id (required), response_format.

placetel_remove_webex_number_fax_settingsRemove the fax configuration from a numberA
DestructiveIdempotent

Remove the fax configuration from a number. (DELETE /webex/numbers/{number_or_id}/fax_settings) Destructive.

Inputs: number_or_id (required), response_format.

placetel_reset_user_passwordReset password for accountC

Reset password for account. (POST /users/{id}/password_reset)

Inputs: id (required), response_format.

placetel_reset_user_two_factor_authenticationReset two factor authentication for userC
DestructiveIdempotent

Reset two factor authentication for user. (DELETE /users/{id}/two_factor_authentication) Destructive.

Inputs: id (required), response_format.

placetel_send_smsSend SMSC

Send SMS. (POST /sms)

Inputs: message (required), recipient (required), response_format.

placetel_set_cti_configSet config paramsC
Idempotent

Set config params. (PUT /cti/{mac})

Inputs: mac (required), params (required), response_format.

placetel_simulate_routing_planSimulate the usage of a routing planC
Read-onlyIdempotent

Simulate the usage of a routing plan. (GET /routing_plans/{id}/simulate) Read-only.

Inputs: id (required), time, response_format.

placetel_sync_microsoft_teams_userSync userC

Sync user. (PATCH /microsoft_teams/sync/{sip_user_id})

Inputs: sip_user_id (required), response_format.

placetel_update_call_center_agentUpdate an agentC
Idempotent

Update an agent. (PUT /call_center_agents/{id})

Inputs: id (required), extension_sip (required), extension_pstn (required), name, +5 more.

placetel_update_call_center_queueUpdate a queueC
Idempotent

Update a queue. (PUT /call_center_queues/{id})

Inputs: id (required), name, priority, num_loops, +13 more.

placetel_update_contactUpdate contactB
Idempotent

Update an existing contact by id. Provide the fields to change. Returns the updated contact.

Inputs: id (required), fax, tags, color, +19 more.

placetel_update_groupUpdate a groupC
Idempotent

Update a group. (PUT /groups/{id})

Inputs: id (required), name, member_ids, description, +1 more.

placetel_update_promptUpdate a promptB
Idempotent

Update a prompt. (PUT /prompts/{id})

Inputs: id (required), name (required), voice (required), file, +3 more.

placetel_update_provisioningUpdate a phone provisioningsC
Idempotent

Update a phone provisionings. (PUT /provisionings/{id})

Inputs: id (required), keys, name, codec, +6 more.

placetel_update_routingUpdate routingD
Idempotent

Update routing. (PUT /routings/{number_or_id})

Inputs: number_or_id (required), api, ivr, name, +11 more.

placetel_update_routing_planUpdate a routing planC
Idempotent

Update a routing plan. (PUT /routing_plans/{id})

Inputs: id (required), name (required), did, description, +2 more.

placetel_update_sip_userUpdate a sip userC
Idempotent

Update a sip user. (PUT /sip_users/{id})

Inputs: id (required), did, name, callerid, +13 more.

placetel_update_userUpdate a subuserC
Idempotent

Update a subuser. (PUT /users/{id})

Inputs: id (required), did, email, avatar, +11 more.

placetel_update_webex_user_licenseUpdate Webex license for userC

Update Webex license for user. (PATCH /webex/users/{id}/license)

Inputs: id (required), package (required), response_format.

placetel_update_webex_user_numbersUpdate numbers for userC

Update numbers for user. (PATCH /webex/users/{id}/numbers)

Inputs: id (required), numbers, response_format.

placetel_upsert_provisioning_custom_configurationUpdate or create a phone provisionings custom configuration keyC
Idempotent

Update or create a phone provisionings custom configuration key. (PUT /provisionings/{id}/custom_configurations)

Inputs: id (required), configurations (required), response_format.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 124 tools

    Disambiguation4/5

    Most tools map to a clearly distinct resource and action, with names and endpoint hints that help separate similar areas like calls, call detail records, and call-center calls. A few CTI and routing tools (e.g. cti_dial_digit vs. cti_send_dtmf_digits, routing vs. routing_plan) could still be confused, so the set is mostly but not perfectly distinct.

    Naming Consistency5/5

    Every tool uses the placetel_ prefix with snake_case verb_noun/resource naming, and CRUD operations are highly predictable. Minor variants such as add_subscription, upsert_provisioning_custom_configuration, and get_me are domain-specific but do not break the overall convention.

    Tool Count1/5

    124 tools is far beyond the practical 3-15 range for an MCP toolset and creates very high context and selection overhead. Although the tools mirror many real API endpoints, the surface is too large to be well-scoped as an agent-facing tool set.

    Completeness4/5

    The surface covers a broad range of Placetel resources: calls, contacts, numbers, SIP users, routing, provisionings, faxes, recordings, users, Webex, and Microsoft Teams. Some resources lack full lifecycle operations (e.g. sites/devices/SIM cards are mostly list/get only, and call-center agents/queues lack delete/get), but core workflows are well covered.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      C
      maintenance
      MCP server for Voximplant API enabling calls, SMS, recordings, scenarios, and rules management with 11 tools and 2 skills.
      23
      86 npm
      3
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for Planfix API enabling task, project, contact, and comment management with 10 tools and 2 skills.
      20
      43 npm
      5
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server wrapping the full VitoDeploy REST API to manage projects, servers, sites, databases, services, workers, SSL, DNS, and more through any MCP-compatible agent, with 108 tools covering every endpoint.
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      An MCP server that wraps the UTEL IP-telephony REST API as MCP tools, enabling LLM agents to make authenticated HTTP requests to the UTEL API via a simple tool interface.
      1
      1
      -