compare_beliefs

Compare investment ideas · $0.50 per call (x402, USDC) 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.

Input parameters

Parameter	Type	Required	Description
`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 are outside this focused assessment. min length 1; max length 500
`as_of`	string	No

Transports

MCP: tools/call with name compare_beliefs at https://beliefstate.ai/mcp (account access) or the wallet-paid x402 MCP server. See MCP integration.
x402 HTTP: POST https://beliefstate.ai/v1/research/compare_beliefs with the arguments as a JSON body. An unpaid request returns an HTTP 402 payment quote.
Related REST resource: GET /v1/beliefs.

Example request

MCP

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "compare_beliefs",
    "arguments": {
      "belief_id": "00000000-0000-4000-8000-000000000001",
      "compare_to_belief_id": "00000000-0000-4000-8000-000000000002"
    }
  }
}

x402 HTTP

curl --request POST \
  --url 'https://beliefstate.ai/v1/research/compare_beliefs' \
  --header 'Content-Type: application/json' \
  --data '{"belief_id":"00000000-0000-4000-8000-000000000001","compare_to_belief_id":"00000000-0000-4000-8000-000000000002"}'

The example shows request shape only. Identifiers are placeholders, not records.

Get Started

Core Concepts

Guides

Reference

Endpoints

Research tools

Input parameters

Transports

Example request

MCP

x402 HTTP

​Input parameters

​Transports

​Example request

​MCP

​x402 HTTP

​Related

Input parameters

Transports

Example request

MCP

x402 HTTP

Related