get_event_summary

This page documents the Python MCP surface (mcp.heybtw.com). It reflects mcp-server/tools/event_summary.py as of this page’s publication — see Schema stability. If your integration expected a tool named get_event_details, this is it — see the naming note below.

Naming note. Some earlier internal drafts referred to this capability as get_event_details. The shipped, registered tool name is get_event_summary — use that name. There is no separate get_event_details tool on this surface.

Purpose

get_event_summary is the single-event deep dive: attendance broken into host/partner/external, seniority distribution, per-partner sourcing performance, top engaged accounts, how this event compares to the workspace’s own program average, and (when HubSpot is connected) pipeline attribution for this one event.

When to use this

“Give me a report on last month’s Robotics Summit.”
Immediately after an event, to compare it against program_comparison and decide whether to repeat the format.
Before get_invite_recommendations for a similar upcoming event, to see who attended last time.

Parameters

Name	Type	Required	Default	Description	Example
`channel_id`	string	Yes	—	The event’s channel id. No default — omitting it raises an error (see Errors).	`"chn_88af1"`
`include_contacts`	boolean	No	`false`	Include the full attendee contact list. Adds `contacts`/`contacts_total`/`contacts_shown`/`contacts_raw_total` to the response.	`true`
`include_partner_breakdown`	boolean	No	`false`	Include per-partner sourcing performance (`partner_performance`).	`true`

Default behavior

Given only channel_id, returns the full attendance/funnel/seniority/top-accounts/comparison report without the attendee-level contact list and without the partner performance breakdown — both are opt-in via their respective flags, keeping the default response smaller for the common “just show me the numbers” case.

Sample request

{
  "tool": "get_event_summary",
  "arguments": { "channel_id": "chn_88af1", "include_partner_breakdown": true }
}

Sample response

{
  "tool": "get_event_summary",
  "query_time_ms": 96.7,
  "result_count": 1,
  "data": [
    {
      "event_name": "Robotics Summit SF 2026",
      "channel_id": "chn_88af1",
      "event_date": "2026-06-18T00:00:00+00:00",
      "event_context": {
        "location": "San Francisco, CA",
        "format": "in_person",
        "timezone": "America/Los_Angeles",
        "capacity": 250,
        "meeting_url": null,
        "visibility": "public"
      },
      "attendance": {
        "total": 210,
        "breakdown": { "host": 12, "partner": 68, "external": 130 }
      },
      "funnel": {
        "mql_count": 34,
        "opportunity_count": 9,
        "meeting_count": 14,
        "conversion_rate": 0.1619
      },
      "seniority_distribution": {
        "executive": 18,
        "director_plus": 47,
        "manager": 62,
        "individual_contributor": 71,
        "unknown": 12
      },
      "partner_performance": [
        {
          "partner_name": "Northwind Ventures",
          "sourced_count": 22,
          "mql_count": 6,
          "conversion_rate": 0.2727
        }
      ],
      "top_accounts": [
        {
          "domain": "lighthouserobotics.example",
          "company": "Lighthouse Robotics",
          "attendee_count": 3,
          "mql": true,
          "opportunity": true
        }
      ],
      "program_comparison": {
        "vs_program_avg_signups": 1.34,
        "vs_program_avg_mql": 1.12
      },
      "pipeline": {
        "crm_enriched": true,
        "sourced_revenue": 38000.0,
        "won_revenue": 0.0,
        "company_count": 4
      }
    }
  ],
  "metadata": {
    "data_sources_queried": ["Channel", "EventSignUp", "Partner", "EventAttributionOpportunity"],
    "date_range_applied": null,
    "filters_applied": {
      "channel_id": "chn_88af1",
      "include_contacts": false,
      "include_partner_breakdown": true,
      "crm_enriched": true
    },
    "coverage_note": null
  }
}

Response field reference

Envelope

Field	Type	Description
`tool`	string	Always `"get_event_summary"`.
`result_count`	integer	Always `1` on success.
`data`	array (length 1)	The event report object.

`data[0]`

Field	Type	Description
`event_name` / `channel_id` / `event_date`	string	Event identity.
`event_context`	object	`{ location, format, timezone, capacity, meeting_url, visibility }`. `format` is derived: `"hybrid"` (has both location and meeting URL), `"virtual"` (meeting URL only), `"in_person"` (location only), `"unknown"` (neither).
`attendance.total`	integer	Total attendees.
`attendance.breakdown`	object	`{ host, partner, external }` counts — classified per attendee by email domain against the workspace’s own domain and its partners’ domains.
`funnel`	object	`{ mql_count, opportunity_count, meeting_count, conversion_rate }`. `conversion_rate` = `mql_count / attendance.total`.
`seniority_distribution`	object	Attendee count per tier: `executive`, `director_plus`, `manager`, `individual_contributor`, `unknown`.
`partner_performance`	array \| `[]` when not requested	`{ partner_name, sourced_count, mql_count, conversion_rate }` per partner, sorted by `sourced_count` descending. Only populated when `include_partner_breakdown: true` — otherwise always `[]`, not omitted.
`top_accounts`	array (up to 10)	External domains ranked by opportunity → MQL → attendee count: `{ domain, company, attendee_count, mql, opportunity }`. Excludes the workspace’s own domain.
`program_comparison.vs_program_avg_signups` / `.vs_program_avg_mql`	number \| null	This event’s count ÷ the workspace’s own historical average across all its events. `null` when the workspace average is `0` (e.g. this is the first event). A value of `1.34` means “34% above average.”
`pipeline`	object \| omitted	Present only when CRM is connected and the attribution resolver returned matching data for this channel. Same shape as `get_event_attribution`’s per-event `pipeline` block.
`crm_enriched`	boolean, only present when `pipeline` is absent	`false`, explaining why there’s no `pipeline` block. When `pipeline` IS present, this top-level `crm_enriched` key does not appear — check for `pipeline`’s presence first, not this flag.
`contacts`	array, present iff `include_contacts: true`	Up to 200 deduplicated contacts: `{ email, name, title, company, context, seniority, funnel_status }`. `context` ∈ `"host"` \| `"partner"` \| `"external"`.
`contacts_total` / `contacts_shown`	integer, present iff `include_contacts: true`	`contacts_shown` capped at 200.
`contacts_raw_total`	integer, present iff `include_contacts: true`	Pre-dedup attendee count — useful to see how much deduplication happened.

Errors

channel_id refers to a nonexistent or out-of-workspace channel. The tool raises ValueError(f"Channel {channel_id!r} not found in workspace {workspace_id!r}") internally, but like every tool on this surface, that specific message does not reach the client — it’s caught by the generic handler and surfaces as RuntimeError: Internal error executing get_event_summary (error_id=...). There is currently no way for an agent to distinguish “channel not found” from any other internal failure from the error message alone.
channel_id omitted entirely. Same generic error — see get_workspace_overview — Errors.

Pagination and limits

Not applicable to the report itself — one event in, one report out. contacts (when requested via include_contacts) is capped at 200 with no further pagination; use contacts_raw_total/contacts_total to know if you’re seeing everyone.

get_event_attribution — the same event’s pipeline numbers in the multi-event comparison shape, plus sourced/influenced breakdown by company.
get_partner_insights — a given partner’s performance across all events, not just this one.
get_invite_recommendations — who to invite to a similar future event.

Getting Started

Connecting Your Platforms

MCP Tool Reference

Features

Partner Ecosystem

If You've Been Invited

Concepts

Frequently Asked Questions

get_event_summary

Purpose

When to use this

Parameters

Default behavior

Sample request

Sample response

Response field reference

Envelope

`data[0]`

Errors

​Purpose

​When to use this

​Parameters

​Default behavior

​Sample request

​Sample response

​Response field reference

​Envelope

​data[0]

​Errors

​Pagination and limits

​Related tools

Purpose

When to use this

Parameters

Default behavior

Sample request

Sample response

Response field reference

Envelope

`data[0]`

Errors

Pagination and limits

Related tools