> ## Documentation Index
> Fetch the complete documentation index at: https://docs.momentra.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Brief shape

> The editorial policy document that drives MCP brief-driven matching.

The **brief** is your account's editorial policy — the include/exclude document
that drives [matching](/mcp/tools#matching-brief-driven-discovery). 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".

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

## A representative shape

```json theme={null}
{
  "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.

## Facet vocabularies (closed)

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

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.