How to Use the Placetel MCP in Claude Code

Q: How do I add the Placetel MCP server to Claude Code?

Run claude mcp add --transport http placetel -- in your terminal. Make sure all flags precede the server name. Verify the installation by running claude mcp list.

Q: Can I pipe Placetel call logs from Claude Code to another tool?

Yes. You can instruct the agent to run listcalldetailrecords and format the output as CSV. Redirect standard output to a file or pipe it directly into your logging infrastructure.

Pipe Placetel call records and SIP user data directly into your terminal with Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Placetel MCP to Claude Code

Create your Vinkius account to connect Placetel to Claude Code — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Placetel with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run headless PBX audits

The `list_sip_users` and `list_devices` tools allow Claude Code to audit your telephony hardware from the command line. You trigger a cron job that wakes up the agent, pulls the active SIP registrations, and compares them against your known MAC address inventory. Everything happens headlessly. Operations teams do not need a web UI to find rogue devices. Pipe the output of your inventory database into the agent. It runs `get_sip_user` against the discrepancies and drops a Slack alert if it finds unregistered hardware attached to your network.

Analyze call detail records in CI/CD

The `list_call_detail_records` tool lets you integrate telephony billing checks into your deployment pipelines. You write a shell script that asks the agent to verify the previous day's call volume. It pulls the raw CDRs, calculates the total minutes, and fails the build if the traffic spikes past a hardcoded threshold. Manual billing audits are slow and error-prone. Passing the raw JSON straight to a CLI agent allows for instant anomaly detection. The agent parses the timestamps, groups the data by extension, and writes a clean summary to standard output.

Map Claude Code to Placetel MCP

The `list_groups` and `get_group` tools expose your inbound routing logic to your terminal environment. You ask the agent to dump the current support queue configuration before a major system migration. It fetches the group members, formats the output as YAML, and saves it locally. Reverting a broken PBX setup is brutal without backups. Running a quick CLI command to snapshot the state via `list_users` and `list_numbers` gives you an instant recovery reference. You get raw, unformatted truth straight from the API.

Setup guide

Set up Placetel MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see placetel-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Placetel transactions." It will automatically discover and invoke the available Placetel tools.

Terminal

claude mcp add --transport http placetel-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Placetel MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "placetel-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Placetel. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Placetel now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Placetel MCP in Claude Code

Run `claude mcp add --transport http placetel -- ` in your terminal. Make sure all flags precede the server name. Verify the installation by running `claude mcp list`.

Yes. You can instruct the agent to run `list_call_detail_records` and format the output as CSV. Redirect standard output to a file or pipe it directly into your logging infrastructure.

No. Every time you ask the agent to check a user, it executes `get_user` live. The CLI does not store historical API payloads between sessions.

Tell the agent the specific group ID you want to inspect. It will execute `get_group` and print the routing logic directly to your terminal window.

The server touches raw CDRs, device MAC addresses, and active call states. Vinkius wraps every request in a zero-trust execution boundary. The connection terminates the millisecond the data reaches your CLI, leaving no stored artifacts on the hosting infrastructure.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript