Result envelope

Every tool returns this object as structuredContent and as JSON text. Tools declare it as their outputSchema.

Fields

string

required

Always result/v1.

string

required

The tool that produced the result.

string

required

ok, partial (a preview; the full result is stored) or error.

string

One sentence describing the result.

any

The machine payload, always JSON. Numbers are numbers, dates are ISO-8601, NaN and infinity are null. In a partial result, lists named in truncated.lists are cut.

object[]

Presentation, in reading order. See blocks.

object[]

Stored full results.

Show artifact

string

Result id, r_ followed by 24 hex characters.

string

fincept://results/{id}, readable as an MCP resource.

string

Browser viewer at https://fincept.in/enterprise/results/{id}.

string

application/json.

integer

Size of the full result.

string

When the stored result is deleted.

object

Present when the inline result is a preview.

Show truncated

string

size.

integer

Size of this preview.

integer

Size of the full result.

string

fincept_read_result.

object[]

Each cut list: path, shown, total.

string[]

Notes about the result, such as a convergence warning.

object

Present when status is error: code, message, optional hint and details. See errors.

object

Optional context such as source, as_of and units.

Blocks

Renderers skip block types they do not know, so new types never break a client.

Type	Fields	Meaning
`text`	`format` (`markdown` or `plain`), `text`	Notes and explanations
`metrics`	`items[]`: `label`, `value`, `unit`, `delta`, `hint`	Headline numbers
`table`	`id`, `title`, `columns[]` (`name`, `type`, `unit`), `rows[][]`, `total_rows`	Tabular results
`series`	`id`, `title`, `x` (`name`, `type`), `y[]` (`name`, `unit`), `rows[][]`, `total_rows`	Data for charts
`chart`	`id`, `title`, `kind`, `series_ref`, `x`, `y[]`, `band` (`lower`, `upper`)	A chart over the `series` or `table` block named by `series_ref`
`image`	`mime`, `uri`	An image stored as an artifact
`link`	`url`, `label`	A related page

Chart kind is one of line, bar, scatter, area, hist, heatmap, candlestick. A band names the series columns that bound a shaded interval.

Forecast with a band

[
  { "type": "series", "id": "forecast", "title": "Forecast",
    "x": { "name": "date", "type": "date" },
    "y": [ { "name": "mean" }, { "name": "lower" }, { "name": "upper" } ],
    "rows": [ ["2026-10-09", 25012.4, 24610.2, 25414.6] ], "total_rows": 1 },
  { "type": "chart", "id": "forecast_chart", "title": "Forecast", "kind": "line",
    "series_ref": "forecast", "x": "date", "y": ["mean"],
    "band": { "lower": "lower", "upper": "upper" } }
]

Protocol

Toolsets

Fincept Stats

Fincept Forecast

Fincept Allocation

Fincept Portfolio Optimizer

Fincept Quant

Fields

Blocks

​Fields

​Blocks

Fields

Blocks