How to Use the Placetel MCP in CrewAI

Q: Can I build a CrewAI team to manage my Placetel phone numbers?

You can build a team to monitor your numbers. An agent can use listnumbers to inventory all phone numbers and listusers to see which ones are assigned. However, it cannot assign or unassign numbers, as these are read-only tools.

Deploy autonomous agent crews to monitor your Placetel VoIP system with CrewAI. Delegate monitoring, investigation, and reporting.

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 CrewAI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Deploy a 24/7 VoIP Monitoring Crew

Stop watching dashboards and let a crew of agents do it for you. Assign a 'Monitor Agent' the task of periodically running `list_calls`. If it spots an unusual number of failed calls, it passes the details to an 'Investigator Agent'. The Investigator Agent then gets to work. It uses `list_call_detail_records` to find the exact time of the failures, then checks `list_sip_users` and `list_devices` to see if the issue is tied to specific accounts or hardware. The crew's findings are then handed to a 'Reporter Agent' to summarize the incident.

Run Autonomous Resource Audits

You can build a crew dedicated to keeping your Placetel account organized. An 'Audit Agent' can be tasked with running `list_users` and `list_groups` weekly. It passes its findings to an 'Analyst Agent'. The Analyst Agent's job is to find discrepancies. It compares the user list to the group list, checks for users not in any group, or empty groups. It can also use `list_numbers` to check for unassigned phone numbers. This provides a constant, automated check on your configuration.

Delegate Call Performance Analysis

Find out how your team is using the phone system without crunching numbers yourself. A 'Data Mining Agent' can use the `list_call_detail_records` tool to pull all call data from the past month. It hands this raw data over to a 'Metrics Agent'. This second agent processes the data, calculating key metrics like average call duration, call volume by time of day, and most frequently dialed numbers. The final summary can be used to understand usage patterns and capacity needs. This MCP server gives your CrewAI agents the raw data they need to get started.

Setup guide

Set up Placetel MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke Placetel tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="Placetel Analyst",
    goal="Access and analyze Placetel data via MCP.",
    backstory="Expert analyst with direct Placetel access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent Placetel transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="Placetel Analyst",
        goal="Access and analyze Placetel data via MCP.",
        backstory="Expert analyst with direct Placetel access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Placetel transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 CrewAI

The simplest way is to pass your unique MCP server URL from Vinkius into the `mcps` parameter when defining your Agent in CrewAI. For more control, you can use `MCPServerHTTP` to filter which Placetel tools a specific agent can access.

Yes, that's exactly what CrewAI is designed for. You can have one agent in a sequential crew that continuously runs `list_calls`. When it finds something, it passes the context to the next agent, which can then use `get_user` or `list_call_detail_records` to dig deeper.

No, all the tools in this MCP server are read-only. Your agents can use tools like `list_users` and `list_devices` to monitor and investigate your Placetel account, but they cannot modify any settings, users, or configurations.

You can build a team to *monitor* your numbers. An agent can use `list_numbers` to inventory all phone numbers and `list_users` to see which ones are assigned. However, it cannot assign or unassign numbers, as these are read-only tools.

When an agent in your crew requests Placetel SIP user configurations with `get_sip_user`, that data is fetched through a secure, token-authenticated channel. The information is then held in the crew's shared memory for the duration of the task and is not stored by Vinkius. Access is confined to the agents within your defined crew.

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