# BeliefState

> BeliefState is a freemium MCP server for finance and payments. Cited investor research and company snapshots for AI agents, with free and paid MCP tools. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://docs.beliefstate.ai/guides/mcp-server
- **Repository:** https://github.com/antcolombo/beliefstate-agent-integrations
- **MCP Registry name:** ai.beliefstate/investor-research
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://beliefstate.ai/v1/research/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/beliefstate
