Settlement Engine
Progressive settlement for outcome-based capital: what is decided, what the remainder must do.
Should I use this
Quality & Safety
Findings (2)
- LOWin list_series
- LOWin describe_agent
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"settlement-engine": {
"url": "https://mcp.viridisconservation.com/settlement-engine/mcp"
}
}
}Remote endpoints
https://mcp.viridisconservation.com/settlement-engine/mcpstreamable-httpWhat it can do
Tool inventory
Tools (12)
🔴register_series(name, unit, aggregate, n_expected, source, ...)
FREE: declare a progressively published series. aggregate: mean (prices), sum (totals), share (survival/success 0/1 per slot), last (closing value). n_expected: number of observation slots in the period. value_min/value_max: the physical bounds of one observation; without them nothing is decided until the period is complete (S5).
Input Schema
{
"type": "object",
"properties": {
"name": {
"title": "Name",
"type": "string",
"description": "Name of the series."
},
"unit": {
"title": "Unit",
"type": "string",
"description": "Unit of one observation, for example USD or percent."
},
"aggregate": {
"title": "Aggregate",
"type": "string",
"description": "mean, sum, share or last."
},
"n_expected": {
"title": "N Expected",
"type": "integer",
"description": "Number of observation slots in the period."
},
"source": {
"title": "Source",
"type": "string",
"description": "Where observations are published."
},
"period_start": {
"title": "Period Start",
"type": "string",
"description": "Period start, ISO-8601."
},
"period_end": {
"title": "Period End",
"type": "string",
"description": "Period end, ISO-8601."
},
"strikes": {
"anyOf": [
{
"items": {
"type": "number"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Strikes",
"description": "Optional. Values of interest for the aggregate."
},
"value_min": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Value Min",
"description": "Optional. Lowest physically possible value of one observation."
},
"value_max": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"title": "Value Max",
"description": "Optional. Highest physically possible value of one observation."
},
"meta": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Meta",
"description": "Optional. Extra description of the series."
}
},
"required": [
"name",
"unit",
"aggregate",
"n_expected",
"source",
"period_start",
"period_end"
],
"title": "register_seriesArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "register_seriesOutput"
}🔴ingest(series_id, observations)
FREE: append observations [{slot, value, source_url, source_sha256 (64 hex of the source document), observed_at}]. A re-posted slot replaces the value and is logged as a revision (S7). Each observation is hashed (S4).
Input Schema
{
"type": "object",
"properties": {
"series_id": {
"title": "Series Id",
"type": "string",
"description": "The series id returned by register_series."
},
"observations": {
"items": {
"additionalProperties": true,
"type": "object"
},
"title": "Observations",
"type": "array",
"description": "[{slot, value, source_url, source_sha256, observed_at}]."
}
},
"required": [
"series_id",
"observations"
],
"title": "ingestArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "ingestOutput"
}🔴period_status(series_id)
FREE: published share, published aggregate, remaining slots, and per strike the required remainder, the decided flag (arithmetic + declared bounds only) and a labelled model estimate kept separate from the facts (S1).
Input Schema
{
"type": "object",
"properties": {
"series_id": {
"title": "Series Id",
"type": "string",
"description": "The series id returned by register_series."
}
},
"required": [
"series_id"
],
"title": "period_statusArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "period_statusOutput"
}🔴required_remainder(series_id, strike)
FREE: what the remaining slots must average / sum to / hit for the aggregate to reach the strike, plus decided.
Input Schema
{
"type": "object",
"properties": {
"series_id": {
"title": "Series Id",
"type": "string",
"description": "The series id returned by register_series."
},
"strike": {
"title": "Strike",
"type": "number",
"description": "The strike value."
}
},
"required": [
"series_id",
"strike"
],
"title": "required_remainderArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "required_remainderOutput"
}🔴decided_strikes
FREE: every strike across registered series that is decided by the published part alone.
Input Schema
{
"type": "object",
"properties": {},
"title": "decided_strikesArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "decided_strikesOutput"
}🔴explain(series_id)
FREE: deterministic plain-language reading of a series (no LLM in the serving path).
Input Schema
{
"type": "object",
"properties": {
"series_id": {
"title": "Series Id",
"type": "string",
"description": "The series id returned by register_series."
}
},
"required": [
"series_id"
],
"title": "explainArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "explainOutput"
}🔴list_series
FREE: registered series cards.
Input Schema
{
"type": "object",
"properties": {},
"title": "list_seriesArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "list_seriesOutput"
}🔴compile_contract(series_id, strike, rule, closes_at, parties, ...)
PAID: compile a Verified Outcome Contract v0 — a series, a strike, a settlement rule (above | at_or_above | below | at_or_below) and a closing time, content-addressed; the contract_id is the sha256 of its canonical form.
Input Schema
{
"type": "object",
"properties": {
"series_id": {
"title": "Series Id",
"type": "string",
"description": "The series id returned by register_series."
},
"strike": {
"title": "Strike",
"type": "number",
"description": "The strike value."
},
"rule": {
"title": "Rule",
"type": "string",
"description": "above, at_or_above, below or at_or_below."
},
"closes_at": {
"title": "Closes At",
"type": "string",
"description": "When the contract closes, ISO-8601."
},
"parties": {
"anyOf": [
{
"additionalProperties": {
"type": "string"
},
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Parties",
"description": "Optional. The parties, as an object."
},
"terms": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Terms",
"description": "Optional. Contract terms in words."
}
},
"required": [
"series_id",
"strike",
"rule",
"closes_at"
],
"title": "compile_contractArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "compile_contractOutput"
}🔴get_contract(contract_id)
FREE: a compiled contract and its settlement ids.
Input Schema
{
"type": "object",
"properties": {
"contract_id": {
"title": "Contract Id",
"type": "string",
"description": "The contract id returned by compile_contract."
}
},
"required": [
"contract_id"
],
"title": "get_contractArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "get_contractOutput"
}🔴settle_contract(contract_id, now)
PAID: evaluate a contract against the ledger at an explicit time: YES / NO / UNDECIDED with the exact arithmetic and every observation hash used. A decided strike settles before closure; an incomplete, undecided series at closure is UNDECIDED, never a guess (S10). Settlements are immutable and recomputable (S8).
Input Schema
{
"type": "object",
"properties": {
"contract_id": {
"title": "Contract Id",
"type": "string",
"description": "The contract id returned by compile_contract."
},
"now": {
"title": "Now",
"type": "string",
"description": "The evaluation time, ISO-8601."
}
},
"required": [
"contract_id",
"now"
],
"title": "settle_contractArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "settle_contractOutput"
}🔴verify_settlement(settlement_id, settlement)
FREE: recompute a settlement from its stored evidence (hash, aggregate, result each checked separately).
Input Schema
{
"type": "object",
"properties": {
"settlement_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Settlement Id",
"description": "A settlement id; give this or the settlement object."
},
"settlement": {
"anyOf": [
{
"additionalProperties": true,
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"title": "Settlement",
"description": "A settlement object; give this or settlement_id."
}
},
"title": "verify_settlementArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "verify_settlementOutput"
}🔴describe_agent
FREE: actions, invariants S1–S10 and limits.
Input Schema
{
"type": "object",
"properties": {},
"title": "describe_agentArguments"
}Output Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "describe_agentOutput"
}Community
Evidence