io.github.jdhart81/agent-offset-clearinghouse

Official19 toolsLive

by jdhart81 · Python

Verified conservation credits matched to agent compute emissions — the conservation flywheel of the

io.github.jdhart81/agent-offset-clearinghouse MCP Server

This MCP server provides verified conservation credits matched to agent compute emissions, described as a “conservation flywheel.” It exposes 19 tools, including deterministic paid HTTP routes for a carbon and compliance workflow, plus multi-agent problem solving and an MCP security preflight.

🛠️ Key Features

Tool count: 19
Verified conservation credits matched to agent compute emissions
Seven deterministic paid HTTP routes covering: measure → account → disclose → claim → scan
Includes multi-agent problem solving and an MCP security preflight
Paid routes verify and settle before execution and return structured JSON plus a payment receipt

🚀 Use Cases

Carbon and compliance workflow execution (measure, account, disclose, claim, scan)
Performing MCP security preflight checks
Multi-agent problem solving tied to emissions matching

⚡ Developer Benefits

Structured JSON responses and payment receipts
Deterministic workflow steps across seven routes

⚠️ Limitations

Described as “pay-per-call” with Base pricing: x402/USDC
First paid call from a new wallet is $0.01; pricing behavior after that is not further specified beyond “unchanged list prices”

Topics

agent-securityai-agentsdeveloper-toolsmcpmcp-serverpolicy-as-codepythonsecurity-toolsx402

Captured live from the server via tools/list.

list_credit

List a conservation credit on the book. verification_ref (a D-Score / land-verification attestation) is REQUIRED — unverified credits cannot enter the book. To trade on the Verra network, pass registry="verra" with the VCS provenance (vcs_project_id, serial_number, vintage, methodology) so retirements are cross-referenceable on registry.verra.org.

Parameters10

issuer	string	required
project_id	string	required
mass_g	integer	required
price_minor_per_kg	integer	required
verification_ref	string	required
registry	string	optional
vcs_project_id	string	optional
vintage	string	optional
serial_number	string	optional
methodology	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "issuer": {
      "title": "Issuer",
      "type": "string"
    },
    "project_id": {
      "title": "Project Id",
      "type": "string"
    },
    "mass_g": {
      "title": "Mass G",
      "type": "integer"
    },
    "price_minor_per_kg": {
      "title": "Price Minor Per Kg",
      "type": "integer"
    },
    "verification_ref": {
      "title": "Verification Ref",
      "type": "string"
    },
    "registry": {
      "default": "",
      "title": "Registry",
      "type": "string"
    },
    "vcs_project_id": {
      "default": "",
      "title": "Vcs Project Id",
      "type": "string"
    },
    "vintage": {
      "default": "",
      "title": "Vintage",
      "type": "string"
    },
    "serial_number": {
      "default": "",
      "title": "Serial Number",
      "type": "string"
    },
    "methodology": {
      "default": "",
      "title": "Methodology",
      "type": "string"
    }
  },
  "required": [
    "issuer",
    "project_id",
    "mass_g",
    "price_minor_per_kg",
    "verification_ref"
  ],
  "title": "list_creditArguments"
}

delist_credit

Admin operation: remove a credit from the active fill path while retaining its listing and retirement history for audit. Idempotent for an already-delisted credit. Gateway state-change authentication is required.

Parameters2

credit_id	string	required
reason	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "credit_id": {
      "title": "Credit Id",
      "type": "string"
    },
    "reason": {
      "title": "Reason",
      "type": "string"
    }
  },
  "required": [
    "credit_id",
    "reason"
  ],
  "title": "delist_creditArguments"
}

verra_supply

The tradeable Verra VCS book: verified credits carrying genuine Verra provenance (project id + serial + vintage), cross-referenceable on registry.verra.org. Read-only. Every retirement nets the project 85% and Viridis the 15% marketplace take.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "verra_supplyArguments"
}

verra_retirement_record

