> ## 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_catalysts

> Get case catalysts

**Get case catalysts** · \$0.02 per call (x402, USDC)

Retrieves evidence-linked catalysts for one company, research subject, investment case or the explicitly selected released corpus. Returns recorded conditions, lifecycle status, dates and supporting evidence. Useful for checking which thesis events remain pending, were met or missed, or have been superseded. Filter by investor, source, publication dates or status. Unassessed conditions retain unknown status. Continue with the returned cursor and unchanged 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_catalysts` at `https://beliefstate.ai/mcp` (account access) or `https://beliefstate.ai/v1/research/mcp` (wallet access). See [MCP integration](https://docs.beliefstate.ai/guides/mcp-server.md).
* **x402 HTTP:** `POST https://beliefstate.ai/v1/research/get_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={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_catalysts",
    "arguments": {
      "ticker": "NBIS",
      "limit": 5
    }
  }
}
```

### x402 HTTP

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
curl --request POST \
  --url 'https://beliefstate.ai/v1/research/get_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)

*Contract version: 2026-11-08. Input parameters and tool metadata come from the
shared executable catalog. REST API version: v1.*


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