Integration

Placetel integration

Placetel is a German cloud telephone system (PBX). With this API an agent can read the call list and call detail records, start a call from a SIP user, send SMS and faxes, manage the phone book contacts, SIP users, account users, ring groups, call routings and routing plans, prompts (greetings), number profiles, call center agents and queues, phone provisionings, SIM cards, sites and call event subscriptions (webhooks). Most routes need a Placetel PROFI account; numbers, contacts, faxes, SMS, sites, SIM cards and call detail records also work on Placetel for Webex. Not exposed: desk phone CTI control, the Webex and Microsoft Teams provisioning routes, reseller customer routes, picking a waiting call center call for an agent, password and two-factor resets, free-form phone configuration keys, and file download links (recording audio, voicemail, fax PDFs). Authentication is the account's API key, sent as a Bearer token; create it in the Placetel web portal under Integrations, Web API.

Connect Placetel How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Placetel.Built from the 84 Placetel tools below, on the connection you add once.

What you can do with Placetel

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Provisioning, 6 operations

create_provisioningCreate provisioningPOSTRegisters a desk phone for automatic provisioning by its MAC address and phone model (a device id from list_devices). Returns the provisioning.
delete_provisioningDelete provisioningDELETEPermanently deletes a phone provisioning.
get_provisioningGet provisioningGETReturns one phone provisioning by its ID.
list_provisioningsList provisioningsGETLists the provisioned desk phones: name, MAC address, user, codec, locale, lines, keys, device model and encryption. Free-form configuration keys are not returned.
reconfigure_provisioningReconfigure provisioningPOSTSends a SIP command to the phone's line 1 user so the phone fetches its configuration changes.
update_provisioningUpdate provisioningPUTUpdates a phone provisioning (name, user, codec, call waiting, encryption, locale, lines, keys); send only the fields to change.

Routing plan, 6 operations

create_routing_planCreate routing planPOSTCreates a routing plan made of routing object ids from list_routings. Returns the plan.
delete_routing_planDelete routing planDELETEPermanently deletes a routing plan.
get_routing_planGet routing planGETReturns one routing plan by its ID.
list_routing_plansList routing plansGETLists the routing plans with their name, description and extension. Paginated with page and per_page.
simulate_routing_planSimulate routing planGETSimulates which routing a call would take through a routing plan, optionally at a given time.
update_routing_planUpdate routing planPUTUpdates a routing plan. The vendor requires name on every update: read it with get_routing_plan and send it back with the change.

Contact, 5 operations

create_contactCreate contactPOSTCreates a phone book contact (names, company, emails, addresses, phone, mobile and fax numbers, social links, tags, blocked flag). Returns the new contact.
delete_contactDelete contactDELETEPermanently deletes a phone book contact.
get_contactGet contactGETReturns one phone book contact by its ID.
list_contactsList contactsGETLists the phone book contacts, filterable by name, company, email, phone numbers, blocked state and update time; search[number] finds a contact by phone number.
update_contactUpdate contactPUTUpdates a phone book contact; send only the fields to change.

Group, 5 operations

create_groupCreate groupPOSTCreates a ring group of type ring_all, monitoring or hunt, optionally with member SIP user ids. Returns the new group.
delete_groupDelete groupDELETEPermanently deletes a ring group.
get_groupGet groupGETReturns one ring group by its ID, with its member SIP users.
list_groupsList groupsGETLists the ring groups (ring_all, monitoring or hunt) with their member SIP users.
update_groupUpdate groupPUTUpdates a ring group's name, description or members; member_ids replaces the member list.

Prompt, 5 operations

create_promptCreate promptPOSTCreates a prompt from text synthesized with a voice, or from an uploaded audio file (base64 data URI). Returns the prompt; use its id in queues and routings.
delete_promptDelete promptDELETEPermanently deletes a prompt.
get_promptGet promptGETReturns one prompt by its ID.
list_promptsList promptsGETLists the prompts (greetings and announcements) with their name, description and synthesized text. Audio file links are not returned.
update_promptUpdate promptPUTUpdates a prompt. The vendor requires name and voice on every update: read them with get_prompt and send them back with the change.

