---
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.

Call `insights-public_discover` first: it returns the form's queryable
fields and measures, and field IDs differ per form. Filters cover answers,
hidden fields, tags and response type. For rankings use
`insights-public_toplist`; for trends over time, `insights-public_timeseries`.

## 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 doing anything else, make one read-only call to confirm access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data.
- Never print API keys.