Settlement Engine

io.github.jdhart81Published by GitHub account jdhart81v0.1.0Updated Nov 11, 2026

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

The publisher's own server: Energyai

VerifiedStreamable HTTPWeb executableFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Settles outcome-based contracts against published data series, showing what is already decided and what the remaining observations must do.

What you can do
  • Register series and append observations with source URL and hash, logging revisions
  • Inspect period status, required remainder and which strikes are decided by arithmetic alone
  • Compile content-addressed outcome contracts with a strike, settlement rule and closing time
  • Settle contracts as YES, NO or UNDECIDED and verify settlements by recomputing from stored evidence
  • List series, explain a series in plain language, and describe the agent's actions and limits
When to use it
Useful when an assistant must track a progressively published series (prices, counts, survival, canopy, soil carbon) and report whether a grant, pay-for-success agreement or similar contract is already decided or what the remaining data must show.
Requirements
Remote streamable HTTP endpoint; no authentication, environment variables or headers are declared. The free tier is documented as 10 calls per day per service, and some tools are marked paid. The core is also open source and can be self-hosted with Python.
Before you install
Two tools, compile_contract and settle_contract, are marked PAID, so calls may incur charges. Ingesting observations writes to a ledger and re-posted slots replace values, though revisions are logged. Settlements are immutable once recorded. The hosted service layer, including payments and customer data, is proprietary.

Installation

In SourceWeft

  1. Open Settlement Engine in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.jdhart81%2Fsettlement-engine/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "settlement-engine": {
      "type": "http",
      "url": "https://mcp.viridisconservation.com/settlement-engine/mcp"
    }
  }
}

README

Viridis Agent Fleet: open-source agents for the agent economy

Deterministic, auditable MCP agents: trust and settlement rails (identity, trust, escrow, metering, arbitration, notary, surety, provenance, covenant, offsets, compute-ledger), a free conservation-valuation rail (eco-funding: ecological complexity with re-runnable receipts), and priced-grade services (tax credits, GHG accounting, construction takeoff, measurement, compliance). Every core is pure Python with no LLM in the serving path, and every result is content-addressed so anyone can re-verify it.

Licensed Apache-2.0. Run any agent yourself, fork it, embed it.

Run an agent locally (free, forever)

bash
pip install -r requirements-dev.txtpython3 agent-escrow-agent/adapters/mcp_server.py          # stdio MCPpython3 run_fleet_tests.py                                 # every agent's invariant tests

Or use the hosted fleet

https://mcp.viridisconservation.com runs all agents as one managed MCP service:

Self-hosted (this repo)Hosted by Viridis
Agent logic & verification✅ identical✅ identical
Viridis-signed receipts & notary chain–✅
Shared trust/reputation network data–✅
Maintained rule packs (tax, GHG factors, regs)snapshot✅ kept current
Payments (x402, card), seats, SLA–✅

Free tier: 10 calls/day per service; the rails (identity, escrow, metering…) are free forever. Verification is always free.

Registry servers with their own docs

Each registered MCP server has a README with its tools, inputs and outputs, an example, client config and pricing:

Registry nameRemote endpointDocs
io.github.jdhart81/security-preflighthttps://mcp.viridis-security.com/security-preflight/mcpsecurity-preflight-agent/README.md
io.github.jdhart81/regulatory-radarhttps://mcp.viridisconservation.com/regulatory-radar/mcpregulatory-radar-agent/README.md
io.github.jdhart81/ghg-ledgerhttps://mcp.viridisconservation.com/ghg-ledger/mcpghg-ledger-agent/README.md

Connecting any hosted server (Claude, ChatGPT, VS Code, APIs), payments and ownership: docs/HOSTED_MCP.md.

For agents

Agents and LLM tools can start from llms.txt, a generated index of every agent, and AGENTS.md, the rules for using and changing the fleet.

Part of the Viridis open-source commons

Building agents for conservation or energy work? VergeCommon and EnergyAI MCP also expose MCP tools, and ViridisOS serves its decision functions to agents over MCP.

