# Callpicker MCP > Callpicker MCP lets you manage all your business phone lines and analyze call performance directly through your AI client. Track which marketing channel sends the best leads, initiate calls from any virtual number, and pull detailed Call Detail Records (CDRs) without logging into a PBX portal. You get full control of your cloud telephony workflow. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** cloud-pbx, call-recording, call-attribution, virtual-numbers, sales-performance, telephony ## Description You're used to managing complex call center systems through clunky web portals—the ones filled with menus, tabs, and reports that take forever to load. This MCP changes that. It lets you treat your entire virtual phone system like a natural conversation. Instead of manually digging for data or clicking through multiple dashboards, you just talk to your agent. Your agent handles the heavy lifting: it can check if all your extensions are active, list every available number, and even initiate high-fidelity calls worldwide using your PBX numbers. You get full visibility into call history and attribution data that shows exactly which marketing source drove a specific lead's phone call. Since Vinkius hosts this MCP, you connect once to access these telephony tools alongside thousands of others. ## Tools ### get_call_details Pulls the specific details for any single call interaction using its identifier. ### get_cdr_report Generates a detailed Call Detail Record report showing usage metrics across specified time ranges. ### get_pbx_system_status Checks the current operational status and health of the entire PBX system. ### get_recording_url Retrieves a secure, temporary download link for a specific call recording. ### list_call_logs Lists a summary of recent calls, including duration and general status indicators. ### list_pbx_extensions Outputs the internal directory structure, listing all assigned PBX extensions. ### list_virtual_numbers Shows the full inventory of callable virtual phone numbers available to your business. ### list_call_recordings Provides a list of all available recorded interactions for review or download. ### make_call Initiates a new outgoing phone call, directing it through your specified PBX 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 outgoing calls Your agent programmatically starts high-fidelity phone calls from your virtual PBX numbers to any destination globally. ### Analyze call history and logs Retrieve detailed, structured reports on all incoming and outgoing calls, including full Call Detail Records (CDRs). ### Download recorded conversations Get secure download links for specific call recordings so you can review customer interactions later. ### Map your phone architecture View a full directory of all virtual numbers and internal PBX extensions to plan your communication setup. ## Use Cases ### Auditing lead quality after a campaign The marketing team ran a big campaign. Instead of exporting 50 separate call logs and manually cross-referencing the source, the agent runs `get_cdr_report` for last month's dates and identifies that leads from Source X have a significantly higher average conversation duration than Source Y. ### Troubleshooting a failed connection A sales rep reports a call dropped out. The agent first checks `get_call_details` using the provided call ID, then uses `get_pbx_system_status` to verify if the underlying PBX system had any reported outages during that time window. ### Training new agents on compliance A manager needs to review a specific customer interaction. They ask the agent to `list_call_recordings`, find the ID, and then request `get_recording_url` so they can download the clip for training purposes. ### Planning department expansion The company is opening a new regional office. Instead of calling the PBX admin to get a list of available numbers, the operations team asks to `list_virtual_numbers` and sees exactly what pool of lines they have left for assignment. ## Benefits - Stop manual data entry. When you need to analyze history, your agent runs the `get_cdr_report` automatically, compiling complex usage data instantly. - Immediate call control: Don't waste time figuring out which number to use; simply ask your agent to make a call, and it handles the connection via `make_call`. - Forensic review is fast. Instead of navigating deep folders, you just list all available recordings using `list_call_recordings`, then grab a secure link with `get_recording_url` for immediate download. - System health checks are instant. If something's broken, you don't guess; simply ask your agent to check the system status via `get_pbx_system_status` and get an answer. - Full number visibility: Need to know what numbers your team uses? Asking to `list_virtual_numbers` gives you a complete, current inventory without leaving your workspace. ## How It Works The bottom line is you stop interacting with portals and start talking directly to your telephony data. 1. Subscribe to this MCP and retrieve your Client ID and Secret from the Callpicker Portal. 2. Connect these credentials to your preferred AI client (Claude, Cursor, etc.) via Vinkius. 3. Ask your agent a natural language query; it uses the tools to pull call data or execute calls in real time. ## Frequently Asked Questions **How do I use the `make_call` tool?** You simply instruct your agent to initiate a call. You specify the destination number and which virtual number you want it to originate from, and the agent handles the rest of the connection process. **What is the difference between `list_call_logs` and `get_cdr_report`?** `list_call_logs` gives you a quick snapshot—a summary view of recent calls. `get_cdr_report`, however, generates a deep, comprehensive report perfect for auditing and historical analysis. **Can I check my phone system status with the `get_pbx_system_status` tool?** Yes, you can. This tool checks the overall operational health of your PBX infrastructure, telling you if there are any known issues or outages. **Does `list_virtual_numbers` show all my lines?** It shows the complete inventory of virtual phone numbers assigned to your account. This is helpful for planning expansion or auditing unused assets. **How long does the URL generated by `get_recording_url` remain active?** The link is secure but expires after a set time period, typically 24 hours. You must use this specific URL within that window to download the high-fidelity recording data you need. **What information does `list_pbx_extensions` provide about my internal numbers?** It provides a complete, structured directory of all your virtual PBX extensions. This allows agents to map out and manage your entire internal communication structure efficiently. **Can I filter the data when requesting reports using `get_cdr_report`?** Yes, you can specify detailed filters like date ranges or specific call types in your report query. This ensures the resulting Call Detail Records are precisely tailored to your analysis needs. **What steps should I take if `get_call_details` returns an error?** First, verify that the unique call ID you provided is correct and active. If the ID is accurate, check your account permissions or API credentials in the Callpicker portal. **How do I find my Callpicker Client ID and Secret?** Log in to the [**Callpicker Portal**](https://admin.callpicker.com/), navigate to **Configuration** > **API**, and generate your credentials. **Can I retrieve call recordings via AI?** Yes! The `get_recording_url` tool provides a temporary secure link to play or download any recorded interaction in your account. **How do I check my virtual numbers?** Use the `list_virtual_numbers` tool to retrieve your complete directory of active virtual phone numbers programmatically.