Skip to content
MCP server

BeliefState

Cited investor research and company snapshots for AI agents, with free and paid MCP tools

Install
Pricing
Freemium
Platforms
API
Runs
Remotely
Version
1.1.1
Listing updated
3 days ago

About BeliefState

BeliefState is a freemium MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.

BeliefState exposes three separate MCP endpoints. The account server at beliefstate.ai/mcp has 26 tools and signs in with OAuth or a bearer API key. A wallet server at beliefstate.ai/v1/research/mcp has 23 tools, 20 of them paid per call over x402 with no account, and a documentation server at beliefstate.ai/docs/mcp is read-only.

The research tools work on investor beliefs: comparing them, reading their catalysts and risks, tracking how they changed, and evaluating scenarios. Results carry citations and a data_status field, and the docs suggest asking an agent to report warnings and explicit unknowns instead of filling gaps.

The docs say the MCP tools use the same read services, release gates, pricing policy and usage ledger as the REST API, and that no SDK is needed.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://beliefstate.ai/v1/research/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "investor-research": {
      "url": "https://beliefstate.ai/v1/research/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (15)

Taken from the project documentation; the running server may differ.

get_company_snapshot
Free company snapshot on the account server.
get_account_status
Free account status check.
get_brief
Cited brief for a company ticker.
get_tickers
Free list of covered tickers.
get_companies
Free company listing.
get_news
Free news tool on the wallet server.
compare_beliefs
Compare beliefs.
search_beliefs
Search beliefs.
get_belief_catalysts
Read the catalysts behind a belief.
get_belief_risks
Read the risks behind a belief.
get_belief_changes
Read how a belief changed.
evaluate_belief_scenario
Evaluate a scenario against a belief.
search_docs
Search public docs (read only).
read_docs
Read public docs as Markdown (read only).
submit_docs_feedback
Send feedback on a docs page.

What it does

Account and wallet access
Connect with OAuth or an API key, or pay per call with x402 and no account.
Cited research
Responses carry citations, data status and warnings so unknowns stay visible.
Free coverage tools
Company snapshots, tickers, companies and news are free.
Belief analysis
Compare beliefs and read their catalysts, risks and changes.
Docs server
A read-only server lets agents search and read the public documentation.

Good for

  • Pull a cited brief on a listed company
  • Compare two investors' beliefs on a stock
  • Check which tickers are covered before researching
  • Track changes to a belief over time

Pricing

Freemium

Some tools free; 20 wallet tools paid per call via x402; prices not published

Prices change. Check docs.beliefstate.ai before you buy.

BeliefState FAQ

Do I need an account?

Not for the wallet server, where paid tools are paid per call with x402. The account server uses OAuth or a bearer API key.

Which tools are free?

The docs list get_company_snapshot and get_account_status on the account server, and get_tickers, get_companies and get_news on the wallet server.

Is there an SDK?

No. The docs say none is required; clients use the remote Streamable HTTP endpoint.

Is BeliefState free?

BeliefState has a free plan, with paid plans for more usage or features.

How do I add BeliefState to Claude Code?

Run this command in your terminal: claude mcp add --transport http investor-research https://beliefstate.ai/v1/research/mcp

What are the best alternatives to BeliefState?

The closest alternatives to BeliefState are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to BeliefState

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments