Settlement Engine

Progressive settlement for outcome-based capital: what is decided, what the remainder must do.

Should I use this

Quality & Safety

A
Description quality
87%
Schema completeness
79%
Naming quality
88%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (2)

  • LOWTool 'list_series' description lacks action verbin list_series
  • LOWTool 'describe_agent' description lacks action verbin describe_agent

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,352Tokens (tool definitions)
~1.5 KBTypical response size
Moderate attention impact (1.84% of 128k context)

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-http

What it can do

Tool inventory

Tools (12)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🔴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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded12 tools