{"schema_version":"1","name":"BeliefState research for AI agents","description":"Buy cited investor theses, evidence, risks, catalysts, revisions and publication-based outcomes. Fourteen data tools cost 0.02 USDC on Base per call; model comparison costs 0.50 and search costs 1.50 in the same token. Catalog, schemas and coverage are free. No BeliefState account or API key is required for x402 research.","payment_protocol":"x402","network":"eip155:8453","charges_enabled":true,"mcp_url":"https://beliefstate.ai/v1/research/mcp","documentation_url":"https://beliefstate.ai/agent-quickstart.md","openapi_url":"https://beliefstate.ai/openapi.json","operations":[{"tool":"get_belief_risks","title":"Read structured risks","description":"Read evidence-linked Risk objects for exactly one ticker, entity, Belief or explicit released corpus. Filter by person, source, publication dates, status or severity. Unknown assessments remain unknown; an empty high-severity filter does not prove no material risks. Current briefs include attached open risks, continuing materialized risks and separately marked unknown concerns; no implicit age or severity cutoff. Follow signed pagination with identical filters.","tags":["risks","evidence"],"method":"POST","url":"https://beliefstate.ai/v1/research/get_belief_risks","contract_url":"https://beliefstate.ai/v1/research/get_belief_risks","price_usdc":"0.02","input":"application/json"},{"tool":"get_belief_catalysts","title":"Read structured catalysts","description":"Read evidence-linked Catalyst objects with qualified current status or explicit unknowns. Filter one ticker, entity, Belief or released corpus by person, source, publication dates or status. Current briefs include pending and unassessed attached catalysts; met, missed and superseded records remain available here. Follow signed pagination with identical filters.","tags":["catalysts","evidence"],"method":"POST","url":"https://beliefstate.ai/v1/research/get_belief_catalysts","contract_url":"https://beliefstate.ai/v1/research/get_belief_catalysts","price_usdc":"0.02","input":"application/json"},{"tool":"get_author_track_record","title":"Read author track record","description":"Read an investor's stored publication-based outcome cohorts over one explicit ticker, entity, Belief or released corpus scope and optional source/publication window. Includes losses, pending and ineligible counts, preserves action/price/horizon cohorts and verified exits. Historical source completeness remains unknown. This read buys no new market data. Narrow scopes exceeding the supported bound.","tags":["performance","history"],"method":"POST","url":"https://beliefstate.ai/v1/research/get_author_track_record","contract_url":"https://beliefstate.ai/v1/research/get_author_track_record","price_usdc":"0.02","input":"application/json"},{"tool":"search_beliefs","title":"Search investment ideas","description":"Find investment ideas by thesis, topic or trade setup, with cited matching passages.","tags":["investing","search"],"method":"POST","url":"https://beliefstate.ai/v1/research/search_beliefs","contract_url":"https://beliefstate.ai/v1/research/search_beliefs","price_usdc":"1.50","input":"application/json"},{"tool":"get_belief","title":"Read investment case","description":"Read a requested complete investment case or evidence beyond a brief, with risks, conditions and coverage gaps. An ordinary library overview can use get_brief without opening each case. Use paragraph_index only when it appears in the returned investment_case; follow support/text offsets. Records without investment_case return their full claims and citations without paragraph selectors.","tags":["investing","evidence"],"method":"POST","url":"https://beliefstate.ai/v1/research/get_belief","contract_url":"https://beliefstate.ai/v1/research/get_belief","price_usdc":"0.02","input":"application/json"},{"tool":"compare_beliefs","title":"Compare investment ideas","description":"Compare two cited investment cases for support, contradiction or dependency, including explicit unknown and unrelated outcomes. Optional comparison_focus selects a public research topic within both complete cases; the result applies to that topic only. Shared-source provenance does not establish research independence.","tags":["investing","comparison"],"method":"POST","url":"https://beliefstate.ai/v1/research/compare_beliefs","contract_url":"https://beliefstate.ai/v1/research/compare_beliefs","price_usdc":"0.50","input":"application/json"},{"tool":"get_brief","title":"Research brief","description":"Use detail=current for a small typed view: up to three current Beliefs, each with up to three attached risks and three pending or unassessed catalysts, evidence URLs, timestamps, material qualifications and explicit unknowns. Open risks and materialized risks with supported continuing relevance qualify; no implicit severity or age cutoff. Selection reserves opposing views then distinct stances and recency. The 16 KiB response reports whole-case omissions, quality gaps and pagination; it is not complete coverage. Overview answers broader company/ETF research with outlook and changes. Full opens machine export. Historical reads preserve their cutoff.","tags":["investing","thesis"],"method":"POST","url":"https://beliefstate.ai/v1/research/get_brief","contract_url":"https://beliefstate.ai/v1/research/get_brief","price_usdc":"0.02","input":"application/json"},{"tool":"get_beliefs","title":"List investment ideas","description":"List dated investment ideas for a requested inventory or filtered research on one ticker or subject. Investor, direction and time filters are optional. An ordinary overview uses get_brief; listing the same research afterward is unnecessary unless the user needs additional cases.","tags":["investing","inventory"],"method":"POST","url":"https://beliefstate.ai/v1/research/get_beliefs","contract_url":"https://beliefstate.ai/v1/research/get_beliefs","price_usdc":"0.02","input":"application/json"},{"tool":"search_entities","title":"Find research subjects","description":"Find released companies, industries, themes and other research subjects by name or kind.","tags":["subjects","discovery"],"method":"POST","url":"https://beliefstate.ai/v1/research/search_entities","contract_url":"https://beliefstate.ai/v1/research/search_entities","price_usdc":"0.02","input":"application/json"},{"tool":"get_belief_changes","title":"Research changes","description":"Read a mixed, ordered change journal: author-view revisions, distribution changes and calculated publication outcomes are separate domains with distinct clocks. Use belief_id for changes to one case and inspect each event's domain. Use get_brief for a current synthesis; continuation is for requested journal history or polling.","tags":["investing","changes"],"method":"POST","url":"https://beliefstate.ai/v1/research/get_belief_changes","contract_url":"https://beliefstate.ai/v1/research/get_belief_changes","price_usdc":"0.02","input":"application/json"},{"tool":"get_context_assessment","title":"Read context assessment","description":"Open a dated engine context assessment and its permitted evidence. Engine analysis is separate from an investor's stated view.","tags":["context","evidence"],"method":"POST","url":"https://beliefstate.ai/v1/research/get_context_assessment","contract_url":"https://beliefstate.ai/v1/research/get_context_assessment","price_usdc":"0.02","input":"application/json"},{"tool":"list_research_visuals","title":"List research visuals","description":"List cited charts and tables for one investment case or context assessment.","tags":["visuals","evidence"],"method":"POST","url":"https://beliefstate.ai/v1/research/list_research_visuals","contract_url":"https://beliefstate.ai/v1/research/list_research_visuals","price_usdc":"0.02","input":"application/json"},{"tool":"get_research_visual","title":"Read research visual","description":"Read one cited chart or table, including its regions and paginated exact rows or data points.","tags":["visuals","evidence"],"method":"POST","url":"https://beliefstate.ai/v1/research/get_research_visual","contract_url":"https://beliefstate.ai/v1/research/get_research_visual","price_usdc":"0.02","input":"application/json"},{"tool":"get_belief_relationships","title":"Inspect case relationships","description":"Inspect cited relationship paths within one investment case. Preserves stated links, engine inferences and unknowns.","tags":["relationships","evidence"],"method":"POST","url":"https://beliefstate.ai/v1/research/get_belief_relationships","contract_url":"https://beliefstate.ai/v1/research/get_belief_relationships","price_usdc":"0.02","input":"application/json"},{"tool":"evaluate_belief_scenario","title":"Test case assumptions","description":"Apply up to eight hypothetical condition assumptions to a case's recorded scenario model. Does not alter evidence or predict the investor's response.","tags":["scenario","conditions"],"method":"POST","url":"https://beliefstate.ai/v1/research/evaluate_belief_scenario","contract_url":"https://beliefstate.ai/v1/research/evaluate_belief_scenario","price_usdc":"0.02","input":"application/json"},{"tool":"refresh_market_data","title":"Refresh market context","description":"Explicitly refresh missing or stale market data for one current company or subject, then return its research brief.","tags":["market","freshness"],"method":"POST","url":"https://beliefstate.ai/v1/research/refresh_market_data","contract_url":"https://beliefstate.ai/v1/research/refresh_market_data","price_usdc":"0.02","input":"application/json"}],"free_discovery":["/v1/tickers","/v1/tickers?q=company"]}