How to Use the Placetel MCP in Windsurf

Q: How do I install the Placetel MCP server in Windsurf?

Open your mcpconfig.json file in /.codeium/windsurf/. Add the endpoint details under the mcpServers block. Click refresh in the MCP panel to sync the tools.

Q: How does Windsurf cross-reference Placetel SIP users with physical devices?

Cascade chains multiple tools autonomously. It runs listsipusers to get the account IDs and then loops through listdevices to match the MAC addresses to the active accounts.

Let Windsurf Cascade pull your Placetel call records and audit SIP endpoints autonomously.

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 Windsurf

Create your Vinkius account to connect Placetel to Windsurf — 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 Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map Placetel infrastructure with Windsurf

The `list_devices` and `list_numbers` tools let Windsurf read your entire physical and virtual routing setup in one pass. Cascade looks at the raw JSON payload, maps which hardware phones attach to which extensions, and builds a complete inventory matrix without asking you for permission. You do not have to write a script to cross-reference this data. Tell your agent to find unassigned extensions. It fires `list_users`, compares the output against `list_numbers`, and spits out a clean markdown table of orphaned lines.

Audit call logs and SIP users

The `list_call_detail_records` tool hands Windsurf the raw metadata for every inbound and outbound connection on your PBX. Cascade grabs the timestamp, duration, and origin data directly from the API. It chains this with `list_sip_users` to trace an exact path of who dialed what. Finding a ghost call takes seconds. You ask the IDE why a specific branch complained about dropped calls yesterday. It queries the CDRs, filters the latency codes, checks the SIP status for that specific group, and drops the findings right in your editor.

Inspect group configurations

The `get_group` and `list_groups` tools pull the exact routing logic and member lists for your ring groups. You tell Windsurf to verify the support team's call flow. It pulls the group ID, fetches the specific user assignments via `get_user`, and diagrams the exact ringing order. No clicking through a slow web admin panel. Cascade pulls the raw configuration state straight into your workspace. If an employee left the company, the agent spots their active SIP credentials and flags the security risk immediately.

Setup guide

Set up Placetel MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
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

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Placetel payment history." If connected, Cascade will call the Placetel tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "placetel-mcp": {
      "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 Windsurf

Open your `mcp_config.json` file in `~/.codeium/windsurf/`. Add the endpoint details under the `mcpServers` block. Click refresh in the MCP panel to sync the tools.

No. This MCP server only supports read operations. Your agent can pull data using tools like `get_sip_user`, but it cannot overwrite your PBX configuration.

Your API token likely lacks the correct permissions. Verify that your credentials allow access to the CDR endpoints. Cascade needs those rights to fire `list_call_detail_records`.

Cascade chains multiple tools autonomously. It runs `list_sip_users` to get the account IDs and then loops through `list_devices` to match the MAC addresses to the active accounts.

The server processes raw call metadata, including caller IDs, durations, and SIP account names. Vinkius isolates this data in a V8 sandbox during the request cycle. Memory dumps immediately after the tool returns the JSON, leaving zero persistent traces of your phone traffic.

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