This project is one of a connected set of open tools from Viridis. Each stands on its own; together they run from field evidence to checked decisions.

Conservation commons

Verifiable science

  • Viridis Canon: machine-checked Lean 4 mathematics for ecological decisions, with a DOI for every result
  • ViridisOS: open reference runtime for DOI-backed decision modules and recomputable results
  • Viridis Research: the nightly public research record, each claim labeled by what a verifier actually checked
  • ProofLens: see what a Lean statement means before reading the proof

Agent tools

  • Viridis Agent Fleet (this repository): open-source MCP agents with deterministic, auditable cores
  • EnergyAI MCP: energy-planning estimates and incentive sources for AI agents

Browse every project on the Viridis profile. If this one is useful to you, a star helps other people find it.

Boundary

This repo contains agent cores, MCP adapters, tests, standards and self-host tooling. The hosted service layer (gateway, payment and settlement, seats, signing authority, operations, telemetry and customer data) is proprietary and is not in this repo. Please don't open PRs that add it.

"Viridis", "Viridis Conservation" and the Viridis marks are trademarks of Viridis LLC; see TRADEMARKS.md.

Source: README.md at commit eb9e05d

Tools

12

register_series

Register series

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).

Parametersmetanamerequiredunitrequiredsourcerequiredstrikesaggregaterequiredvalue_maxvalue_minn_expectedrequiredperiod_endrequiredperiod_startrequired

ingest

Ingest

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).

Parametersseries_idrequiredobservationsrequired

period_status

Period status

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).

Parametersseries_idrequired

required_remainder

Required remainder

FREE: what the remaining slots must average / sum to / hit for the aggregate to reach the strike, plus decided.

Parametersstrikerequiredseries_idrequired

decided_strikes

Decided strikes

FREE: every strike across registered series that is decided by the published part alone.

Takes no parameters.

explain

Explain

FREE: deterministic plain-language reading of a series (no LLM in the serving path).

Parametersseries_idrequired

list_series

List series

FREE: registered series cards.

Takes no parameters.

compile_contract

Compile contract

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.

Parametersrulerequiredtermsstrikerequiredpartiescloses_atrequiredseries_idrequired

get_contract

Get contract

FREE: a compiled contract and its settlement ids.

Parameterscontract_idrequired

settle_contract

Settle contract

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).

Parametersnowrequiredcontract_idrequired

verify_settlement

Verify settlement

FREE: recompute a settlement from its stored evidence (hash, aggregate, result each checked separately).

Parameterssettlementsettlement_id

describe_agent

Describe this service

FREE: actions, invariants S1–S10 and limits.

Takes no parameters.

Version history

1
  1. v0.1.0LatestNov 11, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Energyaisolution integrations

Energyai

com.energyaisolutionOfficial publisher

Remote MCP server for US home-energy planning: solar production estimates, incentive guidance, Energy Node scores, cited guides and installer matching.

Streamable HTTPWeb executable
Location & Lifestyle30 toolsOct 25, 2026

Solar Home Incentives

com.energyaisolutionOfficial publisher

Remote MCP server for US home-energy planning: solar production estimates, incentive guidance, cited guides, contractor listings and consented installer…

Streamable HTTPWeb executable
Location & Lifestyle12 toolsNov 2, 2026

Eco Funding

Published by GitHub account jdhart81

Read-only MCP server that values a site's ecological complexity, issues re-runnable receipts, and simulates pledge-pool release rules.

Streamable HTTPWeb executable
Finance5 toolsNov 8, 2026

VergeCommon

Published by GitHub account jdhart81

VergeCommon lets an assistant browse public conservation co-ops and build hypothetical pooling and benefit-sharing drafts for community land projects.

Streamable HTTPWeb executable
Location & Lifestyle5 toolsNov 7, 2026

Wavefunction Search

Published by GitHub account jdhart81

A shared "field" where AI agents post goals as intents, sense open work, route intents to agents, and record verified results.

Streamable HTTPWeb executable
Knowledge & Memory9 toolsNov 8, 2026