placetel-web-api-mcp-server
Provides tools for the Webex endpoints of the Placetel Web API (14 tools), allowing management of Webex-related resources and configurations within a Placetel account. Note that these tools require the corresponding Placetel add-on product and may not be usable on every account.
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., "@placetel-web-api-mcp-server Show my phone numbers"
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.
placetel-web-api-mcp-server
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/v2Auth: Bearer token via
PLACETEL_API_KEYTransport: 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. | 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_hereGet 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_COUNTRegister 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.tsis 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:
Bump the version and update
CHANGELOG.md:npm version patch|minor|majorPush the tag:
git push --follow-tagsPublish 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 toolsplacetel_activate_numberActivate a numberC
Activate a number. (POST /numbers/{id}/activation)
Inputs: id (required), response_format.
placetel_activate_number_profileActivates a profile for a numberCIdempotent
Activates a profile for a number. (PUT /numbers/{number_id}/profiles)
Inputs: id (required), number_id (required), response_format.
placetel_add_subscriptionAdd a subscriptionCIdempotent
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 numberCIdempotent
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 numberCDestructiveIdempotent
Deactivate a number. (DELETE /numbers/{id}/activation) Destructive.
Inputs: id (required), response_format.
placetel_delete_callDelete a callCDestructiveIdempotent
Delete a call. (DELETE /calls/{id}) Destructive.
Inputs: id (required), response_format.
placetel_delete_contactDelete contactADestructiveIdempotent
Delete a contact by id. Destructive and irreversible.
Inputs: id (required).
placetel_delete_faxDelete a faxCDestructiveIdempotent
Delete a fax. (DELETE /faxes/{id}) Destructive.
Inputs: id (required), response_format.
placetel_delete_groupDelete a groupCDestructiveIdempotent
Delete a group. (DELETE /groups/{id}) Destructive.
Inputs: id (required), response_format.
placetel_delete_number_profileDelete a profile for a numberCDestructiveIdempotent
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 promptBDestructiveIdempotent
Delete a prompt. (DELETE /prompts/{id}) Destructive.
Inputs: id (required), response_format.
placetel_delete_provisioningDelete a phone provisioningsCDestructiveIdempotent
Delete a phone provisionings. (DELETE /provisionings/{id}) Destructive.
Inputs: id (required), response_format.
placetel_delete_provisioning_custom_configurationDelete a phone provisionings custom configuration keyBDestructiveIdempotent
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 recordingCDestructiveIdempotent
Delete a recording. (DELETE /recordings/{id}) Destructive.
Inputs: id (required), response_format.
placetel_delete_routingDelete a routing objectBDestructiveIdempotent
Delete a routing object. (DELETE /routings/{number_or_id}) Destructive.
Inputs: number_or_id (required), response_format.
placetel_delete_routing_planDelete a routing planCDestructiveIdempotent
Delete a routing plan. (DELETE /routing_plans/{id}) Destructive.
Inputs: id (required), response_format.
placetel_delete_sip_userDelete a sip userBDestructiveIdempotent
Delete a sip user. (DELETE /sip_users/{id}) Destructive.
Inputs: id (required), response_format.
placetel_delete_sip_user_short_codeDelete short codeCDestructiveIdempotent
Delete short code. (DELETE /sip_users/{id}/short_codes/{code_id}) Destructive.
Inputs: id (required), code_id (required), response_format.
placetel_delete_subscriptionDelete a subscriptionCDestructiveIdempotent
Delete a subscription. (DELETE /subscriptions/{id}) Destructive.
Inputs: id (required), response_format.
placetel_delete_userDelete a subuserBDestructiveIdempotent
Delete a subuser. (DELETE /users/{id}) Destructive.
Inputs: id (required), response_format.
placetel_delete_webex_userDelete a Webex userBDestructiveIdempotent
Delete a Webex user. (DELETE /webex/users/{id}) Destructive.
Inputs: id (required), response_format.
placetel_disconnect_microsoft_teams_userDisconnect userCDestructiveIdempotent
Disconnect user. (DELETE /microsoft_teams/users/{sip_user_id}) Destructive.
Inputs: sip_user_id (required), response_format.
placetel_get_ai_statusAI integration statusCRead-onlyIdempotent
AI integration status. (GET /ai/status) Read-only.
Inputs: response_format.
placetel_get_callRetrieve a callCRead-onlyIdempotent
Retrieve a call. (GET /calls/{id}) Read-only.
Inputs: id (required), response_format.
placetel_get_contactGet contactBRead-onlyIdempotent
Retrieve a single contact by its numeric id. Read-only.
Inputs: id (required), response_format.
placetel_get_cti_configGet config paramsCRead-onlyIdempotent
Get config params. (GET /cti/{mac}) Read-only.
Inputs: mac (required), params, response_format.
placetel_get_faxFetch specific faxBRead-onlyIdempotent
Fetch specific fax. (GET /faxes/{id}) Read-only.
Inputs: id (required), response_format.
placetel_get_groupFetch a groupBRead-onlyIdempotent
Fetch a group. (GET /groups/{id}) Read-only.
Inputs: id (required), response_format.
placetel_get_meMeCRead-onlyIdempotent
Me. (GET /me) Read-only.
Inputs: response_format.
placetel_get_microsoft_teams_integrationIntegrationCRead-onlyIdempotent
Integration. (GET /microsoft_teams/integration) Read-only.
Inputs: response_format.
placetel_get_numberRetrieve a numberCRead-onlyIdempotent
Retrieve a number. (GET /numbers/{id}) Read-only.
Inputs: id (required), response_format.
placetel_get_promptRetrieve a promptCRead-onlyIdempotent
Retrieve a prompt. (GET /prompts/{id}) Read-only.
Inputs: id (required), response_format.
placetel_get_provisioningRetrieve a phone provisioningsBRead-onlyIdempotent
Retrieve a phone provisionings. (GET /provisionings/{id}) Read-only.
Inputs: id (required), response_format.
placetel_get_provisioning_custom_configurationsRetrieve a phone provisionings custom configurationsCRead-onlyIdempotent
Retrieve a phone provisionings custom configurations. (GET /provisionings/{id}/custom_configurations) Read-only.
Inputs: id (required), response_format.
placetel_get_recordingFetch specific recordingCRead-onlyIdempotent
Fetch specific recording. (GET /recordings/{id}) Read-only.
Inputs: id (required), response_format.
placetel_get_routingRetrieve routingCRead-onlyIdempotent
Retrieve routing. (GET /routings/{number_or_id}) Read-only.
Inputs: number_or_id (required), response_format.
placetel_get_routing_planGet a routing planCRead-onlyIdempotent
Get a routing plan. (GET /routing_plans/{id}) Read-only.
Inputs: id (required), response_format.
placetel_get_sim_cardRetrieve a SIM cardCRead-onlyIdempotent
Retrieve a SIM card. (GET /sim_cards/{id}) Read-only.
Inputs: id (required), response_format.
placetel_get_sip_userFetch a sip userCRead-onlyIdempotent
Fetch a sip user. (GET /sip_users/{id}) Read-only.
Inputs: id (required), response_format.
placetel_get_siteRetrieve a siteCRead-onlyIdempotent
Retrieve a site. (GET /sites/{id}) Read-only.
Inputs: id (required), response_format.
placetel_get_userFetch user by IDCRead-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 numberCRead-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 userCRead-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 userBRead-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 workspaceCRead-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 agentsBRead-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 callsCRead-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 queuesARead-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 recordsCRead-onlyIdempotent
Get call detail records. (GET /call_detail_records) Read-only.
Inputs: date, page, per_page, response_format.
placetel_list_callsFetch all incoming callsCRead-onlyIdempotent
Fetch all incoming calls. (GET /calls) Read-only.
Inputs: page, order, per_page, filter_date, +4 more.
placetel_list_contactsList contactsARead-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 devicesCRead-onlyIdempotent
Fetch all devices. (GET /devices) Read-only.
Inputs: page, per_page, response_format.
placetel_list_faxesFetch in- and outbound faxesBRead-onlyIdempotent
Fetch in- and outbound faxes. (GET /faxes) Read-only.
Inputs: page, order, per_page, filter_type, +3 more.
placetel_list_groupsFetch all groupsCRead-onlyIdempotent
Fetch all groups. (GET /groups) Read-only.
Inputs: page, per_page, filter_name, filter_type, +2 more.
placetel_list_microsoft_teams_usersFetch all usersCRead-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 numberCRead-onlyIdempotent
List profiles for a number. (GET /numbers/{number_id}/profiles) Read-only.
Inputs: number_id (required), response_format.
placetel_list_numbersGet all numbersCRead-onlyIdempotent
Get all numbers. (GET /numbers) Read-only.
Inputs: page, per_page, filter_name, filter_number, +5 more.
placetel_list_promptsFetch all promptsCRead-onlyIdempotent
Fetch all prompts. (GET /prompts) Read-only.
Inputs: page, per_page, filter_name, response_format, +1 more.
placetel_list_provisioningsGet all phone provisioningsCRead-onlyIdempotent
Get all phone provisionings. (GET /provisionings) Read-only.
Inputs: page, search, per_page, webuser_id, +1 more.
placetel_list_recordingsFetch call recordingsCRead-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 objectsCRead-onlyIdempotent
Get a routing plans objects. (GET /routing_plans/{id}/routings) Read-only.
Inputs: id (required), response_format.
placetel_list_routing_plansGet all routing plansARead-onlyIdempotent
Get all routing plans. (GET /routing_plans) Read-only.
Inputs: page, per_page, response_format.
placetel_list_routingsGet all routingsCRead-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 cardsBRead-onlyIdempotent
Fetch all SIM cards. (GET /sim_cards) Read-only.
Inputs: page, per_page, filter_status, response_format.
placetel_list_sip_usersFetch all sip usersBRead-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 codesCRead-onlyIdempotent
Short codes. (GET /sip_users/{id}/short_codes) Read-only.
Inputs: id (required), response_format.
placetel_list_sitesGet all sitesCRead-onlyIdempotent
Get all sites. (GET /sites) Read-only.
Inputs: page, per_page, response_format.
placetel_list_subscriptionsList subscriptionsCRead-onlyIdempotent
List subscriptions. (GET /subscriptions) Read-only.
Inputs: response_format.
placetel_list_usersFetch all usersCRead-onlyIdempotent
Fetch all users. (GET /users) Read-only.
Inputs: page, per_page, filter_type, filter_email, +4 more.
placetel_list_webex_usersFetch all Webex usersCRead-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 workspacesBRead-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 numberADestructiveIdempotent
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 userCDestructiveIdempotent
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 paramsCIdempotent
Set config params. (PUT /cti/{mac})
Inputs: mac (required), params (required), response_format.
placetel_simulate_routing_planSimulate the usage of a routing planCRead-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 agentCIdempotent
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 queueCIdempotent
Update a queue. (PUT /call_center_queues/{id})
Inputs: id (required), name, priority, num_loops, +13 more.
placetel_update_contactUpdate contactBIdempotent
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 groupCIdempotent
Update a group. (PUT /groups/{id})
Inputs: id (required), name, member_ids, description, +1 more.
placetel_update_promptUpdate a promptBIdempotent
Update a prompt. (PUT /prompts/{id})
Inputs: id (required), name (required), voice (required), file, +3 more.
placetel_update_provisioningUpdate a phone provisioningsCIdempotent
Update a phone provisionings. (PUT /provisionings/{id})
Inputs: id (required), keys, name, codec, +6 more.
placetel_update_routingUpdate routingDIdempotent
Update routing. (PUT /routings/{number_or_id})
Inputs: number_or_id (required), api, ivr, name, +11 more.
placetel_update_routing_planUpdate a routing planCIdempotent
Update a routing plan. (PUT /routing_plans/{id})
Inputs: id (required), name (required), did, description, +2 more.
placetel_update_sip_userUpdate a sip userCIdempotent
Update a sip user. (PUT /sip_users/{id})
Inputs: id (required), did, name, callerid, +13 more.
placetel_update_userUpdate a subuserCIdempotent
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 keyCIdempotent
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
Scored across 124 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for MOCO business software: time tracking, projects, budgets, and invoicing via API
Screenshots, PDFs, image editing, QR codes, email validation and more through one hosted MCP server.
380+ live data, validation and utility APIs in one MCP server: IP, DNS, email, FX, weather and more.
WhatsApp (Web + Business API), SMS, contacts, and call records via 2Chat's MCP server.
Related MCP Servers
- AlicenseCqualityCmaintenanceMCP server for Voximplant API enabling calls, SMS, recordings, scenarios, and rules management with 11 tools and 2 skills.2386 npm3MIT
- AlicenseAqualityBmaintenanceMCP server for Planfix API enabling task, project, contact, and comment management with 10 tools and 2 skills.2043 npm5MIT
- AlicenseNot gradedqualityCmaintenanceMCP 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
- FlicenseAqualityDmaintenanceAn 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.11-