GitHub MCP RegistryListed
BeliefState
25 account tools; 23 wallet tools (20 paid). Cited research, company facts, KPIs and guidance.
First seen 3 Nov 2026. Evidence as of 9 Nov 2026.
23
Tools
From an anonymous probe
1
Source listings
Each with its own history
50
Recorded changes
Since first seen
Tools
| Tool | Description | Behaviour |
|---|---|---|
| get_brief | Retrieves a cited research brief for a company, ETF or research subject, including investor theses, risks, catalysts, changes and available market context. Use overview for ordinary research, current for a bounded typed selection where supported, and full for machine export. ETF briefs connect dated holdings to company research with explicit coverage gaps; an ETF can be absent from get_tickers. Set refresh_market_data=true only for an explicitly requested current refresh; as_of/current views retain their no-refresh limits. Historical cutoffs preserve distinct publication and availability dates. Current view retains up to three cases with opposing views where available, three attached risks including continuing materialized risks, and three pending or unassessed catalysts per case. Its32KiB bound preserves whole-case omissions, qualifications and continuation. Per-call x402 price: 0.02 USDC on Base. | Destructive |
| get_case | 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 dependencies; scenario applies up to eight hypothetical conditions. Both preserve evidence and investor statements. Per-call x402 price: 0.02 USDC on Base. | Destructive |
| get_cases | 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. Useful for building a research inventory or finding additional cases beyond a brief. Use get_brief for an ordinary overview and get_search_results for a thesis or topic question. Continue a requested inventory with unchanged selectors and its returned cursor. Per-call x402 price: 0.02 USDC on Base. | Destructive |
| get_catalysts | 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 unknown status. Continue with the returned cursor and unchanged filters. Per-call x402 price: 0.02 USDC on Base. | Destructive |
| get_changes | 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 synthesis. Preserve publication, observation and availability clocks. Drain a requested window with unchanged selectors; its continuation cursor differs from the completed next-poll checkpoint. Coverage and resynchronization gaps remain explicit. Per-call x402 price: 0.02 USDC on Base. | Destructive |
| get_companies | Retrieves matching SEC-registered US companies by ticker or company name. Returns matching companies and their direct BeliefState research availability. Useful for resolving a company name before requesting a brief or cases. Choose the supported listing from returned matches; ambiguous names retain multiple candidates. Free. | Read-only |
| get_company_facts | Retrieves retained financial facts, company references, segment metrics, operating KPIs and management guidance for one ticker. Select record_type; use fiscal_year/fiscal_quarter for fiscal periods and date_field=report for issuance. Returns typed quantities, units, basis, qualifications, filing/capture clocks and exact source support. Guidance is a forecast; reported tolerances and computed bounds stay separate. Resolve empty metric/dimension matches using available_issuer_selectors; missing matches do not prove no disclosure. Use get_brief for investor views. Coverage is bounded. Issuer reads launch no paid extraction; current archive reads recheck stale metadata. as_of and pinned reads never refresh. Continue with the returned cursor or next_offset and unchanged snapshot, cutoff and filters. Per-call x402 price: 0.02 USDC on Base. | Destructive |
| get_comparison | 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 research proposition present in both cases. Engine assessments remain separate from investor statements; shared sources qualify the independence of support. Per-call x402 price: 0.50 USDC on Base. | Destructive |
| get_context_assessment | 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 on Base. | Destructive |
| get_economic_calendar | 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 refresh. This is retained calendar context, with snapshot freshness separate from event time. Continue with the returned snapshot, cutoff, filters and cursor or next_offset. Per-call x402 price: 0.02 USDC on Base. | Destructive |
| get_insider_trades | 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 reported SEC spelling; resolve ambiguous or unfamiliar aliases from returned owners. Current requests recheck stale retained mirror metadata; historical and pinned reads remain fixed. Use returned snapshot and cursor or next_offset for further pages; coverage and held records remain explicit. Per-call x402 price: 0.02 USDC on Base. | Destructive |
| get_institutional_holdings | 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 dates, and native value scales remain explicit. Current requests recheck stale mirror metadata; historical/pinned reads never switch snapshots. Continue with the returned snapshot ID/hash, as_of, filters and cursor or next_offset. Per-call x402 price: 0.02 USDC on Base. | Destructive |
| get_investor_outcomes | 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 that exceeds the returned bound. Uses stored market observations, with historical source completeness explicitly unknown. Per-call x402 price: 0.02 USDC on Base. | Destructive |
| get_macro_context | 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 explicitly bounded. Macro backdrop does not establish company exposure or a historical data vintage; FRED and rights-held series are unavailable. Current requests recheck stale mirror metadata; historical/pinned reads remain fixed. Continue with the returned snapshot, cutoff, filters and cursor or next_offset. Per-call x402 price: 0.02 USDC on Base. | Destructive |
| get_market_returns | 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 verified adjustment basis are required; missing or ambiguous inputs remain held. Price returns exclude dividends, fees and execution effects, and do not measure investor account performance. Current requests refresh only missing, incomplete or stale closing-price references from the configured delayed SIP feed; historical/pinned queries preserve input availability; use the returned snapshot, as_of, filters and next_offset for further pages. Per-call x402 price: 0.02 USDC on Base. | Destructive |
| get_news | Retrieves recent SEC filing metadata for one verified ticker: forms, filing and acceptance dates, official SEC links and the last observation time. Useful for checking company disclosures. Free; no account allowance, credits or wallet payment. Returns stale or unavailable when current retained filings are missing. This is SEC disclosure news, not a general headline feed, and stale or missing snapshots trigger a read-only SEC metadata lookup without storing new records. Provider failure preserves stale or unavailable status. | Read-only |
| get_options_activity | 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 order is not a globally sorted latest option chain. Current requests recheck stale mirror metadata; historical/pinned reads remain fixed. Continue with the returned snapshot, cutoff, filters and cursor or next_offset; partial scans are not proof of no matches. Per-call x402 price: 0.02 USDC on Base. | Destructive |
| get_risks | 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 assessed coverage; unknown risks remain separate. Continue with the returned cursor and unchanged filters. Per-call x402 price: 0.02 USDC on Base. | Destructive |
| get_search_results | 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 matches and coverage, rather than market-wide consensus. Continue with the returned cursor and unchanged query, filters and as_of cutoff. Per-call x402 price: 1.50 USDC on Base. | Destructive |
| get_short_activity | 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 requests recheck stale mirror metadata; historical and pinned reads never refresh. Continue with the returned snapshot, as_of, filters and cursor or next_offset; coverage gaps remain explicit. Per-call x402 price: 0.02 USDC on Base. | Destructive |
| get_subjects | 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-company subjects. Per-call x402 price: 0.02 USDC on Base. | Destructive |
| get_tickers | Retrieves public direct-company research coverage and counts. Account tracking requires the authenticated MCP server. | Read-only |
| get_visual | 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. Use visual_offset for another descriptor page, without visual_id. Per-call x402 price: 0.02 USDC on Base. | Destructive |
Change history
- Description changed (GitHub registry)
- search_entities: tool removed
- search_companies: tool removed
- search_beliefs: tool removed
- refresh_market_data: tool removed
- list_research_visuals: tool removed
- get_visual: tool added
- get_tickers: title changed
- get_tickers: input schema changed
- get_tickers: description changed (+"Retrieves public direct-company" +"counts. Account tracking requires the authenticated MCP server." -"Free")
- get_tickers: annotations changed
- get_subjects: tool added
- get_short_activity: tool added
- get_search_results: tool added
- get_risks: tool added
- get_research_visual: tool removed
- get_options_activity: tool added
- get_news: tool added
- get_market_returns: tool added
- get_macro_context: tool added
- get_investor_outcomes: tool added
- get_institutional_holdings: tool added
- get_insider_trades: tool added
- get_economic_calendar: tool added
- get_context_assessment: title changed
- get_context_assessment: description changed (+"Retrieves" +"by" +"returned assessment identifier, including")
- get_context_assessment: annotations changed
- get_comparison: tool added
- get_company_facts: tool added
- get_companies: tool added
- get_changes: tool added
- get_catalysts: tool added
- get_cases: tool added
- get_case: tool added
- get_brief: title changed
- get_brief: input schema changed (+issuer_document_id, +issuer_match_offset, +issuer_query, +refresh_market_data)
- get_brief: description changed (+"Retrieves a cited research brief" +"a company, ETF" +"subject,")
- get_brief: annotations changed
- get_beliefs: tool removed
- get_belief_risks: tool removed
- get_belief_relationships: tool removed
- get_belief_changes: tool removed
- get_belief_catalysts: tool removed
- get_belief: tool removed
- get_author_track_record: tool removed
- evaluate_belief_scenario: tool removed
- compare_beliefs: tool removed
- search_entities: input schema changed
- search_beliefs: input schema changed
- refresh_market_data: input schema changed
| Source | Listing | First seen | Last seen | Versions |
|---|---|---|---|---|
| GitHub MCP Registry | ai.beliefstate/investor-research | 3 Nov 2026 | 9 Nov 2026 | 2 |