Who can use this: Tech admin
Available on: Any Gong plan
The Gong MCP server exposes tools that external AI agents use to find calls, read call transcripts, and get AI-generated insights from Gong data. Each section describes what a tool does, when the external AI agent uses it, and when another tool is a better fit.
Learn more about the Gong MCP server.
Include sources
The ask_account, ask_deal, generate_brief, and research_conversations tools have an includeSources parameter which by default is set to false. When true, the tools return a link to the calls and emails used to generate the answer. This toggle is turned on automatically when the prompt includes a request to return the sources used to generate the answer. When false, only the text is returned.
The research_conversations tool returns excerpts from the calls and emails, with the call ID of each call.
ask_account
The ask_account tool answers a specific question about a single account.
It uses AI to analyze Gong activities linked to the account and returns a focused, natural-language response. The response highlights patterns such as objections, risks, stakeholder concerns, and competitive mentions based on recent interactions.
Use this tool when the external AI agent needs a targeted insight about an account. This includes scenarios such as understanding customer concerns, identifying risks, or preparing for an account review.
This tool works best when the external AI agent asks a concise, insight-oriented question. It returns a single synthesized answer and does not provide raw activity data.
Do not use this tool for broad summaries or multi-topic overviews. When a structured summary across multiple categories is required, use the generate_brief tool.
ask_deal
The ask_deal tool answers natural language questions about a single CRM deal.
It uses AI to analyze calls and emails linked to the deal and returns a focused, natural-language response. The response highlights patterns such as deal blockers, stakeholder concerns, risks, and agreed next steps based on recent interactions.
Use this tool when the external AI agent needs a targeted insight about a deal. This includes scenarios such as understanding what is preventing a deal from closing, tracking deal progress, or reviewing recent commitments.
This tool works best when the external AI agent asks a concise, insight-oriented question. It returns a single synthesized answer and does not provide raw activity data.
Do not use this tool for structured summaries or multi-topic overviews. When a broader, multi-category view of the deal is required, use the generate_brief tool.
generate_brief
The generate_brief tool generates structured summaries for CRM accounts, deals, or contacts.
It uses AI to analyze calls and emails linked to the account or deal and returns a comprehensive summary organized into predefined categories such as key themes, stakeholders, risks, and next steps.
Note:
For contacts, the external AI agent must provide the CRM contact ID. For accounts and deals, it can look them up by name.
Use this tool when the external AI agent needs a broad overview rather than a single answer. This includes scenarios such as account reviews, deal reviews, executive briefings, or handoffs.
This tool works best when a structured summary across multiple topics is required. It returns a single, organized output based on a predefined brief and does not accept a question.
Do not use this tool when the external AI agent needs a specific answer to a specific question. For targeted insights, use the ask_account or ask_deal tools.
search_conversations
search_conversations finds calls in a single workspace by call title, participants, linked account or deal, date range, internal or external, duration, or call direction. It can also look up calls by call ID.
It returns a page of matching calls, each with its call ID, title, start time, duration, direction, host, participants, and linked accounts and deals. Without a date range, it searches the last 30 days. It does not return what was said on the calls, and it does not use AI.
Use this tool when the external AI agent needs to find calls or tell them apart, for example before it reads a single call with the get_transcript tool. It is available only for integrations with personal access.
Do not use this tool to find out what was discussed on calls. For that, use the research_conversations tool, or the get_transcript tool for a single call. The tool searches calls only. For questions about emails, use the research_conversations tool.
get_transcript
get_transcript returns the transcript of a single call, one page at a time, and the external AI agent requests the next page until it has what it needs. Each page shows who said what, with timestamps and topics. The first page also includes:
The call title
The start time in UTC, the duration, whether the call was inbound, outbound, or a conference, and whether it was internal or external
The name of the workspace
The CRM accounts and deals linked to the call, with their CRM IDs
The participants who speak, with their email address, company, job title, and pronoun when Gong has them
A speaker appears by first name, or by full name when two speakers share a first name. A speaker Gong cannot identify appears as Speaker followed by a number, and a speaker Gong cannot match to a participant appears as Unknown speaker. The tool returns the transcript verbatim and adds no AI analysis. Content that is redacted in Gong stays redacted.
Use this tool when the external AI agent needs the exact words of a single call, such as a quote or the detail of a technical or legal discussion. A team member can identify the call by its title, participants, linked account or deal, or date, or paste a Gong call link. When the external AI agent needs to find the call first, it gets the call ID from the search_conversations tool. It is available only for integrations with personal access.
Do not use this tool for analysis across several calls. Use the research_conversations tool instead.
research_conversations
research_conversations answers a question about the calls and emails in a single workspace. Gong breaks the question down, finds the relevant calls and emails, analyzes them with AI, and returns a written answer.
The external AI agent can limit the research to specific accounts, deals, or people. Without a date range in the question, the tool searches the last 30 days.
Use this tool when the external AI agent needs an answer from many calls and emails, such as what customers are saying about a topic. It works best with one question per request. A request can take up to 120 seconds. It is available only for integrations with personal access.
Do not use this tool to list calls or to get the exact words of a single call. For those, use the search_conversations or get_transcript tool.
get_session_context, search_crm_entities, and search_person_entities
The external AI agent uses these tools to get the IDs that the other tools need. get_session_context returns the workspaces the team member can access, search_crm_entities finds accounts and deals by name, and search_person_entities finds people by name. The external AI agent calls them on its own, for example to find the workspace and the account before it searches for calls.
These tools do not use AI. search_crm_entities and search_person_entities are available only for integrations with personal access. get_session_context is available for both personal and shared access.