Brief shape

The brief is your account’s editorial policy — the include/exclude document that drives matching. One brief per account. update_brief replaces it wholesale; get_brief returns it under brief. All fields are optional — an empty group means “no restriction”.

The brief is an MCP-only concept. It drives matching_events, matching_orgs, evaluate_*, and the seed_* tools.

A representative shape

{
  "summary": "Family-friendly community events, live music, museum programs, and outdoor festivals for all ages in Vermont",
  "standards": {
    "ageBands": ["kids", "teens", "all_ages"],
    "audienceTypes": ["families", "children_with_adult"],
    "commercialIntent": ["programmed_event"],
    "religiousContent": ["none"],
    "accessRestrictions": ["registration_required", "ticket_required"],
    "eventCategories": ["live_music", "outdoors", "family_friendly", "educational"],
    "programmingNature": ["performance", "class_or_workshop"],
    "deliveryHorizonDays": 60,
    "sourceDeny": ["example-spam.com"]
  },
  "eventKinds": { "include": ["festival", "concert", "museum_program"], "exclude": ["adult_only"] },
  "geography": { "zipCode": "05201", "radiusMiles": 50 },
  "excludePhrases": ["21+"]
}

summary / eventKinds.include — the semantic query text: matching embeds these and ranks events by similarity.
standards.* — closed-vocabulary facet filters (the enabled values allowed through). A facet is only restrictive when non-empty; events missing a facet are never dropped (fail-open). deliveryHorizonDays sets the freshness window.
geography — a hard geo gate (zip + radius).
excludePhrases / standards.sourceDeny — deterministic exclude rules (title phrase / source domain).

You can author this by hand (update_brief), or let seed_brief infer it from an aggregator. The standards.* facets are closed vocabularies — matching only recognizes the exact ids below. Values outside these lists are silently ignored (the facet gate is fail-open, so a typo doesn’t error — it just never filters). Author briefs using only these ids.

Brief field	Kind	Allowed values
`ageBands`	single per event	`general`, `babies`, `toddlers`, `kinder`, `kids`, `tweens`, `teens`, `all_ages`
`commercialIntent`	single	`programmed_event`, `promotion_only`, `unknown`
`religiousContent`	single	`worship_or_service`, `faith_related_non_service`, `none`, `unknown`
`programmingNature`	single	`performance`, `class_or_workshop`, `social_gathering`, `meeting`, `exhibit`, `market_or_sale`, `fundraiser`, `other`
`accessRestrictions`	multi per event	`registration_required`, `ticket_required`, `members_only`, `students_only`, `age_restricted`, `invite_only`
`audienceTypes`	multi	`families`, `children_with_adult`, `adults`, `seniors`, `students`, `professionals`
`eventCategories`	multi	`live_music`, `food_drink`, `performing_arts`, `outdoors`, `family_friendly`, `educational`, `fundraiser`

Facet classification and vector embedding run asynchronously after an index_org crawl completes. A just-indexed org’s events are searchable immediately via search/search_business_events, but matching/seeding (which rely on facets + embeddings) may see nothing for that org until enrichment finishes. Retry after a short delay.

Get started

Core concepts

A representative shape

Facet vocabularies (closed)

​A representative shape

​Facet vocabularies (closed)

A representative shape

Facet vocabularies (closed)