---
ref: tool:gong/ask-about-deal
name: Ask about a deal
company: company:gong
workflows: []
access: [mcp, api]
tags: [capability:research-accounts, category:revenue-intelligence, has:api, has:mcp]
docs: https://gong.app.gong.io/settings/api/documentation#get-/v2/entities/ask-entity
updated: 2026-09-27
---

# Ask about a deal

Answers one plain-language question about a CRM deal, such as what is blocking it or which next steps were agreed, from the calls and emails linked to it.

Note: Each answer spends Gong credits by the amount analyzed and draws on at most 60 calls and 500 emails. Over the API, pass the deal's CRM ID as `crmEntityId` with a `workspaceId`; for several topics, generate a brief instead.

## Set up

Use the first option your agent supports.

### MCP (official, remote)

Add this server to your agent's MCP settings, then sign in when asked.

```json
{ "mcpServers": { "gong": { "url": "https://mcp.gong.io/mcp" } } }
```

Call the MCP tool `ask_deal`.

Server URL: https://mcp.gong.io/mcp

Note: A Gong tech admin registers the MCP integration first. It is read-only, and every answer spends Gong credits.

### API (official)

- Base URL: https://{company}.api.gong.io
- Endpoint: `GET /v2/entities/ask-entity`
- Auth: send the header `Authorization: Basic $GONG_API_KEY`
- Get a key: https://app.gong.io/company/api
- Docs: https://help.gong.io/apidocs/introduction-2

Note: `{company}` is your API host prefix from Gong's API settings, as in `company-17.api.gong.io`. `GONG_API_KEY` holds the base64 of `<access key>:<secret>`; 3 calls a second, 10,000 a day.

Before anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
- Never print API keys.