Skip to main content
BeliefState brings investor ideas to your AI. BeliefState is a read-only intelligence API for researching what investors believed, when they believed it, and what evidence supported each view. Query it through MCP or REST. For account MCP, start with free get_account_status to check allowance or get_research_sample to inspect a fixed cited case. Account MCP advertises 25 tools: 23 research and discovery tools plus those two account utilities. Wallet MCP exposes the 23 research tools: 20 paid and free get_tickers, get_companies and get_news. Compare connection paths.

​
Research tools with x402

Use twenty paid accountless research tools through HTTP or native MCP at https://beliefstate.ai/v1/research/mcp. Eighteen data tools cost 0.02 USDC per call on Base; built-in comparison costs 0.50 USDC and search 1.50 USDC. Read full cases, current/historical briefs, risks, catalysts, changes, author track records, relationships, scenarios and stored visual data. Check released coverage and the live tool catalog, then follow the x402 quickstart to approve a quote, save the exact signed request and verify its receipt. Agents can buy the underlying cases for 0.02 USDC and use their own models. Coverage gaps and unknowns remain explicit. The account-based MCP and REST paths below support ongoing research, search, and record detail.

​
Get started

​
Configure a coding client with an API key

You can also use an API key with an HTTP MCP client. Create a key, then set BELIEFSTATE_API_KEY in the client’s environment.
Run in your terminal:
Open Codex’s MCP tools and confirm get_brief, get_cases, and get_tickers appear.
Using another HTTP MCP client with an API key? Point it at https://beliefstate.ai/mcp and send the key as a Bearer token. See the full MCP guide.

​
Other ways to connect

Choose how you want to connect.

Connect an AI

Sign in from a supported AI client to query released research.

Use REST

Make a request from trusted code with a Bearer key.

Check coverage

See released tickers and coverage limits before you query.
Check client availability for ChatGPT and Claude. Directory presence and new-connection availability can differ; check the current setup action before paying.

​
Build directly with the API

Check released ticker coverage without an API key:
Continue to the REST quickstart for authenticated requests and response handling.

​
Explore the API

API reference

Review released endpoints, parameters, and response fields.

OpenAPI spec

Generate types or a client from the published contract.

​
What can BeliefState do?

​
Inspect a belief

Read an investor’s thesis, confidence when known, catalysts, risks, invalidations, and cited evidence. Review the belief endpoints.

​
Track revisions and outcomes

Compare belief changes over time and inspect outcomes where the underlying record supports them. Observation time and publication time remain distinct. Learn about point-in-time queries.

​
Check coverage and provenance

Research-source profiles describe coverage and eligibility. Derived sources do not prove the investor’s exact wording or original publication. Read the provenance guide and coverage guide.

​
Resources

Keep citations, warnings, data mode, pagination, explicit unknowns, and methodology versions with downstream results. REST API version: v1. See API versioning, the changelog, or contact support. Last verified: 2026-11-08 against the live OpenAPI contract (2026-11-08) and direct MCP discovery. REST API version: v1.