get_visual

Get research visual · $0.02 per call (x402, USDC) Retrieves saved research charts and tables for one investment case or context assessment. Without visual_id, returns available visual and region descriptors; with visual_id, returns the selected visual’s regions. Supply region_id for available structured chart/table data, with bounded row pagination. Results preserve citations, recorded coverage, historical cutoffs and text-access restrictions. Use visual_offset for another descriptor page, without visual_id.

Input parameters

Parameter	Type	Required	Description
`belief_id`	string	No	min length 1; max length 128
`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	No	Omit to list saved visuals; supply a returned visual_id to inspect it.
`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. min 0; max 9007199254740991
`row_offset`	integer	No	Zero-based starting row or chart-point index in the selected region. min 0; max 999
`row_limit`	integer	No	Rows or chart points per read; defaults to 50, maximum 100. min 1; max 100
`visual_offset`	integer	No	Continue visual descriptors using next_visual_offset; requires belief_id and cannot accompany visual_id. min 0; max 9007199254740991

Transports

MCP: tools/call with name get_visual at https://beliefstate.ai/mcp (account access) or https://beliefstate.ai/v1/research/mcp (wallet access). See MCP integration.
x402 HTTP: POST https://beliefstate.ai/v1/research/get_visual 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": "get_visual",
    "arguments": {
      "belief_id": "00000000-0000-4000-8000-000000000001",
      "visual_id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
    }
  }
}

x402 HTTP

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

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

Contract version: 2026-11-08. Input parameters and tool metadata come from the shared executable catalog. REST API version: v1.

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