Routing, 5 operations

create_routingCreate routingPOSTCreates a routing object of one kind: forward, group, ivr, queue or api, with optional mailbox, notification, time settings and caller id. Returns it.
delete_routingDelete routingDELETEPermanently deletes a routing object.
get_routingGet routingGETReturns the routing of a phone number, or a routing object by its ID.
list_routingsList routingsGETLists the routing objects (how calls to a number are handled: forward, group, plan, IVR, queue, API, AI, mailbox, notifications and time settings).
update_routingUpdate routingPUTChanges how calls to a number are handled: set it to forward, group, plan, ivr, queue or api.

Sip user, 5 operations

create_sip_userCreate sip userPOSTCreates a SIP user (a phone extension) of type standard, legacy_standard, blf, fax or trunk. Returns it; its SIP password is not returned here.
delete_sip_userDelete sip userDELETEPermanently deletes a SIP user (phone extension).
get_sip_userGet sip userGETReturns one SIP user by its ID. The SIP password and hotdesk PIN are not returned.
list_sip_usersList sip usersGETLists the SIP users (phone extensions) with sipuid, extension, caller id, type, linked user, online state and hotdesk settings. SIP passwords are not returned.
update_sip_userUpdate sip userPUTUpdates a SIP user (name, extension, caller id, linked user, prefixes, hotdesk settings, fallback routing plan); send only the fields to change.

User, 5 operations

create_subuserCreate subuserPOSTCreates a subuser of your account, optionally with an extension, caller id and a phone. A subuser without email cannot log in to the web portal. Returns the user.
delete_subuserDelete subuserDELETEPermanently deletes a subuser of your account.
get_userGet userGETReturns one user of the account by its ID.
list_usersList usersGETLists the users of the account (main account and subusers) with login, email, names, extension, caller id, admin flag, number rights, permissions and 2FA state.
update_subuserUpdate subuserPUTUpdates a subuser (names, email, extension, caller id, admin rights, number rights, locale, permissions, avatar); send only the fields to change.

Call, 4 operations

delete_callDelete callDELETEPermanently deletes a call from the call list.
get_callGet callGETReturns one call by its ID: type, from and to number, duration, the matched phone book contact, time received and read state.
initiate_callInitiate callPOSTStarts a real outbound phone call from the SIP user given by sipuid (from list_sip_users) to the target number. Returns the call.
list_callsList callsGETLists the incoming calls of one day (filter[date], default today), filterable by type (voicemail, missed, blocked, accepted), from and to number. Voicemail audio links are not returned.

Fax, 4 operations

delete_faxDelete faxDELETEPermanently deletes a fax.
get_faxGet faxGETReturns one inbound or outbound fax by its ID, including its status (for example success) and, for outbound faxes, status_info.
list_faxesList faxesGETLists inbound and outbound faxes (type, numbers, pages, retries, status, status info, header, duration). Fax PDF and report links are not returned.
send_faxSend faxPOSTSends a real fax of a PDF document from one of your numbers to to_number. Returns the fax; poll get_fax for its status.

Number, 4 operations

activate_numberActivate numberPOSTActivates a phone number of the account. Placetel warns you may be charged for that number. Returns the number.
deactivate_numberDeactivate numberDELETEDeactivates a phone number of the account, so it stops taking calls.
get_numberGet numberGETReturns one phone number record by its ID.
list_numbersList numbersGETLists the account's phone numbers with id, routing_id, site, prefix, number, E.164 form, activation and test-number flags, name and carrier.

Number profile, 4 operations

activate_number_profileActivate number profilePUTChanges which profile is active for a phone number; pass the profile id from list_number_profiles.
create_number_profileCreate number profilePOSTCreates a new profile for a phone number. Returns the profile.
delete_number_profileDelete number profileDELETEPermanently deletes a profile of a phone number.
list_number_profilesList number profilesGETLists the profiles of a phone number (name and whether it is the active one).

Call center agent, 3 operations

