# Callpicker MCP MCP > Callpicker tracks and analyzes inbound calls, giving you attribution data that shows exactly which marketing channels drive your best phone leads. It gives your AI agent full control over virtual PBX workflows, letting you initiate live calls, check system health, or pull detailed call records without ever leaving your primary workspace. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** cloud-pbx, call-recording, call-attribution, virtual-numbers, sales-performance, telephony ## Description This MCP connects cloud-based business telephony and virtual PBX services directly into your AI workflow. You manage your entire communication pipeline using natural conversation, eliminating the need to log data manually or dig through complex portals. Your agent handles everything from checking system uptime to initiating a live call with a client worldwide. If you're running other systems—say, a CRM for lead tracking and an accounting MCP for billing—you can use Vinkius to chain these services together. You start by asking your AI agent to pull the recent logs, then tell it to initiate a follow-up call to that lead using its virtual number, and finally, have it record the success metrics in the CRM. This capability means your phone system isn't just another tool; it’s an active part of your automated business process. ## Tools ### get_call_details Pulls specific details for a single, known phone call interaction. ### get_cdr_report Generates and retrieves full Call Detail Records (CDR) reports for specified time periods. ### get_pbx_system_status Checks the current operational health status of your entire PBX system. ### get_recording_url Provides a secure, temporary download link for a specific call recording ID. ### list_call_logs Lists recent phone call logs, giving an overview of interactions by date and status. ### list_call_recordings Retrieves a list of all available recorded calls for review. ### list_pbx_extensions Lists the internal extension numbers used within your organization's PBX system. ### list_virtual_numbers Retrieves a complete directory of all active virtual phone numbers assigned to your account. ### make_call Initiates an outgoing, high-fidelity phone call from any registered virtual number. ## Prompt Examples **Prompt:** ``` Initiate a call to '+1234567890' from my virtual number '+0987654321'. ``` **Response:** ``` Call triggered! I've successfully initiated the outgoing call via Callpicker. The PBX is now bridging the connection to +1234567890. Shall I notify you when the call completes? ``` **Prompt:** ``` Show the last 5 call logs with duration and status. ``` **Response:** ``` Accessing call logs... Your last 5 interactions include 3 answered calls (avg 5m 12s) and 2 missed. The most recent was a 12-minute consultation. Need the high-fidelity CDR report for these? ``` **Prompt:** ``` Get the download link for call recording ID '789'. ``` **Response:** ``` Link generated! You can download the recording for interaction 789 here: [recording_url]. The link is secure and valid for 24 hours. Would you like a summary of the PBX status? ``` ## Capabilities ### Initiate Live Calls Your agent can programmatically dial out from any virtual PBX number to a destination anywhere in the world. ### Generate Call Reports You retrieve detailed, structured records (CDR) for specific date ranges or call groups. ### Audit Conversation History The MCP monitors and retrieves real-time logs of all incoming and outgoing calls. ### Retrieve Recordings You get secure, temporary download links for specific call recordings for quality review. ### Manage System Directory The agent accesses and lists all available virtual phone numbers and internal extensions. ## Use Cases ### Tracking a Campaign's Effectiveness A marketing manager needs to know if the new LinkedIn campaign is working. They ask their agent to run `get_cdr_report` for all calls tagged 'LinkedIn'. The report immediately shows which channels drove the most answered, high-duration conversations. ### Immediate Follow-Up on a Cold Lead A sales rep gets an alert about a hot lead. Instead of opening a separate telephony portal, they ask their agent to `make_call` immediately using the company's dedicated virtual number for the connection. ### Auditing a Support Incident The support supervisor needs proof of conversation content from last Tuesday. They use the agent to list recordings via `list_call_recordings`, find the correct ID, and then generate the secure link using `get_recording_url`. ### Pre-flight System Check The IT Ops engineer needs to know if the PBX is ready for a major deployment. They ask the agent to run `get_pbx_system_status`, getting an immediate, actionable report on system health. ## Benefits - Calling `list_call_logs` gives you a quick view of recent activity, so you don't have to click through multiple tabs just to see if a call went out or got missed. - Using `make_call`, you can instantly initiate a follow-up conversation with a lead using your virtual numbers, turning data into immediate action. - When you need detailed metrics, running the `get_cdr_report` function provides structured records, which is better than manually reviewing logs for compliance or billing purposes. - You maintain oversight of every interaction by listing available recordings via `list_call_recordings`, and then getting a specific download link using `get_recording_url`. - The ability to check the system health with `get_pbx_system_status` means your agent can report on platform uptime, saving Ops Managers time during routine checks. ## How It Works The bottom line is that you stop interacting with separate PBX portals and start managing everything through one conversation window. 1. First, subscribe to the Callpicker MCP. Then, grab your Client ID and Secret from the Callpicker Portal's API settings. 2. Connect those credentials to your preferred AI client (like Cursor or Claude). 3. Your agent can then use natural language commands to manage all of your voice workflows. ## Frequently Asked Questions **How do I check if my PBX system is working before making calls using make_call?** Run `get_pbx_system_status` first. This tool checks the real-time operational health of your entire PBX, confirming everything is running smoothly before you try to initiate any connections. **Can I get all call records for a specific month using get_cdr_report?** Yes. You provide the date range parameters when calling `get_cdr_report`, and it compiles the full, detailed report data you need for auditing or billing. **What is the difference between list_call_logs and get_call_details?** `list_call_logs` gives you an overview of several recent interactions. `get_call_details` lets you drill down and pull specific, granular data for one exact call ID. **What numbers are available on my account? Do I need to list_virtual_numbers first?** You can use the `list_virtual_numbers` tool. It gives you a full directory of every active phone number assigned to your virtual PBX for immediate reference. **If I use get_recording_url, what happens if the link expires or is unavailable?** The function returns a secure, time-limited URL. If the recording is deleted or the generated link passes its expiration window, the call will fail and you'll receive an error code telling you exactly why. **How can I filter my recent calls when using list_call_logs?** You specify filtering parameters like date ranges, status (answered/missed), or even duration. This lets your agent narrow down the call data instantly without needing to run a full CDR report. **What is the practical use of list_pbx_extensions in my workflows?** This tool lists every internal extension number configured on your PBX. You pass this directory to your agent so it knows which department or group code to route an inbound call through. **If I only know a date, how can I retrieve data using get_call_details?** You need the unique Call ID for `get_call_details`. If you don't have it, use `list_call_logs` first. The logs will give you the specific IDs needed to pull full details.