Settlement Engine
Progressive settlement for outcome-based capital: what is decided, what the remainder must do.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (2)
- LOWin list_series
- LOWin describe_agent
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"settlement-engine": {
"url": "https://mcp.viridisconservation.com/settlement-engine/mcp"
}
}
}Remote-Endpunkte
https://mcp.viridisconservation.com/settlement-engine/mcpstreamable-httpWas es kann
Tool-Inventar
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).
Eingabe-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"
}Ausgabe-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).
Eingabe-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"
}Ausgabe-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).
Eingabe-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"
}Ausgabe-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.
Eingabe-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"
}Ausgabe-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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"title": "decided_strikesArguments"
}Ausgabe-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).
Eingabe-Schema
{
"type": "object",
"properties": {
"series_id": {
"title": "Series Id",
"type": "string",
"description": "The series id returned by register_series."
}
},
"required": [
"series_id"
],
"title": "explainArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "explainOutput"
}🔴list_series
FREE: registered series cards.
Eingabe-Schema
{
"type": "object",
"properties": {},
"title": "list_seriesArguments"
}Ausgabe-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.
Eingabe-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"
}Ausgabe-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.
Eingabe-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"
}Ausgabe-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).
Eingabe-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"
}Ausgabe-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).
Eingabe-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"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "verify_settlementOutput"
}🔴describe_agent
FREE: actions, invariants S1–S10 and limits.
Eingabe-Schema
{
"type": "object",
"properties": {},
"title": "describe_agentArguments"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "describe_agentOutput"
}Community
Nachweis