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

# Data model

> The objects Beacon publishes, the values on each one, and the doors every value is available through.

Beacon publishes one object per grain. Every value on an object carries a name, a type, a method, an audience ceiling, and an availability mark for each door it can travel through.

<Note>
  The shapes on these pages are fixed. No read interface or MCP tool serves them yet.
</Note>

## Objects

| Object                         | Grain                               | Values | State                         |
| ------------------------------ | ----------------------------------- | ------ | ----------------------------- |
| [Account](/data-model/account) | One row per customer account        | 15     | Shape fixed, not yet callable |
| [Deal](/data-model/deal)       | One row per opportunity             | 7      | Shape fixed, not yet callable |
| Segment and cohort             | One row per segment, one per cohort | —      | Not yet published             |
| Company and period             | One row per company per period      | —      | Not yet published             |

## Doors

A value reaches you through up to four doors. Three carry values today.

| Door           | What it is                                           | Name form                                                         |
| -------------- | ---------------------------------------------------- | ----------------------------------------------------------------- |
| Read interface | An HTTP request against Beacon                       | `health_score`                                                    |
| MCP tools      | A tool call from an agent or assistant               | `health_score`                                                    |
| CRM property   | A property Beacon writes onto the record in your CRM | `beacon_health_score`                                             |
| Events         | A message published to your software                 | No value is published on this door, and no event catalogue exists |

## Naming

The `beacon_` prefix marks a value written into a tool Beacon does not own. Inside Beacon's own model the name is bare. One value carries both spellings, applied by the door and never stored twice.

## Method

Two words describe how a value is produced.

* **Measured** — computed by a fixed formula. The same inputs return the same value.
* **Modelled** — a composite. A modelled value lands in a tool Beacon does not own as a band, never as a point number.

## Availability

| Mark | Meaning                                                                 |
| ---- | ----------------------------------------------------------------------- |
| ✓    | Available by default                                                    |
| ⊕    | Available after an opt-in that states who becomes able to see the value |
| —    | Not available                                                           |

Financial values are available by default on the read interface and MCP tools under a reader grant, and off by default on the CRM door. A property written into your CRM leaves Beacon's access log: the tool's own permissions govern who reads it from that point, and Beacon can no longer record who read it.

## Audience ceiling

Every value carries one of three ceilings — `operational`, `leadership-only`, `board-grade`. Above `operational` the CRM door is off by default and switching it on requires the opt-in above. The ceiling is not a block.

## Constraints

* `as_of` accompanies every value on every door.
* Raw user-event data never leaves Beacon on any door. Usage is published at account grain only, as `usage_trend`, `active_users` and `last_active_date`.
* A published name is permanent. A rename ships as a redirect, and a value is deprecated in the next version rather than removed from a published one.

## Related

<Columns cols={3}>
  <Card title="Account object" href="/data-model/account">
    The sixteen values on an account.
  </Card>

  <Card title="Deal object" href="/data-model/deal">
    The seven values on a deal.
  </Card>

  <Card title="Connector catalogue" href="/connector-catalogue">
    Every source Beacon reads.
  </Card>

  <Card title="Definitions" href="/definitions/overview">
    What each figure means.
  </Card>
</Columns>