{"id":"ai.beliefstate/investor-research","slug":"ai-beliefstate-investor-research","title":"BeliefState","description":"26 account tools; 23 wallet tools (20 paid). Free company snapshots and cited research.","version":"1.1.1","publisher":{"kind":"domain","id":"beliefstate.ai","label":"beliefstate.ai","url":"https://beliefstate.ai"},"website":"https://docs.beliefstate.ai/guides/mcp-server","repository":"https://github.com/Antcolombo/beliefstate-agent-integrations","remotes":[{"type":"streamable-http","url":"https://beliefstate.ai/v1/research/mcp"},{"type":"streamable-http","url":"https://beliefstate.ai/mcp","headers":[{"description":"BeliefState account API key. Research uses your account allowance or prepaid credit.","value":"Bearer {api_key}","variables":{"api_key":{"description":"Create a BeliefState API key in your account settings. Keep it private.","isRequired":true,"isSecret":true}},"name":"Authorization"}]}],"packages":[],"published":"2026-11-10","updated":"2026-11-10","status":"online","auth":"","latency_ms":1983,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"get_brief","title":"Get research brief","description":"Read a cited research brief for a covered U.S. ticker, ETF or released subject. Overview, current and full views support dated research and historical cutoffs. An explicit refresh requires current stock and SPY prices before payment. Per-call x402 price: 0.02 USDC on Base.","read_only":false},{"name":"get_case","title":"Get investment case","description":"Retrieves one complete investment case by returned belief_id: investor, reasoning, evidence, risks, catalysts, conditions, revisions, outcomes, provenance and coverage gaps. Useful for deeper follow-ups; start company overviews with get_brief. Use paragraph_index only when returned in investment_case and follow support/text offsets for exact evidence. Optional relationship_paths inspects supported","read_only":false},{"name":"get_cases","title":"Get investment cases","description":"Retrieves dated investment cases for one company or research subject, with optional investor, direction and time filters. Returns attributed thesis records, case IDs, dates, citations and coverage information. Use get_brief first for who covers a ticker and what each investor thinks. Use get_cases for an article-by-article inventory. Each page costs a request. Continue only if the user wants more ","read_only":false},{"name":"get_catalysts","title":"Get case catalysts","description":"Retrieves evidence-linked catalysts for one company, research subject, investment case or the explicitly selected released corpus. Returns recorded conditions, lifecycle status, dates and supporting evidence. Useful for checking which thesis events remain pending, were met or missed, or have been superseded. Filter by investor, source, publication dates or status. Unassessed conditions retain unkn","read_only":false},{"name":"get_changes","title":"Get research changes","description":"Retrieves the ordered research change journal for a company, subject, case or explicitly selected released corpus. Returns dated events, citations and available before/after values, separating author revisions, distribution changes and calculated publication outcomes. Use domain=author_view for investor-view changes and revision_only=true for authored revisions only; get_brief provides a current s","read_only":false},{"name":"get_companies","title":"Get companies","description":"Find SEC-registered U.S. companies and selected verified international listings by symbol or name. Search by market, sector or exchange-qualified symbol, such as Indian banks, Canadian stocks or XTAI:2330. Listing identity and released investor research are reported separately. Free.","read_only":true},{"name":"get_company_facts","title":"Get company facts","description":"Returns retained financial facts, company references, segment metrics, operating KPIs, management guidance and site milestones for one ticker. Use record_type=site_milestone for cited permit, contract, delivery and billing stages and source-specific dates. Use fiscal_year/fiscal_quarter for fiscal periods and date_field=report for issuance. Guidance is a forecast; reported tolerances and computed ","read_only":false},{"name":"get_comparison","title":"Get case comparison","description":"Retrieves a cited engine comparison of two distinct investment cases using their returned belief_id and compare_to_belief_id. Returns a cited engine assessment of support, contradiction, dependency, unknown or unrelated reasoning, with assessment time and case cutoff. Useful for examining opposing views or investment alternatives. Optional comparison_focus narrows the assessment to a public resear","read_only":false},{"name":"get_context_assessment","title":"Get context assessment","description":"Retrieves a dated engine context assessment by its returned assessment identifier, including permitted supporting evidence and coverage limitations. Useful for examining the issuer, market or event context cited in a brief or investment case. Assessment time and evidence dates remain explicit; the engine's interpretation is separate from the investor's stated thesis. Per-call x402 price: 0.02 USDC","read_only":false},{"name":"get_economic_calendar","title":"Get economic calendar","description":"Retrieves retained US economic events in one ticker research scope. Filter by event text, region, scheduled/reported/unconfirmed state and scheduled-date bounds. Returns typed actual, previous, consensus and forecast literals, revision markers, native times and source support; an unverified timezone stays unknown. Current requests recheck stale mirror metadata; historical and pinned reads never re","read_only":false},{"name":"get_insider_trades","title":"Get insider transactions","description":"Retrieves source-reported insider transactions for one ticker. Filter by reporting owner name or CIK, transaction codes, derivative status and transaction or filing dates. Returns typed owners, security units, prices, acquisition/disposition codes, filing dates and exact support; SEC codes distinguish market purchases/sales (P/S), gifts (G), tax withholding (F) and exercises (M). Owner names use r","read_only":false},{"name":"get_institutional_holdings","title":"Get institutional holdings","description":"Retrieves reported institutional holdings for one ticker across supported retained 13F history. Filter by manager name or CIK, report period, filing dates, amendments, share class and shares versus PUT/CALL positions. Returns typed quantities, native reported values, manager identities and source support. Identifier and filing-join checks hold ambiguous records; report dates differ from filing dat","read_only":false},{"name":"get_investor_outcomes","title":"Get investor track record","description":"Retrieves an investor's stored publication-based outcomes for one company, research subject, investment case or the explicitly selected released corpus. Returns action, entry-price and horizon cohorts, verified exits, losses, pending results and ineligible counts. Useful for reviewing measured thesis outcomes and their sample limitations. Filter by source and publication window; narrow a scope tha","read_only":false},{"name":"get_macro_context","title":"Get macroeconomic context","description":"Retrieves retained government macroeconomic observations in one ticker research scope. Filter by native series_ids, agency, measurement_names and period dates; returns typed values, units, seasonal bases, scales, native periods and source support. Supported archive formats cover Treasury, NY Fed, BLS, BEA, EIA, CFTC and metadata-qualified Federal Reserve Board series; other admitted context is exp","read_only":false},{"name":"get_market_returns","title":"Get market returns","description":"Retrieves supported split-adjusted close-price returns for one ticker versus SPY. Request session_intervals from 1 to 252; date bounds select return end sessions, while an omitted date range uses the latest completed official session. Returns typed security and benchmark returns, excess percentage points, exact session dates and retained support. Complete security/SPY paths, official calendars and","read_only":false},{"name":"get_news","title":"Get SEC filing news","description":"Check recent SEC filings for one verified ticker. Set include_earnings to also read issuer-announced earnings schedules when available. Free without an account or wallet.","read_only":true},{"name":"get_options_activity","title":"Get options activity","description":"Retrieves retained options bars, flow aggregates and open interest for one ticker. Select activity_type, call/put right, expiration, strike and observation-date filters; returns typed instrument fields, OHLC, volume or open interest with units and source support. Open interest is a position measure; trading volume is a flow. Use explicit date/instrument filters for large histories; source-file ord","read_only":false},{"name":"get_risks","title":"Get case risks","description":"Retrieves evidence-linked risks for one company, research subject, investment case or the explicitly selected released corpus. Returns recorded severity, lifecycle status, supporting evidence and unknown assessments. Useful for investigating a thesis's downside and invalidation conditions. Filter by investor, source, publication dates, status or severity. Empty filtered results reflect available a","read_only":false},{"name":"get_search_results","title":"Get matching investment cases","description":"Retrieves ranked published investment cases matching thesis, investment theme or trade setup, with an optional company or subject filter. Returns ranked matching passages, attributed investors, dates, case IDs and citations. Useful for finding research about a business trend or investment question without knowing a ticker. Open selected cases with get_case for more depth. Ranking reflects library ","read_only":false},{"name":"get_short_activity","title":"Get short activity","description":"Retrieves retained short-interest and short-volume history for one ticker. Select family and date bounds; short_interest uses settlement periods, while short_volume uses observation dates. Returns typed outstanding short shares, average daily volume and days to cover, or daily short/exempt/total volumes, with exact source support. Short volume does not establish an outstanding position. Current re","read_only":false},{"name":"get_subjects","title":"Get research subjects","description":"Retrieves matching released research subjects by name or kind, including companies, industries and investment themes. Returns matching subject identifiers and available research coverage. Useful for resolving a non-company topic before requesting a brief or cases. Use the returned entity_id for follow-up research and preserve ambiguity when multiple subjects match; a ticker is optional for non-com","read_only":false},{"name":"get_tickers","title":"Get research coverage","description":"Retrieves public direct-company research coverage and counts. Account tracking requires the authenticated MCP server.","read_only":true},{"name":"get_visual","title":"Get research visual","description":"Retrieves saved research charts and tables for one investment case or context assessment. Without visual_id, returns available visual and region descriptors; with visual_id, returns the selected visual's regions. Supply region_id for available structured chart/table data, with bounded row pagination. Results preserve citations, recorded coverage, historical cutoffs and text-access restrictions. Us","read_only":false}],"server_info":{"name":"BeliefState x402 research","version":"1.0.0"},"category":"research","tags":["crypto","news","productivity"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-17","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/ai-beliefstate-investor-research/"}