MCP Events Tools (Beta)

Events tools let MCP clients discover Events and their relationships to Entities and Insights before building a framework.

MCP Events tools in the client tool list, including Search Events and Get Insights from Event

Workflow

Use the Events tools to discover an Event, then pass the resulting identifiers into framework_to_insight or build_framework.

search_events
      │
      ├── get_insights_from_event
      ├── get_entities_from_event
      │
search_entities ── get_events_from_entity
search_insights ── get_events_from_insight
      │
framework_to_insight / build_framework

Pass Events into execution using:

events: [
  {
    "event_type": "...",
    "event_id": "...",
    "event_category_id": "..."
  }
]

event_type is required. Include either event_id, event_category_id, or both.

Tools

`search_events`

Find an Event by name or description.

Parameters

Parameter	Required	Description
`query`	Yes	Event name or description
`event_type`	No	Filter by Event Type
`limit`	No	Defaults to 10

Returns

Event ID
Event label
Event type
Event category ID (when available)

`get_insights_from_event`

Return Insights linked to an Event.

Parameters

Parameter	Required
`event_id`	Yes
`event_type`	Yes
`limit`	No

`get_entities_from_event`

Return Entities linked to an Event.

Parameters

Parameter	Required
`event_id`	Yes
`event_type`	Yes
`entity_representation`	No
`limit`	No

`get_events_from_entity`

Return Events linked to an Entity.

Parameters

Parameter	Required
`entity_id`	Yes
`entity_representation`	Yes
`event_type`	No
`limit`	No

If you only have an entity name, call search_entities first.

`get_events_from_insight`

Return Events linked to an Insight.

Parameters

Parameter	Required
`insight_id`	Yes
`event_type`	No
`limit`	No

If you only have a keyword, call search_insights first.

Executing Frameworks

After discovery, pass the selected Event into:

framework_to_insight
build_framework

Each Event must include:

event_type
event_id or event_category_id

Events follow the same execution and billing model as Entity and Insight frameworks.

Example

search_events("Earnings Release")

↓

get_insights_from_event(...)

↓

framework_to_insight(
  events=[...],
  insights=[...],
  entities=[...]
)

Choosing the Right Tool

Goal	Tool
Find an Event	`search_events`
Find Insights for an Event	`get_insights_from_event`
Find Entities for an Event	`get_entities_from_event`
Find Events for an Entity	`get_events_from_entity`
Find Events for an Insight	`get_events_from_insight`
Find a company	`search_entities`