create_call_center_agentCreate call center agentPOSTCreates a call center agent reached on a SIP extension (a sipuid from list_sip_users) or a PSTN number. Returns the new agent.
list_call_center_agentsList call center agentsGETLists the call center agents with their SIP or PSTN extension, agent type (Agent or Supervisor), status and priority. Paginated with page and per_page.
update_call_center_agentUpdate call center agentPUTUpdates a call center agent (name, priority, status, extension). The vendor requires extension_sip and extension_pstn on every update: read them with list_call_center_agents and send them back.

Call center queue, 3 operations

create_call_center_queueCreate call center queuePOSTCreates a call center queue. Prompts are referenced by ids from list_prompts. Returns the new queue.
list_call_center_queuesList call center queuesGETLists the call center queues with their ringing time, loops, priority, notification email and the prompts played. Paginated with page and per_page.
update_call_center_queueUpdate call center queuePUTUpdates a call center queue; send only the fields to change.

Recording, 3 operations

delete_recordingDelete recordingDELETEPermanently deletes a call recording.
get_recordingGet recordingGETReturns one call recording's metadata by its ID (direction, from, to, duration, time). The audio file link is not returned.
list_recordingsList recordingsGETLists call recordings (direction, from, to, duration, time), filterable by direction, numbers and date. The audio file links are not returned.

Short code, 3 operations

create_sip_user_short_codeCreate sip user short codePOSTCreates a short code for a SIP user: dialing code on the phone runs the action (set or clear a forward, anonymous calls, group login, mailbox, profile and more).
delete_sip_user_short_codeDelete sip user short codeDELETEPermanently deletes a short code of a SIP user.
list_sip_user_short_codesList sip user short codesGETLists the short codes of a SIP user (codes that trigger an action such as setting a forward).

Subscription, 3 operations

create_subscriptionCreate subscriptionPUTRegisters a webhook: Placetel POSTs form-encoded call events (incoming, outgoing, accepted, hungup, CTI) for the given numbers to url. Returns the subscription.
delete_subscriptionDelete subscriptionDELETEDeletes a call event subscription, so its webhook stops receiving events.
list_subscriptionsList subscriptionsGETLists the call event subscriptions (webhooks) with their id, the events they cover and the numbers they watch. The callback URLs are not returned.

Sim card, 2 operations

get_sim_cardGet sim cardGETReturns one SIM card by its ID.
list_sim_cardsList sim cardsGETLists the Placetel MOBILE SIM cards with card type, ICCID (after activation), contract, number, linked SIP user and status.

Site, 2 operations

get_siteGet siteGETReturns one site by its ID (name, city, country, area prefix).
list_sitesList sitesGETLists the account's sites (locations) with name, city, country and area prefix.

Account, 1 operation

get_meGet meGETReturns the account the API key belongs to: id, name, email, company, primary SIP user id, platform (for example PROFI), numbers it has rights on and main account id.

Ai integration, 1 operation

get_ai_statusGet ai statusGETReturns the status of the account's AI integration; the minute package, remaining budget and minutes, total cost and currency are only returned while the integration is active.

Call center call, 1 operation

list_call_center_callsList call center callsGETLists the call center calls of one day (date, required), optionally for some queues: type, status, answer status, times, from, to, queue and agent name.

Call detail record, 1 operation

list_call_detail_recordsList call detail recordsGETLists the billed call detail records of one day (date, required): amount charged, description, from, to, length in seconds and time.

Device, 1 operation

list_devicesList devicesGETLists the phone models Placetel can provision (name, manufacturer, number of lines and keys, DECT and encryption support). See phone_model in create_provisioning and create_subuser.

Routing plan routing, 1 operation

list_routing_plan_routingsList routing plan routingsGETLists the routing objects that make up a routing plan.

Sms, 1 operation

send_smsSend smsPOSTSends a real SMS with your message to the recipient number. Returns no body.

Use Placetel from Claude Code, Cursor or Codex

Connect Placetel in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Placetel operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Placetel

Create your workspace
Sign up free. Nothing to install.
Connect Placetel once
Add your Placetel connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.