---
ref: tool:typeform/aggregate-responses
name: Aggregate responses
company: company:typeform
workflows: []
access: [mcp]
tags: [capability:collect-responses, category:forms, has:mcp]
docs: https://www.typeform.com/developers/mcp/tools/
updated: 2026-09-27
---

# Aggregate responses

Returns counts, averages, sums or NPS for one field of a form's responses or for all of them.

Note: Call `insights-public_discover` first for the form's queryable fields and measures: field IDs differ per form.

## 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": { "typeform": { "url": "https://api.typeform.com/mcp" } } }
```

Call the MCP tool `insights-public_aggregate`.

Server URL: https://api.typeform.com/mcp

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.