Settlement Engine
Progressive settlement for outcome-based capital: what is decided, what the remainder must do.
¿Debería usar esto?
Calidad y seguridad
Hallazgos (2)
- LOWen list_series
- LOWen describe_agent
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"settlement-engine": {
"url": "https://mcp.viridisconservation.com/settlement-engine/mcp"
}
}
}Puntos de conexión remotos
https://mcp.viridisconservation.com/settlement-engine/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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).
Esquema de entrada
{
"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"
}Esquema de salida
{
"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).
Esquema de entrada
{
"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"
}Esquema de salida
{
"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).
Esquema de entrada
{
"type": "object",
"properties": {
"series_id": {
"title": "Series Id",
"type": "string",
"description": "The series id returned by register_series."
}
},
"required": [
"series_id"
],
"title": "period_statusArguments"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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.
Esquema de entrada
{
"type": "object",
"properties": {},
"title": "decided_strikesArguments"
}Esquema de salida
{
"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).
Esquema de entrada
{
"type": "object",
"properties": {
"series_id": {
"title": "Series Id",
"type": "string",
"description": "The series id returned by register_series."
}
},
"required": [
"series_id"
],
"title": "explainArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "explainOutput"
}🔴list_series
FREE: registered series cards.
Esquema de entrada
{
"type": "object",
"properties": {},
"title": "list_seriesArguments"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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.
Esquema de entrada
{
"type": "object",
"properties": {
"contract_id": {
"title": "Contract Id",
"type": "string",
"description": "The contract id returned by compile_contract."
}
},
"required": [
"contract_id"
],
"title": "get_contractArguments"
}Esquema de salida
{
"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).
Esquema de entrada
{
"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"
}Esquema de salida
{
"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).
Esquema de entrada
{
"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"
}Esquema de salida
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "verify_settlementOutput"
}🔴describe_agent
FREE: actions, invariants S1–S10 and limits.
Esquema de entrada
{
"type": "object",
"properties": {},
"title": "describe_agentArguments"
}Esquema de salida
{
"type": "object",
"properties": {
"result": {
"title": "Result",
"type": "string"
}
},
"required": [
"result"
],
"title": "describe_agentOutput"
}Comunidad
Evidencia