BELIEFSTATE Products: [Brief](https://beliefstate.ai/docs/api/brief) [Beliefs](https://beliefstate.ai/docs/api/beliefs) [Tickers](https://beliefstate.ai/docs/api/tickers) [Sources](https://beliefstate.ai/docs/api/sources) Developers: [Documentation](https://docs.beliefstate.ai/introduction) [Connect an AI](https://beliefstate.ai/connect) [Quickstart](https://beliefstate.ai/agent-quickstart.md) [MCP Server](https://beliefstate.ai/mcp) [agents.md](https://beliefstate.ai/agents.md) [OpenAPI Spec](https://beliefstate.ai/openapi.json) [llms.txt](https://beliefstate.ai/llms.txt) Resources: [About](https://beliefstate.ai/about) [FAQ](https://beliefstate.ai/docs/faq) [Pricing and access](https://beliefstate.ai/pricing) [Contact](https://beliefstate.ai/contact) [LOG IN](https://beliefstate.ai/sign-in) [GET ACCESS](https://beliefstate.ai/pricing) # BeliefState for AI agents We read investment research and turn each author’s ideas, reasoning, and risks into knowledge your AI can use. [GET ACCESS](https://beliefstate.ai/pricing) [READ THE DOCS](https://docs.beliefstate.ai/introduction) ## What this is Investor research for AI, delivered through read-only MCP and REST. Base URL: https://beliefstate.ai/v1. Retrieve who made an investment call, their reasoning, what changed, and what could invalidate it. BeliefState does not place trades. ## API endpoints - [Brief](https://beliefstate.ai/docs/api/brief): Get an evidence backed research brief for a ticker. GET /v1/brief. - [Beliefs](https://beliefstate.ai/docs/api/beliefs): Find investor beliefs or inspect a full record. GET /v1/beliefs. - [Tickers](https://beliefstate.ai/docs/api/tickers): Find tickers with available research. GET /v1/tickers. - [Sources](https://beliefstate.ai/docs/api/sources): Find research sources by name, domain, or source ID. GET /v1/sources. MCP tools: get_brief, get_beliefs, and get_tickers. Sources are available through REST. ## Coverage Discover released listed-equity coverage without an API key through GET https://beliefstate.ai/v1/tickers. The free get_tickers MCP tool requires an authenticated MCP connection. Use the ticker from the user's question; missing coverage stays a gap. A covered ticker does not imply complete research or current evidence for every thesis. ## Where the data comes from Attributed investment research, with source links, publication and observation dates, evidence, revisions, and explicit unknowns. Keep an author's view separate from BeliefState's analysis. Market paths describe measured history, not verified investor executions or guaranteed returns. ## Quick start 1. Discover coverage at https://beliefstate.ai/v1/tickers and choose the requested ticker. 2. For a trusted coding agent, follow [Authentication](https://beliefstate.ai/auth.md): start device authorization, let the person authorize and fund access in their browser, then store the issued key securely. Never request passwords, payment details, or API keys in chat. 3. Check funded access at https://beliefstate.ai/v1/status, then request a brief. Replace REQUESTED_TICKER and REQUEST_ID below; reuse the same X-Request-ID only when retrying that logical request. ```bash curl "https://beliefstate.ai/v1/brief?ticker=REQUESTED_TICKER" \ -H "Authorization: Bearer $BELIEFSTATE_API_KEY" \ -H "X-Request-ID: REQUEST_ID" ``` Read source dates, citations, warnings, and coverage gaps before presenting the result. [Full quickstart](https://beliefstate.ai/agent-quickstart.md). ## MCP server URL: https://beliefstate.ai/mcp. Transport: remote Streamable HTTP. Authentication: OAuth for available hosted connections, or a developer API key for trusted integrations. Check [Connect an AI](https://beliefstate.ai/connect) for current client availability before signup or payment. Account creation does not install a provider connector. [MCP setup guide](https://docs.beliefstate.ai/guides/mcp-server). ## Pricing and access Coverage discovery and public documentation are free. Research queries require an available paid request allowance or prepaid credit. [Current plans and access](https://beliefstate.ai/pricing). ## Machine-readable resources - [agents.md](https://beliefstate.ai/agents.md): complete setup, research instructions, and recovery. - [Agent skill](https://beliefstate.ai/skill.md): reusable agent setup instructions. - [OpenAPI Spec](https://beliefstate.ai/openapi.json): request and response contracts. - [llms.txt](https://beliefstate.ai/llms.txt): discovery index; [llms-full.txt](https://beliefstate.ai/llms-full.txt): full documentation corpus. - [Machine sitemap](https://beliefstate.ai/sitemap.md): public page directory. This homepage is [index.md](https://beliefstate.ai/index.md). ## Company and policies - [Privacy](https://beliefstate.ai/privacy) - [Terms](https://beliefstate.ai/terms) - [Research disclosures](https://beliefstate.ai/disclosures)