BeliefState MCP Server

by beliefstate Your server? Claim it

answering

BeliefState is answering right now. Last checked 10 min ago. It exposes 18 tools. Last commit 2 Nov 2026.

Stock research and investor research for trading agents. 16 x402 tools; data from 0.02 USDC on Base.

Uptime history 17 days of history · worst day 99%

17 days agonow

100.0%

Uptime 24h

182 of 182 checks

Tools

read from the server

792 ms

Response time

average over 24h

Stars

last commit 2 Nov 2026

What changed 35

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 26 October 2026. No other catalogue keeps this.

2 Nov a tool changed the parameters it asks for get_belief

28 Oct a tool description was rewritten get_brief

28 Oct a tool changed the parameters it asks for get_brief

26 Oct 16 tools appeared compare_beliefs, evaluate_belief_scenario, get_author_track_record and 13 more

26 Oct 16 tools disappeared compare_beliefs, evaluate_belief_scenario, get_author_track_record and 13 more

Nothing serious here today

Today is the operative word: we check BeliefState every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 10 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add investor-research --transport http https://beliefstate.ai/mcp

Settings → Connectors → Add custom connector, then paste this address

https://beliefstate.ai/mcp

~/.codex/config.toml

[mcp_servers.investor-research]
url = "https://beliefstate.ai/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "investor-research": {
      "url": "https://beliefstate.ai/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "investor-research": {
      "type": "http",
      "url": "https://beliefstate.ai/mcp"
    }
  }
}

This endpoint answered with an authorization challenge. The server is running, and it signs you in through your browser: there is no API key to paste.

This server publishes 1 more address. The block above uses the one we reach during checks; the full list is under Endpoints below, and the author may intend a particular one for your client.

Available tools 18

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

belief

get_belief

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 x402 price: 0.02 USDC on Base.

get_belief_catalysts

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 Base.

get_belief_changes

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.

get_belief_relationships

Inspect cited relationship paths within one investment case. Preserves stated links, engine inferences and unknowns. Per-call x402 price: 0.02 USDC on Base.

get_belief_risks

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. Per-call x402 price: 0.02 USDC on Base.

beliefs

get_beliefs

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.

search_beliefs

Find investment ideas by thesis, topic or trade setup, with cited matching passages. Per-call x402 price: 1.50 USDC on Base.

research

get_research_visual

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.

list_research_visuals

List cited charts and tables for one investment case or context assessment. Per-call x402 price: 0.02 USDC on Base.

author

get_author_track_record

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. Per-call x402 price: 0.02 USDC on Base.

brief

get_brief

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 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 32 KiB current response reports whole-case omissions, quality gaps and pagination; it is not complete coverage. Full opens machine export. Historical reads preserve their cutoff. Per-call x402 price: 0.02 USDC on Base.

companies

search_companies

Free research coverage and company discovery.

compare

compare_beliefs

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.

context

get_context_assessment

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.

entities

search_entities

Find released companies, industries, themes and other research subjects by name or kind. Per-call x402 price: 0.02 USDC on Base.

evaluate

evaluate_belief_scenario

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.

refresh

refresh_market_data

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.

tickers

get_tickers

Free research coverage and company discovery.

Endpoints

URL	Transport	State	Latency	Checked
https://beliefstate.ai/mcp	streamable-http	sign-in	1231 ms	12 min ago
https://beliefstate.ai/v1/research/mcp	streamable-http	answering	199 ms	10 min ago

Alternatives to BeliefState

same job, measured the same way

Agent Web Reader

by charliemorrison

Pay-per-call data tools for AI agents: crypto signal, web reader, SEO audit. x402 USDC on Base.

3 tools answering

Tokenized Stocks & Agent Data (x402)

by fly-x402-accelerometer-feed

x402-paid data for agents: tokenized stocks on Base, Solana token verdicts, AI-progress readings

12 tools answering

santyvv-data — market & on-chain data

by santyvv

Market and on-chain crypto data for AI agents. Pay per call in USDC on Base (x402).

49 installs/wk 8 tools answering

Stock Bloc

by jaywestphilly

SEC filing jobs, 13F holdings, market data, quant scores for agents. x402 USDC pay-per-call on Base.

14 tools answering

Liquid Agent

by liquidagent-api

Money tools for AI agents over x402: USDC bridge to 16 chains, Polymarket data, stocks, USDC gas.

37 tools answering

Agent Data Pro

by orionsmithers

Research articles and live crypto prices for AI agents via x402 on Base.

6 tools answering

Signal Feed API: market regime

by dinevdecor

Daily market regime (risk-on / risk-off) for trading agents, paid per call via x402 USDC on Base.

936 installs/wk local only

PickleCheck

by picklecheck

Scam, x402 endpoint and payment checks for AI trading agents on Base. Free calls daily, then x402.

3 tools answering

BeliefState — questions

Answers built from our own checks of this server.

What can BeliefState do?

It exposes 18 tools, read directly from the server on our last check. Among them: compare_beliefs, evaluate_belief_scenario, get_author_track_record, get_belief, get_belief_catalysts, get_belief_changes and 12 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is BeliefState mostly used for?

Its tools cluster around belief, beliefs and research. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is BeliefState working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 182 of 182 checks got a reply (100.0%), average response time 792 ms. The bar chart above shows every period we have measured.

How do I connect BeliefState?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address. You sign in through your browser once and the client keeps the session: no key to copy, and it refuses anonymous clients.

How do you sign in to BeliefState?

No API key is involved. BeliefState answers our knock with an OAuth challenge, so you authorise it once in your browser and the client keeps the session. That is also why we see no tool list: it will not describe itself to an anonymous client, and that is the server working as intended, not a fault.

How fast is BeliefState?

It answers our handshake in 792 ms on average, which is faster than 11% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is BeliefState open source?

The code is open source: it is published under the MIT licence, 0 stars on GitHub and 1 open issue. The licence covers the code in the repository, not the hosted service at beliefstate.ai, which runs on its operator's own terms.