# BeliefState > Evidence-first investor research for agents, with dated theses, risks, catalysts and citations. Use accountless x402 HTTP or native MCP, or account-based research access. - [Introduction](https://docs.beliefstate.ai/introduction.md): Attributed investor research for AI agents: theses, catalysts, risks and dated citations. Use x402 HTTP or native MCP for data calls at 0.02 USDC, comparison at 0.50 and search at 1.50. - [Quick start](https://docs.beliefstate.ai/quickstart.md): Use sixteen x402 research tools over HTTP or native MCP: data calls cost 0.02 USDC, comparison 0.50 and search 1.50. Check coverage and approve quotes. - [API authentication](https://docs.beliefstate.ai/guides/authentication.md): Use x402 HTTP or native MCP with per-tool USDC quotes, or account-based REST keys and MCP OAuth. Preserve signed requests and protect credentials. - [Evidence and provenance](https://docs.beliefstate.ai/concepts/provenance.md): Trace BeliefState research to timestamped evidence and source identities. Understand derived sources, explicit unknowns, and outcome methodology. - [Coverage and limits](https://docs.beliefstate.ai/concepts/coverage.md): Check released BeliefState tickers and source coverage before research requests, and interpret stale, partial, missing, or unauthorized evidence. - [Cursor pagination](https://docs.beliefstate.ai/guides/pagination.md): Retrieve complete BeliefState result sets with bounded requests, next-page URLs, stable observation cutoffs, and request IDs that support retries. - [Historical queries](https://docs.beliefstate.ai/guides/point-in-time.md): Use as_of and changed_since to query BeliefState research within historical observation cutoffs and preserve those timestamps with your results. - [MCP integration](https://docs.beliefstate.ai/guides/mcp-server.md): Use account-based MCP with OAuth or a key, or wallet-paid x402 MCP with per-tool quotes. Verify cited research and discover free coverage tools. - [OpenAPI contract](https://docs.beliefstate.ai/guides/openapi.md): Download BeliefState's published OpenAPI 3.1 contract to generate REST clients and types, inspect schemas, and distinguish examples from live data. - [API versions](https://docs.beliefstate.ai/reference/versioning.md): Understand BeliefState REST route versions, OpenAPI publications, response schema versions, and the documented lifecycle of API operations. - [Webhook status](https://docs.beliefstate.ai/reference/webhooks.md): Customer webhooks are not publicly available. Review supported REST and MCP delivery paths and the requirements for evaluating push delivery. - [Event types](https://docs.beliefstate.ai/reference/webhook-events.md): No customer webhook event types are published. Review the event naming, payload, signature, retry, and replay standards required before release. - [API changelog](https://docs.beliefstate.ai/reference/changelog.md): Review shipped BeliefState API, MCP, and documentation changes, including retired operations, migration steps, and published contract updates. - [Common questions](https://docs.beliefstate.ai/reference/faq.md): Answers about BeliefState x402 research tools, research coverage, citations, account-based MCP/REST, pricing, payment retries, and support. - [Ticker research brief](https://docs.beliefstate.ai/api-reference/brief/get-an-evidence-backed-research-brief-for-a-ticker.md): Attributed investor theses, catalysts, risks and dated citations for a company. Accountless full, current and historical x402 briefs cost 0.02 USDC on Base. Account-based REST is also available. - [Investor beliefs and evidence](https://docs.beliefstate.ai/api-reference/beliefs/find-investor-beliefs-or-inspect-a-full-record.md): Find and inspect investor research through account-based REST or accountless x402 tools, with evidence, revisions and available outcomes. - [Ticker research coverage](https://docs.beliefstate.ai/api-reference/tickers/find-tickers-with-available-research.md): Discover companies and check available research coverage. - [Research source directory](https://docs.beliefstate.ai/api-reference/sources/find-research-sources-by-name-domain-or-source-id.md): Find research sources by name, domain, or company. - [API access and usage](https://docs.beliefstate.ai/api-reference/access/check-api-access-credit-balance-and-usage-metering.md): Check API access, credit balance, and metering. - [Research tools](https://docs.beliefstate.ai/tools/index.md): Reference for every BeliefState MCP and x402 research tool. - [get_belief_risks](https://docs.beliefstate.ai/tools/get-belief-risks.md): Read structured risks - [get_belief_catalysts](https://docs.beliefstate.ai/tools/get-belief-catalysts.md): Read structured catalysts - [get_author_track_record](https://docs.beliefstate.ai/tools/get-author-track-record.md): Read author track record - [search_beliefs](https://docs.beliefstate.ai/tools/search-beliefs.md): Search investment ideas - [get_belief](https://docs.beliefstate.ai/tools/get-belief.md): Read investment case - [compare_beliefs](https://docs.beliefstate.ai/tools/compare-beliefs.md): Compare investment ideas - [get_brief](https://docs.beliefstate.ai/tools/get-brief.md): Research brief - [get_beliefs](https://docs.beliefstate.ai/tools/get-beliefs.md): List investment ideas - [get_tickers](https://docs.beliefstate.ai/tools/get-tickers.md): Research coverage - [search_entities](https://docs.beliefstate.ai/tools/search-entities.md): Find research subjects - [get_belief_changes](https://docs.beliefstate.ai/tools/get-belief-changes.md): Research changes - [get_context_assessment](https://docs.beliefstate.ai/tools/get-context-assessment.md): Read context assessment - [list_research_visuals](https://docs.beliefstate.ai/tools/list-research-visuals.md): List research visuals - [get_research_visual](https://docs.beliefstate.ai/tools/get-research-visual.md): Read research visual - [get_belief_relationships](https://docs.beliefstate.ai/tools/get-belief-relationships.md): Inspect case relationships - [evaluate_belief_scenario](https://docs.beliefstate.ai/tools/evaluate-belief-scenario.md): Test case assumptions - [refresh_market_data](https://docs.beliefstate.ai/tools/refresh-market-data.md): Refresh market context - [search_companies](https://docs.beliefstate.ai/tools/search-companies.md): Find companies - [get_tracked_tickers](https://docs.beliefstate.ai/tools/get-tracked-tickers.md): Tracked companies ## OpenAPI Specs - [openapi](https://beliefstate.ai/openapi.json) ## Optional - [Connect AI](https://beliefstate.ai/connect) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.