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

# get_belief_catalysts

> Read structured catalysts

**Read structured catalysts** · \$0.02 per call (x402, USDC)

Read evidence-linked Catalyst objects with qualified current status or explicit unknowns. Filter one ticker, entity, Belief or released corpus by person, source, publication dates or status. Current briefs include pending and unassessed attached catalysts; met, missed and superseded records remain available here. Follow signed pagination with identical filters.

## Input parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `ticker` | string | No | min length 1; max length 32 |
| `entity_id` | string | No | |
| `belief_id` | string | No | |
| `corpus` | string | No | |
| `person_id` | string | No | |
| `source_id` | string | No | |
| `object_status` | string | No | |
| `published_from` | string | No | |
| `published_through` | string | No | |
| `as_of` | string | No | |
| `limit` | integer | No | min 1; max 50 |
| `cursor` | string | No | max length 4096 |

## Transports

* **MCP:** `tools/call` with name `get_belief_catalysts` at `https://beliefstate.ai/mcp` (account access) or the wallet-paid x402 MCP server. See [MCP integration](https://docs.beliefstate.ai/guides/mcp-server.md).
* **x402 HTTP:** `POST https://beliefstate.ai/v1/research/get_belief_catalysts` with the arguments as a JSON body. An unpaid request returns an HTTP 402 payment quote.
* **Related REST resource:** [`GET /v1/beliefs`](https://docs.beliefstate.ai/api-reference/beliefs/find-investor-beliefs-or-inspect-a-full-record).

## Example request

### MCP

```json theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_belief_catalysts",
    "arguments": {
      "ticker": "NBIS",
      "limit": 5
    }
  }
}
```

### x402 HTTP

```bash theme={null}
curl --request POST \
  --url 'https://beliefstate.ai/v1/research/get_belief_catalysts' \
  --header 'Content-Type: application/json' \
  --data '{"ticker":"NBIS","limit":5}'
```

The example shows request shape only. Identifiers are placeholders, not records.

## Related

* [All research tools](https://docs.beliefstate.ai/tools/index.md)
* [API reference: GET /v1/beliefs](https://docs.beliefstate.ai/api-reference/beliefs/find-investor-beliefs-or-inspect-a-full-record.md)


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