Generate the Verra-portal-ready retirement record(s) for a retirement made against Verra supply — VCS project id, serial, vintage, methodology, quantity (tCO2e), beneficiary, and the registry.verra.org cross-reference. Read-only. Submit these under the Viridis Verra account to finalize the on-registry retirement (portal today; auto-posts when Verra's transaction API is live).

Parameters2

purchase_id	string	required
retirement_reason	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "purchase_id": {
      "title": "Purchase Id",
      "type": "string"
    },
    "retirement_reason": {
      "default": "",
      "title": "Retirement Reason",
      "type": "string"
    }
  },
  "required": [
    "purchase_id"
  ],
  "title": "verra_retirement_recordArguments"
}

buy_offset

Retire mass_g of verified credits for a buyer: cheapest-first matching, exactly-once (idempotent on purchase_id), returns a content-addressed offset certificate with per-fill costs. Payment settles via escrow. dry_run=true previews the exact fills/cost without mutating the book.

Parameters4

buyer	string	required
purchase_id	string	required
mass_g	integer	required
dry_run	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "buyer": {
      "title": "Buyer",
      "type": "string"
    },
    "purchase_id": {
      "title": "Purchase Id",
      "type": "string"
    },
    "mass_g": {
      "title": "Mass G",
      "type": "integer"
    },
    "dry_run": {
      "default": false,
      "title": "Dry Run",
      "type": "boolean"
    }
  },
  "required": [
    "buyer",
    "purchase_id",
    "mass_g"
  ],
  "title": "buy_offsetArguments"
}

buy_offset_budget

Money-denominated offset purchase: retire the maximum cheapest-first verified mass whose exact cost fits inside budget_minor (never overspends). Built for callers whose restoration obligation is a currency amount — e.g. a revenue share accrued in a ledger. Idempotent on purchase_id; dry_run=true previews without mutating.

Parameters4

buyer	string	required
purchase_id	string	required
budget_minor	integer	required
dry_run	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "buyer": {
      "title": "Buyer",
      "type": "string"
    },
    "purchase_id": {
      "title": "Purchase Id",
      "type": "string"
    },
    "budget_minor": {
      "title": "Budget Minor",
      "type": "integer"
    },
    "dry_run": {
      "default": false,
      "title": "Dry Run",
      "type": "boolean"
    }
  },
  "required": [
    "buyer",
    "purchase_id",
    "budget_minor"
  ],
  "title": "buy_offset_budgetArguments"
}

settlement_batch

Read-only cash-settlement summary for a buyer: the list + exact sums (purchases, mass_g, cost_minor) of their retirements, optionally since an ISO-8601 timestamp — the statement a human settles in one transfer.

Parameters2

buyer	string	required
since	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "buyer": {
      "title": "Buyer",
      "type": "string"
    },
    "since": {
      "default": "",
      "title": "Since",
      "type": "string"
    }
  },
  "required": [
    "buyer"
  ],
  "title": "settlement_batchArguments"
}

net_position

Buyer's carbon position: emitted (from agent-compute-ledger) minus retired. carbon_accountable == true when fully offset.

Parameters2

buyer	string	required
emitted_g	number	required

Raw schema

{
  "type": "object",
  "properties": {
    "buyer": {
      "title": "Buyer",
      "type": "string"
    },
    "emitted_g": {
      "title": "Emitted G",
      "type": "number"
    }
  },
  "required": [
    "buyer",
    "emitted_g"
  ],
  "title": "net_positionArguments"
}

verify_certificate

Verify an offset certificate: recompute its hash and check the ledger.

Parameters1

certificate

object

required

Raw schema

{
  "type": "object",
  "properties": {
    "certificate": {
      "additionalProperties": true,
      "title": "Certificate",
      "type": "object"
    }
  },
  "required": [
    "certificate"
  ],
  "title": "verify_certificateArguments"
}

book

The full credit book with per-credit and book-wide mass conservation totals.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "bookArguments"
}

get_purchase

Fetch a past purchase / offset certificate by id.

Parameters1

purchase_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "purchase_id": {
      "title": "Purchase Id",
      "type": "string"
    }
  },
  "required": [
    "purchase_id"
  ],
  "title": "get_purchaseArguments"
}

verify_retirement

x402-C C4 check: confirm a retirement (offset_ref = purchase_id) actually retires at least required_g grams of verified conservation credit — the check that lets a carbon receipt's neutrality claim be honored. Returns covered / retired_g / shortfall_g and the backing credits. Read-only.

