# Placetel MCP for AI Agents AI Agent Connect

> Placetel MCP lets you manage your PBX system through an AI agent. It handles users, devices, and call logs so you don't have to dig through the Placetel dashboard to find basic information.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_6VW69WN8SvJGlu2ZD08rnbiVn5zoBSBRwtRnqWQf/ai-agent-connect
- **Tags:** cloud-pbx, sip-trunking, call-routing, telephony-api, call-detail-records

## Description

Imagine you need to audit calls from last night or find out which device a specific SIP user is tied to. Instead of logging into a complex PBX dashboard and filtering through rows of data, you just ask your agent to do it. This Connector connects your AI client to the Placetel API, letting you pull call detail records, list active users, and see your phone numbers in one place. It's about getting answers without the friction of a web UI. Whether you're looking for a specific group's status or need to check your routing plans, the AI handles the heavy lifting. You'll find this much faster when using it through the Vinkius catalog, which lets you keep all your enterprise tools in one spot. It turns your telephony data into something you can actually query and act on instantly.

## Tools

### list_devices
List every device connected to your Placetel account. This helps with hardware inventory.

### get_group
Get the specific details for a Placetel group. This is useful for checking group permissions.

### get_sip_user
Retrieve details for a specific SIP user. Use this to troubleshoot individual connection issues.

### get_user
Get details for a specific user in your account. This helps verify individual profile settings.

### list_call_detail_records
List all Call Detail Records (CDRs) for auditing. This is the primary way to see past call history.

### list_calls
List all active or recent calls happening now. Use this to monitor real-time traffic.

### list_groups
List every group within your Placetel system. This is great for reviewing your organizational structure.

### list_numbers
List all Placetel numbers assigned to your account. Use this to verify your phone number inventory.

### list_sip_users
List every SIP user currently in your system. This helps you see who has an active SIP profile.

### list_users
List every user in your Placetel account. Use this to get a full overview of your account users.

## Prompt Examples

**Prompt:** 
```
Who is currently using a desk phone?
```

**Response:** 
```
I've checked your active devices. Here are the phones currently online:

| Device Name | Status |
| :--- | :--- |
| Front Desk | Online |
| Sales Team 1 | Online |
| Warehouse | Offline |

Would you like me to see more details on any of these?
```

**Prompt:** 
```
Show me the call logs from the last hour.
```

**Response:** 
```
Here are the recent call records I found:

- **Inbound**: 12 calls
- **Outbound**: 4 calls
- **Missed**: 2 calls

Would you like me to pull a detailed list of the Call Detail Records for a specific number?
```

**Prompt:** 
```
Are there any SIP users in the Support group?
```

**Response:** 
```
I've checked the 'Support' group for you. There are currently 4 SIP users assigned to that group.

Would you like me to list their specific details or check their device status?
```

## Capabilities

### Pull call detail records
Retrieve historical call data to audit traffic or verify billing.

### List active devices
See every hardware device connected to your account and its current status.

### Retrieve SIP user details
Get specific configuration data for any SIP user in your system.

### View phone numbers and routing
Check your assigned numbers and how calls are being routed.

### Manage user groups
List all users and groups to verify account permissions and organization.

## Use Cases

### Troubleshooting a dropped call
An admin asks the agent to check list_calls and get_sip_user to see if a specific line is active or failing.

### Inventory Audit
A manager wants a list of all hardware and asks the agent to run list_devices to see what is currently registered.

### New Employee Onboarding
An IT lead asks the agent to check list_groups to ensure a new user has the right access levels.

### Billing Review
A finance lead asks the agent to list_call_detail_records to verify call volumes for a specific period.

## Benefits

- Audit call history instantly using list_call_detail_records instead of exporting CSVs.
- Quickly identify active hardware with list_devices to see who is online.
- Manage user permissions and groups across your account using list_users and list_groups.
- Troubleshoot connection issues by pulling specific SIP user data with get_sip_user.
- View your entire phone number inventory and routing plans with list_numbers.
- Monitor real-time traffic by asking the agent to list_calls during peak hours.

## How It Works

The bottom line is you get direct, conversational access to your PBX data without manual dashboard navigation.

1. Get your API Token from your Placetel account settings.
2. Connect the Connector to your AI client using the Vinkius setup.
3. Ask your agent to list users, check calls, or pull logs.

## Frequently Asked Questions

**Can the Placetel MCP help me manage my office phone system?**
Yes, it lets you interact with your PBX data via an AI agent. You can query users, check devices, and pull logs without manually navigating the web interface.

**How do I use Placetel MCP to check call history?**
You can ask your agent to pull call detail records for specific timeframes or users. It retrieves the data from the API and presents it to you in a conversational format.

**Does Placetel MCP let me see which devices are online?**
Yes, it can list all your registered devices and their current status. This is helpful for quickly seeing which hardware is active in your office.

**Can I use the Placetel MCP to see my phone numbers?**
Yes, your agent can retrieve a full list of numbers assigned to your account. This helps you keep track of your telephony inventory in one place.

**Is Placetel MCP good for auditing SIP users?**
It is great for that. You can list all SIP users or get details for specific ones to check permissions, groups, and other configuration settings.

**What kind of information does the Placetel MCP provide?**
It provides access to users, groups, SIP users, devices, phone numbers, and call logs. It connects your AI agent directly to your Placetel account data.

**Where do I find my API Token?**
Your API Token can be found in your Placetel web portal under Integrations > Web API.

**What access does this Connector need?**
It requires the REST API Token, giving access to users, calls, numbers, and devices.

**Can I initiate phone calls using this server?**
Currently, this integration supports retrieving Placetel data like CDRs and configurations. Call initiation via CTI will be added in a future update.

**What access does this MCP need?**
It requires the REST API Token, giving access to users, calls, numbers, and devices.