# Goodcall MCP > Goodcall MCP Server lets you manage an entire fleet of AI phone agents from a single place. You can list agents, check call history, and get full transcripts and summaries for every interaction. It lets you track missed calls, view all booked appointments, and monitor performance metrics—all through your AI client. ## Overview - **Category:** customer-support - **Price:** Free - **Tags:** virtual-receptionist, appointment-scheduling, ai-voice-agent, call-handling, customer-inquiries, automated-phone-system ## Description **Goodcall MCP Server: Managing Your AI Phone Agent Fleet** Manages your entire fleet of AI phone agents right from your AI client. You'll list every agent, check call history, and get full transcripts and summaries for every single interaction. You can track missed calls, view all booked appointments, and monitor performance metrics—all in one place. **Getting Agent Details and Status** Your agent's status and configuration are always visible. You'll check the `check_goodcall_status` tool to verify the API's current connectivity and operational status. To see what a specific agent is running, you use `get_agent` to pull its details and configuration. You can also get a full picture of your whole setup by running `list_agents`, which pulls a list of every virtual phone agent and their current settings. If you need to change how an agent behaves, you modify it using `update_agent`, letting you change its scripts or behavior. You can also review all the custom knowledge bases agents use by calling `list_faqs`, which lists all the Frequently Asked Questions entries configured for agents to use during calls. **Reviewing Calls and Calls by Agent** You'll get a list of all recorded calls using `list_calls`, letting you filter by date or status to review call history. For a deep dive, you can filter calls by a specific agent using `list_calls_by_agent`. When you need the raw data, `get_transcript` pulls the complete, raw text transcript of any recorded phone call. To save you time, `get_call_summary` provides a high-level, AI-generated summary of a specific call's key topics and outcomes. You can also pull basic metadata and core details for any specific call record with `get_call`. **Tracking Missed Opportunities and Bookings** You don't wanna lose a lead. `list_missed_calls` identifies and lists all calls that were missed, abandoned, or need follow-up action, so you know exactly what needs attention. To see the appointments the agents set up, `list_bookings` retrieves a list of all bookings the AI agents successfully scheduled during a call. Furthermore, you can review all the scheduled appointments using `list_bookings`. **Performance Metrics and Analytics** To understand how the whole system is doing, you use `get_analytics` to generate a comprehensive report on overall call volume, answer rates, and booking trends. You'll find all the tools you need to manage your entire AI phone agent fleet in one place. ## Tools ### check_goodcall_status Verifies the current connectivity and operational status of the Goodcall API. ### get_agent Retrieves the specific details and configuration for a single virtual phone agent. ### get_analytics Generates a comprehensive report on overall call volume, answer rates, and booking trends. ### get_call Retrieves basic metadata and core details for a specific call record. ### get_call_summary Provides a high-level, AI-generated summary of a specific call's key topics and outcomes. ### get_transcript Fetches the complete, raw text transcript of a specific phone call. ### list_agents Lists all available virtual phone agents and their current configurations. ### list_bookings Retrieves a list of all appointments booked by the AI agents. ### list_calls Lists all recorded calls, allowing filtering and basic review of call history. ### list_calls_by_agent Lists all calls, specifically filtering the results by a given agent ID. ### list_faqs Lists all the Frequently Asked Questions entries configured for agents to use during calls. ### list_missed_calls Identifies and lists all calls that were missed, abandoned, or need follow-up action. ### update_agent Modifies the settings, scripts, or behavior of an existing virtual phone agent. ## Prompt Examples **Prompt:** ``` Show all calls from today and highlight any missed calls that need follow-up. ``` **Response:** ``` Today's call summary: 18 total calls handled by your AI agents. 15 answered successfully (83.3% answer rate), 3 missed calls. Missed calls needing follow-up: 1) +1 (555) 234-5678 at 9:14 AM — rang 4 times, no pickup. 2) +1 (555) 876-5432 at 11:02 AM — caller hung up during greeting. 3) +1 (555) 345-6789 at 2:30 PM — voicemail left. 2 bookings made today. Would you like to see the call transcripts or update the agent scripts? ``` **Prompt:** ``` Show me the summary and transcript of the last call handled by the main office agent. ``` **Response:** ``` Last call for 'Main Office Agent' (agent_001): call_5678, duration 3m 42s, caller: +1 (555) 901-2345. AI Summary: Customer called about business hours and pricing for a dental cleaning. The agent confirmed operating hours (Mon-Fri 8AM-6PM, Sat 9AM-2PM) and quoted $120 for a standard cleaning. Customer booked an appointment for Thursday at 10AM. Outcome: booking completed. Transcript available — 14 exchanges between caller and agent. Would you like to read the full transcript or check the FAQ entries? ``` **Prompt:** ``` Show analytics for all my agents this month — answer rates, bookings, and total call volume. ``` **Response:** ``` Monthly analytics: Total calls: 342. Answer rate: 89.5% (306 answered, 36 missed). Bookings: 78 appointments made (25.5% booking conversion). Average call duration: 2m 48s. Peak hours: 10-11 AM (52 calls) and 2-3 PM (41 calls). Agent breakdown: 1) 'Main Office' — 198 calls, 92% answer rate, 45 bookings. 2) 'After Hours' — 89 calls, 85% answer rate, 22 bookings. 3) 'Spanish Line' — 55 calls, 87% answer rate, 11 bookings. Would you like to update agent scripts or review missed calls? ``` ## Capabilities ### Get Agent Details Retrieves specific information and configuration settings for a single AI phone agent. ### List All Agents Retrieves a list of every virtual phone agent configured in the system. ### List All Calls Retrieves a list of all call records, allowing filtering by date or status. ### Get Call Summary Generates a concise summary of a specific call, including key outcomes and topics discussed. ### Get Call Transcript Retrieves the full, raw transcript of a recorded phone conversation. ### List Missed Calls Identifies calls that were missed, abandoned, or rang without answering, prioritizing them for follow-up. ### List Bookings Retrieves a list of appointments or bookings that the AI agent successfully scheduled during a call. ## Use Cases ### Investigating a Sudden Drop in Answer Rates The Ops Manager notices the answer rate dropped last week. They ask their agent to run `get_analytics` filtered by the last 7 days. The agent returns the data, showing which specific agent (e.g., 'After Hours') was responsible. The manager then uses `get_agent` to check that agent's current script and finds a required update, fixing the issue instantly. ### Following Up on a Cold Lead from an Abandoned Call A potential client calls and hangs up. Instead of manually searching call logs, the user prompts for `list_missed_calls`. The agent pulls the record, confirming the time and phone number. The user then uses `get_call` to check the call details and sends a follow-up email based on the context provided by the system. ### Training a New Agent on a Specific Topic A service leader wants to improve the agent's knowledge on product pricing. They run `list_faqs` to see what's missing. They then use `get_agent` to view the current agent's config and use `update_agent` to add the new FAQ entries, instantly improving the agent's performance on that topic. ### Reviewing a Complex Sales Call for Upsell Opportunities A manager needs to review a successful sales call. They ask the agent to find the call ID and run `get_call_summary`. The summary confirms the sale. They then use `get_transcript` to review the conversation details, finding a missed opportunity to upsell a premium service, and update the agent's script accordingly. ## Benefits - Analyze fleet performance instantly. Instead of logging into a dashboard, you simply ask your agent, 'Show me the monthly analytics,' and get total calls, answer rates, and booking conversion data via `get_analytics`. - Never miss a lead again. Use `list_missed_calls` to pull up a prioritized list of abandoned or unanswered calls that need immediate follow-up, saving you manual checking. - Deep dive into conversations. Get the full context by running `get_transcript` or getting a quick overview with `get_call_summary` for any call ID, without switching tabs or loading multiple reports. - Control every agent. Use `list_agents` and `update_agent` to review agent configurations or change a script on the fly. You're managing the whole team from one chat window. - Bookings in bulk. Use `list_bookings` to get a clean list of every appointment the AI agent made, letting you export the data for invoicing or scheduling. - Review all interactions. Run `list_calls` to see a complete history of every call, and then use `list_calls_by_agent` to isolate the records for a specific agent's performance review. ## How It Works The bottom line is: you manage complex phone systems and data analysis using simple conversation prompts. 1. First, subscribe to the Goodcall server and input your API Key into your AI client. 2. Then, prompt your agent to perform a task, like 'Show me all missed calls from yesterday' or 'What was the summary for call ID X'. 3. Finally, your AI client executes the necessary tool calls, and the server returns the structured data (e.g., a list of calls, a booking record, or a summary text) for you to review. ## Frequently Asked Questions **How do I use the `get_call_summary` tool with Goodcall MCP Server?** You call `get_call_summary` and provide the specific call ID. The agent returns a concise, AI-generated summary of the call's main topics and business outcomes. This is faster than reading the whole transcript. **Can I list all my AI agents using the `list_agents` tool?** Yes. Use `list_agents` to get a full list of every virtual agent you run. From there, you can use `get_agent` to check specific settings or update them with `update_agent`. **Which tool should I use to track potential leads that were missed?** Use `list_missed_calls`. This tool specifically identifies calls that were abandoned or rang without pickup, giving you a prioritized list for follow-up. **How does the `get_transcript` tool work?** The `get_transcript` tool pulls the raw, complete text record of the call. This is useful when you need to review every word spoken, not just the key takeaways. **Do I need to use `list_calls_by_agent` instead of `list_calls`?** Use `list_calls` for a general overview of all calls. Use `list_calls_by_agent` when you need to isolate and review the history of calls handled by one specific agent for a focused performance review. **How do I use the `get_analytics` tool to check call performance trends?** You call `get_analytics` to get a full performance breakdown. This tool aggregates metrics like total calls, answer rate, and booking conversion rates across your entire agent fleet. **What information does `list_missed_calls` provide for follow-up?** It lists calls that were missed or abandoned, providing key details for follow-up. You can use this to prioritize leads that need manual attention. **Can I use `list_faqs` to check what knowledge is available for my agents?** Yes, `list_faqs` shows all configured FAQ entries for each agent. Check this list to verify that your AI agents have coverage for all common customer inquiries. **Can I review what my AI phone agent said during a customer call?** Yes. Use `get_transcript` with a Call ID to retrieve the full conversation transcript between the AI agent and the caller. For a quick overview, use `get_call_summary` which provides an AI-generated summary with key topics discussed and the call outcome (e.g., booking made, question answered, callback requested). **Can I track missed calls and see which ones need follow-up?** Yes. The `list_missed_calls` tool retrieves all calls that were missed or abandoned, including caller phone number, timestamp, and any partial interaction data. This helps you prioritize follow-up callbacks and identify peak call times when your agents may be overloaded. **Can I see appointments booked by the AI agent during calls?** Yes. The `list_bookings` tool retrieves all appointments booked by the AI agent during customer calls, including date, time, caller details, and the associated call ID. Use `get_analytics` to track your booking conversion rate — the percentage of calls that result in a scheduled appointment.