Alpaca Trading API integration for Model Context Protocol (MCP)
Nothing to run from here
BeliefState is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
18
tools declared
—
trust score
remote
at its publisher
—
calls last 7d
What it does
BeliefState brings dated, source-linked investor research into AI tools. Find investment cases, inspect the supporting evidence, compare risks and catalysts, and follow changes in published views.
Connect directly to https://beliefstate.ai/v1/research/mcp with your BeliefState account API key. Requests go to BeliefState.
The MCPRush listing and installation are free. Research requests use your BeliefState subscription allowance or prepaid credit. Create an account and manage access at https://beliefstate.ai.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http beliefstate-mcp https://beliefstate.ai/v1/research/mcp --header 'Authorization: Bearer ${API_KEY}'
# 2 — ask your agent for something these tools do
# get_belief_risks, get_belief_catalysts, get_author_track_record and 15 more
It needs API_KEY (BeliefState account API key. Research uses your account allowance or prepaid credit): this sends it in the Authorization header from your environment, so export it first — its endpoint answers 401 without it.
BeliefState costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Publisher
Installation
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
Claude Codedeclared by this listing
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it. Claude Code reads API_KEY (BeliefState account API key. Research uses your account allowance or prepaid credit) from your environment each time it connects and sends it in the Authorization header — its endpoint answers 401 without it — so the key stays out of its config: export it in your shell profile (macOS, Linux), or run setx API_KEY … and open a new terminal (Windows).
claude mcp add --scope user --transport http beliefstate-mcp https://beliefstate.ai/v1/research/mcp --header 'Authorization: Bearer ${API_KEY}'Reconnect, or start a new session, and the tools appear in the model’s tool list.
Free on mcprush, and it answers at its publisher’s own address: this marketplace is not in the path, so there is no key of ours to hold and no card to add — but its publisher asks for a key of their own on every call.
What it asks of you
It reaches a system of yours, so it needs your own credential rather than the publisher’s: Authorization header — BeliefState account API key. Research uses your account allowance or prepaid credit.. You set it in your own client’s config, on your machine — this marketplace never holds it.
What it writes
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
What you approve
18 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
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
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | no | — |
| entity_id | string | no | — |
| belief_id | string | no | — |
| corpus | string | no | — |
| person_id | string | no | — |
| source_id | string | no | — |
| object_status | string | no | — |
| severity | string | no | — |
| published_from | string | no | — |
| published_through | string | no | — |
| as_of | string | no | — |
| limit | integer | no | — |
| cursor | string | no | — |
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. Per-call x402 price: 0.02 USDC on Ba
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | no | — |
| entity_id | string | no | — |
| belief_id | string | no | — |
| corpus | string | no | — |
| person_id | string | no | — |
| source_id | string | no | — |
| object_status | string | no | — |
| published_from | string | no | — |
| published_through | string | no | — |
| as_of | string | no | — |
| limit | integer | no | — |
| cursor | string | no | — |
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.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | no | — |
| entity_id | string | no | — |
| belief_id | string | no | — |
| corpus | string | no | — |
| person_id | string | yes | — |
| source_id | string | no | — |
| published_from | string | no | — |
| published_through | string | no | — |
| as_of | string | no | — |
Find investment ideas by thesis, topic or trade setup, with cited matching passages. Per-call x402 price: 1.50 USDC on Base.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| q | string | no | Thesis, topic or trade setup. Required on the first page. |
| ticker | string | no | — |
| entity_id | string | no | Released subject ID returned by search_entities. |
| person_id | string | no | — |
| direction | string | no | — |
| status | string | no | — |
| time_horizon | string | no | — |
| changed_since | string | no | Find initial research, author revisions, condition checks/plans or released outcomes becoming available after this cutoff. Keeps author dates and stance separate from system activity. Release changes |
| as_of | string | no | — |
| limit | integer | no | Requested page size. For ticker/entity belief lists, MCP returns up to twelve complete summaries within its response budget; pagination.limit is the effective size. Continue with next_cursor and the s |
| cursor | string | no | Use next_cursor for another page of the same search. |
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. Per-call x4
| Parameter | Type | Required | Notes |
|---|---|---|---|
| belief_id | string | yes | — |
| as_of | string | no | — |
| paragraph_index | integer | no | Read exact source support only for a paragraph_index present in the returned investment_case. Records without investment_case do not support this selector. Requires belief_id. Continue with returned a |
| support_index | integer | no | Source support within the selected paragraph; defaults to 0. Use next_support_index for another passage. |
| support_text_offset | integer | no | UTF-16 offset within the selected supporting passage; defaults to 0. Use next_text_offset to continue its text. |
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. Per-call x402 price: 0.50 USDC on Base.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| belief_id | string | yes | — |
| compare_to_belief_id | string | yes | — |
| comparison_focus | string | no | Optional public research topic or proposition to compare within both complete cases. Supply a topic, not a desired relation, private portfolio information or instructions. Other relations in the cases |
| as_of | string | no | — |
Start with overview for an ordinary company or ETF research question, including outlook and changes. Present findings in plain language with named investors, dated source links and important gaps; include record IDs and field names when requested for verification or export. Use detail=current for up to three current Beliefs, each with up to three attached risks and three pending or unassessed cata
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | no | — |
| as_of | string | no | — |
| max_results | integer | no | Maximum returned views. Overview returns at most five (default five); larger valid requests are capped at five with explicit returned and omitted counts. Full supports 1–20. Omit for an ordinary overv |
| detail | string | no | Current returns up to three reviewed current Beliefs with up to three Risks and three Catalysts each, direct evidence URLs, clocks and explicit unknowns under 32KiB. Attached open Risks or materialize |
| entity_id | string | no | Released subject ID returned by search_entities. |
| cursor | string | no | — |
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. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | no | — |
| entity_id | string | no | Released subject ID returned by search_entities. |
| person_id | string | no | — |
| direction | string | no | — |
| status | string | no | — |
| time_horizon | string | no | — |
| changed_since | string | no | Find initial research, author revisions, condition checks/plans or released outcomes becoming available after this cutoff. Keeps author dates and stance separate from system activity. Release changes |
| as_of | string | no | — |
| limit | integer | no | Requested page size. For ticker/entity belief lists, MCP returns up to twelve complete summaries within its response budget; pagination.limit is the effective size. Continue with next_cursor and the s |
| cursor | string | no | — |
Find released companies, industries, themes and other research subjects by name or kind. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| q | string | no | — |
| kind | string | no | — |
| as_of | string | no | — |
| limit | integer | no | Requested page size. For ticker/entity belief lists, MCP returns up to twelve complete summaries within its response budget; pagination.limit is the effective size. Continue with next_cursor and the s |
| cursor | string | no | — |
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. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| person_id | string | no | — |
| source_id | string | no | — |
| domain | string | no | — |
| event_kind | string | no | — |
| revision_only | boolean | no | — |
| ticker | string | no | — |
| entity_id | string | no | — |
| belief_id | string | no | — |
| corpus | string | no | — |
| cursor | string | no | — |
| checkpoint | string | no | — |
| resync | boolean | no | — |
| as_of | string | no | — |
| changed_since | string | no | — |
| limit | integer | no | — |
Open a dated engine context assessment and its permitted evidence. Engine analysis is separate from an investor's stated view. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| context_assessment_id | string | yes | — |
| as_of | string | no | — |
List cited charts and tables for one investment case or context assessment. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| belief_id | string | no | — |
| context_assessment_id | string | no | Open a neutral engine context assessment returned by a brief or ordered change. It is not an author Belief. |
| as_of | string | no | — |
| visual_offset | integer | no | Continue saved visual descriptors using next_visual_offset. |
Read one cited chart or table, including its regions and paginated exact rows or data points. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| belief_id | string | no | — |
| context_assessment_id | string | no | Open a neutral engine context assessment returned by a brief or ordered change. It is not an author Belief. |
| as_of | string | no | — |
| visual_id | string | yes | Saved visual ID returned by list_research_visuals. |
| region_id | string | no | Use a region_id returned in the selected visual's regions to retrieve structured data. |
| region_offset | integer | no | Continue a selected visual's region descriptors using next_region_offset. |
| row_offset | integer | no | Zero-based starting row or chart-point index in the selected region. |
| row_limit | integer | no | Rows or chart points per read; defaults to 50, maximum 100. |
Inspect cited relationship paths within one investment case. Preserves stated links, engine inferences and unknowns. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| belief_id | string | yes | — |
| as_of | string | no | — |
| from_entity_id | string | yes | — |
| to_entity_id | string | no | — |
| max_depth | integer | yes | — |
| edge_budget | integer | yes | — |
Apply up to eight hypothetical condition assumptions to a case's recorded scenario model. Does not alter evidence or predict the investor's response. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| belief_id | string | yes | — |
| as_of | string | no | — |
| scenario | object | yes | — |
Explicitly refresh missing or stale market data for one current company or subject, then return its research brief. Per-call x402 price: 0.02 USDC on Base.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| ticker | string | no | — |
| entity_id | string | no | Released subject ID returned by search_entities. |
Free research coverage and company discovery.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| as_of | string | no | — |
Free research coverage and company discovery.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| q | string | yes | Search the current SEC company directory by ticker or name, independently of direct research coverage. Omit as_of. |
Free
$0 forever
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install BeliefState or to call it, at any volume.
Call allowance · this installenforced at the gateway
Monthly allowance, in calls
—
—
Alert at 80% · then the tool returns a normal MCP error
Used this month: —
—Grade not published
No rule-by-rule report on file for this release
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing is an address its publisher runs, and you connect to it directly — this marketplace is not in the path. The scanner reads packages and public source, and an address is neither. So there is no grade — not a withheld one, an unmeasured one.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 1.0.3.
1.0.3
undated
latestNo release note was published with this version.
—
no reviews yet
Who can review
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Sign in to write one
Any signed-in account that does not publish BeliefState can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
No reviews yet
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.