Parameters2

purchase_id	string	required
required_g	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "purchase_id": {
      "title": "Purchase Id",
      "type": "string"
    },
    "required_g": {
      "default": 0,
      "title": "Required G",
      "type": "integer"
    }
  },
  "required": [
    "purchase_id"
  ],
  "title": "verify_retirementArguments"
}

register_project

Register a VERIFIED restoration project so retirements against its credits can be funded. verification_ref (D-Score / land-verification / registry id) is required — only verified conservation is funded. project_id is immutable once registered.

Parameters7

project_id	string	required
verification_ref	string	required
name	string	optional
location	string	optional
methodology	string	optional
beneficiary	string	optional
registry_ref	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "title": "Project Id",
      "type": "string"
    },
    "verification_ref": {
      "title": "Verification Ref",
      "type": "string"
    },
    "name": {
      "default": "",
      "title": "Name",
      "type": "string"
    },
    "location": {
      "default": "",
      "title": "Location",
      "type": "string"
    },
    "methodology": {
      "default": "",
      "title": "Methodology",
      "type": "string"
    },
    "beneficiary": {
      "default": "",
      "title": "Beneficiary",
      "type": "string"
    },
    "registry_ref": {
      "default": "",
      "title": "Registry Ref",
      "type": "string"
    }
  },
  "required": [
    "project_id",
    "verification_ref"
  ],
  "title": "register_projectArguments"
}

project_funding

Supply-side disbursement ledger: how much each restoration project has earned from retirements and is owed (gross_proceeds_minor + retired_g). Pass a project_id for one project, else all. Read-only — the CEO settles the actual payout. This is what makes the clearinghouse fund restoration.

Parameters1

project_id

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "default": "",
      "title": "Project Id",
      "type": "string"
    }
  },
  "title": "project_fundingArguments"
}

list_projects

List all registered restoration projects with their metadata.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "list_projectsArguments"
}

disbursement_schedule

Automated disbursement preview: for each verified restoration project, splits its newly-accrued proceeds into the Viridis Conservation withhold (default 15%, seeds the software/business) and the project payout (85%). Read-only. Funded-but-unregistered projects are surfaced separately as pending_registration (can't pay an unverified project).

Parameters1

project_id

string

optional

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "default": "",
      "title": "Project Id",
      "type": "string"
    }
  },
  "title": "disbursement_scheduleArguments"
}

certify_disbursement

Freeze the current disbursement schedule into a certified, tamper-evident batch (content-addressed, hash-chained). Idempotent on batch_id; only newly-accrued proceeds for verified projects are certified (never disbursed twice). This is the certified investment record the CEO executes the actual Stripe transfers against.

Parameters1

batch_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "batch_id": {
      "title": "Batch Id",
      "type": "string"
    }
  },
  "required": [
    "batch_id"
  ],
  "title": "certify_disbursementArguments"
}

verify_disbursement

Recompute the disbursement certificate hash chain and confirm whole-book conservation of disbursed proceeds. Any party can audit disbursements.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "verify_disbursementArguments"
}

describe_agent

Fleet-standard self-description.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "title": "describe_agentArguments"
}

README.md2 KBView on GitHub

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) 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.txt
python3 agent-escrow-agent/adapters/mcp_server.py          # stdio MCP
python3 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.

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.

Install

Tools (19)

list_creditdelist_creditverra_supplyverra_retirement_recordbuy_offsetbuy_offset_budgetsettlement_batchnet_position

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.viridisconservation.com/offsets/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "agent-offset-clearinghouse": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.viridisconservation.com/offsets/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.jdhart81/agent-offset-clearinghouse MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

list_credit

delist_credit

verra_supply

verra_retirement_record

buy_offset

buy_offset_budget

settlement_batch

net_position

verify_certificate

book

get_purchase

verify_retirement

register_project

project_funding

list_projects

disbursement_schedule

certify_disbursement

verify_disbursement

describe_agent

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

Run an agent locally (free, forever)

Or use the hosted fleet

Boundary

Install

Remote endpoint

Related servers