# BeliefState (slim)

> BeliefState is a hosted research API and MCP server of attributed investor theses on US stocks, with reasoning, dated evidence, price targets, risks and revisions. Agents pay per call in USDC by x402, or use an account key or OAuth.

- Full: https://www.anchorterminal.com/tools/beliefstate.md (~6,850 tokens) · this version ~1,630 tokens · JSON https://www.anchorterminal.com/tools/beliefstate.json · canonical https://www.anchorterminal.com/tools/beliefstate
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · MCP: https://www.anchorterminal.com/mcp · Updated: 2026-11-16 · pricing https://www.anchorterminal.com/tools/beliefstate#pricing · reviews https://www.anchorterminal.com/tools/beliefstate#reviews
- Licence: CC BY 4.0, credit Anchor Terminal and link this page (https://www.anchorterminal.com/terms/#data)

**C · 61.1/100 · rank #726 of 1526 · #4 in Financial market data · not agent-ready · confidence medium**


Assessment: Agents can buy cited investor theses, price targets, risks and revisions per call by x402 with no account, at published USDC prices, or connect by OAuth or a read-only key. Sources and their rights aren't public, there is no status page or rate-limit figure, and docs pages disagree on tool counts.

## Facts

- Kind: HTTP API · vendor: BeliefState · category: Financial market data · legal entity: BELIEFSTATE LLC · provenance 68/100
- Endpoint: `https://beliefstate.ai/v1/research/mcp` (Streamable HTTP)
- Auth: API key · pricing: Pay per use · x402: yes, from $0.02/call · licence: unknown
- Benchmark probes: not run yet, so Performance is pending
- Live, from our pollers (not part of the score): up at 2026-11-16 05:37 UTC · uptime 30 days 100.0% (102 probes) · p50 338 ms · p95 1.6 s over 24 hours
- Surface listed: The x402 research routes and wallet MCP server, the account MCP server and the REST API at beliefstate.ai/v1, read from docs.beliefstate.ai, agents.md, the agent quickstart, auth.md, index.md, llms.txt, the OpenAPI file and the MCP registry on 15 November 2026. robots.txt closes `/v1/` and `/mcp`, so no request to them is used here; earlier readings of the catalogue and the wallet server's tool list on the same day were made before robots.txt was read and are struck
- What it returns: For a US ticker, ETF or research subject: investor theses with the investor, reasoning, evidence, price targets, catalysts, risks, conditions, revisions and outcomes, plus company facts, insider trades, institutional holdings, short and options activity, economic calendar and SEC filing news
- Coverage: Not a fixed universe. The coverage page says a ticker or source appears only after source authorisation, extraction, validation and release, and can be absent or partial. Free discovery tools report what is released
- Changes: Dated changelog from 3 September 2026. On 9 September eleven standalone routes were retired without aliases for four resources. On 8 November the catalogue moved to 23 canonical tool names, with old names still accepted
- Advice: The terms say it is research data, not personalised investment advice. The pricing page also announces a coming research membership with one featured stock pick a week by email
- Legal entity: BELIEFSTATE LLC, a Wyoming limited liability company formed 8 October 2026 (filing ID 2026-002101865), per the terms and contact pages
- Prices: Data tool call (x402) $0.02 per call; Thesis search (x402) $1.50 per call; Starter plan $19 per month (plan)

- Scores: Reliability 20, Performance pending, Schema & documentation 86, Agent ergonomics 67, Security & auth 59, Payments & pricing 84, Task success pending, Maintenance & community 78, Transparency & trust 52 · total over the 7 assessed categories
- Why: Reliability, Read with the hosted lines. · Schema & documentation, OpenAPI 3.1.0 with 48 operations, request and response schemas, and an x402 security scheme. · Agent ergonomics, 23 wallet tools and 26 account tools, in the 11 to 30 band (15). · Security & auth, OAuth browser sign-in for account MCP with one revocable grant per client, and revocable read-only workspace keys made through device author… · Payments & pricing, x402 v2 on the vendor's own domain for all 20 paid research tools, over HTTP and the wallet MCP server; `/v1/beliefs` and `/v1/sources` need… · Maintenance & community, Read as a closed service. · Transparency & trust, The editorial half.
- Sources: 14, open questions: 5, both in the full twin
- Capabilities: market.fundamentals, market.filings, market.news, data.markets
- JSON: https://www.anchorterminal.com/api/v1/tools/beliefstate.json
- Its vendor verifies the listing with `verify_listing` or `POST https://www.anchorterminal.com/api/v1/verify` (the full twin says how); no effect on the grade.
- Support: support@beliefstate.ai; https://docs.beliefstate.ai/introduction; https://docs.beliefstate.ai/reference/faq; https://beliefstate.ai/contact; more in the full twin

## Before you call it

1. Check coverage first with the free `get_tickers` or `get_companies`; an absent ticker means unreleased, not unknown
2. Show the x402 quote to the user and keep the exact URL, body and signature; on 503 `payment_pending` retry those, never pay again
3. Start a company with `get_brief`, then open cases with `get_case`; `get_search_results` costs 1.50 USDC a call
4. Keep each record's publication date and first-seen date apart, and read `source_text_coverage` before treating a source as complete
5. Don't use the device-flow API key inside a hosted chat; use OAuth there

## Connect

```bash
curl "https://beliefstate.ai/v1/tickers?q=AVGO"
```

```bash
claude mcp add --transport http --scope project beliefstate https://beliefstate.ai/mcp --header 'Authorization: Bearer ${BELIEFSTATE_API_KEY}'
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/beliefstate

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Twelve Data | BB | 71.9 | market.fundamentals, market.news, market.filings, data.markets | https://www.anchorterminal.com/tools/twelve-data.min.md |
| EODHD | C | 61.1 | market.fundamentals, market.filings, market.news, data.markets | https://www.anchorterminal.com/tools/eodhd.min.md |
| Financial Datasets | C | 61.1 | market.fundamentals, market.filings, market.news, data.markets | https://www.anchorterminal.com/tools/financial-datasets.min.md |
| Intrinio | C | 55.4 | market.fundamentals, market.filings, market.news, data.markets | https://www.anchorterminal.com/tools/intrinio.min.md |
| Financial Modeling Prep | D | 50.6 | market.fundamentals, market.filings, market.news, data.markets | https://www.anchorterminal.com/tools/financial-modeling-prep.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)

