Serveur MCP

agent-offset-clearinghouse

io.github.jdhart81/agent-offset-clearinghouse

Ce que fait ce MCP

Manages verified conservation credits, offset purchases and retirements, certificates, buyer positions, project funding, disbursement schedules, and audit verification.

book
The full credit book with per-credit and book-wide mass conservation totals.
Schéma d’entrée
{'type': 'object', 'title': 'bookArguments', 'properties': {}}
Schéma de sortie
{'type': 'object', 'title': 'bookOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Schéma d’entrée
{'type': 'object', 'title': 'buy_offsetArguments', 'required': ['buyer', 'purchase_id', 'mass_g'], 'properties': {'buyer': {'type': 'string', 'title': 'Buyer'}, 'mass_g': {'type': 'integer', 'title': 'Mass G'}, 'dry_run': {'type': 'boolean', 'title': 'Dry Run', 'default': False}, 'purchase_id': {'type': 'string', 'title': 'Purchase Id'}}}
Schéma de sortie
{'type': 'object', 'title': 'buy_offsetOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Schéma d’entrée
{'type': 'object', 'title': 'buy_offset_budgetArguments', 'required': ['buyer', 'purchase_id', 'budget_minor'], 'properties': {'buyer': {'type': 'string', 'title': 'Buyer'}, 'dry_run': {'type': 'boolean', 'title': 'Dry Run', 'default': False}, 'purchase_id': {'type': 'string', 'title': 'Purchase Id'}, 'budget_minor': {'type': 'integer', 'title': 'Budget Minor'}}}
Schéma de sortie
{'type': 'object', 'title': 'buy_offset_budgetOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Schéma d’entrée
{'type': 'object', 'title': 'certify_disbursementArguments', 'required': ['batch_id'], 'properties': {'batch_id': {'type': 'string', 'title': 'Batch Id'}}}
Schéma de sortie
{'type': 'object', 'title': 'certify_disbursementOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Schéma d’entrée
{'type': 'object', 'title': 'delist_creditArguments', 'required': ['credit_id', 'reason'], 'properties': {'reason': {'type': 'string', 'title': 'Reason'}, 'credit_id': {'type': 'string', 'title': 'Credit Id'}}}
Schéma de sortie
{'type': 'object', 'title': 'delist_creditOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
describe_agent
Fleet-standard self-description.
Schéma d’entrée
{'type': 'object', 'title': 'describe_agentArguments', 'properties': {}}
Schéma de sortie
{'type': 'object', 'title': 'describe_agentOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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).
Schéma d’entrée
{'type': 'object', 'title': 'disbursement_scheduleArguments', 'properties': {'project_id': {'type': 'string', 'title': 'Project Id', 'default': ''}}}
Schéma de sortie
{'type': 'object', 'title': 'disbursement_scheduleOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_purchase
Fetch a past purchase / offset certificate by id.
Schéma d’entrée
{'type': 'object', 'title': 'get_purchaseArguments', 'required': ['purchase_id'], 'properties': {'purchase_id': {'type': 'string', 'title': 'Purchase Id'}}}
Schéma de sortie
{'type': 'object', 'title': 'get_purchaseOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Schéma d’entrée
{'type': 'object', 'title': 'list_creditArguments', 'required': ['issuer', 'project_id', 'mass_g', 'price_minor_per_kg', 'verification_ref'], 'properties': {'issuer': {'type': 'string', 'title': 'Issuer'}, 'mass_g': {'type': 'integer', 'title': 'Mass G'}, 'vintage': {'type': 'string', 'title': 'Vintage', 'default': ''}, 'registry': {'type': 'string', 'title': 'Registry', 'default': ''}, 'project_id': {'type': 'string', 'title': 'Project Id'}, 'methodology': {'type': 'string', 'title': 'Methodology', 'default': ''}, 'serial_number': {'type': 'string', 'title': 'Serial Number', 'default': ''}, 'vcs_project_id': {'type': 'string', 'title': 'Vcs Project Id', 'default': ''}, 'verification_ref': {'type': 'string', 'title': 'Verification Ref'}, 'price_minor_per_kg': {'type': 'integer', 'title': 'Price Minor Per Kg'}}}
Schéma de sortie
{'type': 'object', 'title': 'list_creditOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
list_projects
List all registered restoration projects with their metadata.
Schéma d’entrée
{'type': 'object', 'title': 'list_projectsArguments', 'properties': {}}
Schéma de sortie
{'type': 'object', 'title': 'list_projectsOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
net_position
Buyer's carbon position: emitted (from agent-compute-ledger) minus retired. carbon_accountable == true when fully offset.
Schéma d’entrée
{'type': 'object', 'title': 'net_positionArguments', 'required': ['buyer', 'emitted_g'], 'properties': {'buyer': {'type': 'string', 'title': 'Buyer'}, 'emitted_g': {'type': 'number', 'title': 'Emitted G'}}}
Schéma de sortie
{'type': 'object', 'title': 'net_positionOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Schéma d’entrée
{'type': 'object', 'title': 'project_fundingArguments', 'properties': {'project_id': {'type': 'string', 'title': 'Project Id', 'default': ''}}}
Schéma de sortie
{'type': 'object', 'title': 'project_fundingOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Schéma d’entrée
{'type': 'object', 'title': 'register_projectArguments', 'required': ['project_id', 'verification_ref'], 'properties': {'name': {'type': 'string', 'title': 'Name', 'default': ''}, 'location': {'type': 'string', 'title': 'Location', 'default': ''}, 'project_id': {'type': 'string', 'title': 'Project Id'}, 'beneficiary': {'type': 'string', 'title': 'Beneficiary', 'default': ''}, 'methodology': {'type': 'string', 'title': 'Methodology', 'default': ''}, 'registry_ref': {'type': 'string', 'title': 'Registry Ref', 'default': ''}, 'verification_ref': {'type': 'string', 'title': 'Verification Ref'}}}
Schéma de sortie
{'type': 'object', 'title': 'register_projectOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Schéma d’entrée
{'type': 'object', 'title': 'settlement_batchArguments', 'required': ['buyer'], 'properties': {'buyer': {'type': 'string', 'title': 'Buyer'}, 'since': {'type': 'string', 'title': 'Since', 'default': ''}}}
Schéma de sortie
{'type': 'object', 'title': 'settlement_batchOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
verify_certificate
Verify an offset certificate: recompute its hash and check the ledger.
Schéma d’entrée
{'type': 'object', 'title': 'verify_certificateArguments', 'required': ['certificate'], 'properties': {'certificate': {'type': 'object', 'title': 'Certificate', 'additionalProperties': True}}}
Schéma de sortie
{'type': 'object', 'title': 'verify_certificateOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
verify_disbursement
Recompute the disbursement certificate hash chain and confirm whole-book conservation of disbursed proceeds. Any party can audit disbursements.
Schéma d’entrée
{'type': 'object', 'title': 'verify_disbursementArguments', 'properties': {}}
Schéma de sortie
{'type': 'object', 'title': 'verify_disbursementOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Schéma d’entrée
{'type': 'object', 'title': 'verify_retirementArguments', 'required': ['purchase_id'], 'properties': {'required_g': {'type': 'integer', 'title': 'Required G', 'default': 0}, 'purchase_id': {'type': 'string', 'title': 'Purchase Id'}}}
Schéma de sortie
{'type': 'object', 'title': 'verify_retirementOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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).
Schéma d’entrée
{'type': 'object', 'title': 'verra_retirement_recordArguments', 'required': ['purchase_id'], 'properties': {'purchase_id': {'type': 'string', 'title': 'Purchase Id'}, 'retirement_reason': {'type': 'string', 'title': 'Retirement Reason', 'default': ''}}}
Schéma de sortie
{'type': 'object', 'title': 'verra_retirement_recordOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Schéma d’entrée
{'type': 'object', 'title': 'verra_supplyArguments', 'properties': {}}
Schéma de sortie
{'type': 'object', 'title': 'verra_supplyOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
Ajouté
describe_agent
17 September 2026 12:42
Ajouté
verify_disbursement
17 September 2026 12:42
Ajouté
certify_disbursement
17 September 2026 12:42
Ajouté
disbursement_schedule
17 September 2026 12:42
Ajouté
list_projects
17 September 2026 12:42
Ajouté
project_funding
17 September 2026 12:42
Ajouté
register_project
17 September 2026 12:42
Ajouté
verify_retirement
17 September 2026 12:42
Ajouté
get_purchase
17 September 2026 12:42
Ajouté
book
17 September 2026 12:42
Ajouté
verify_certificate
17 September 2026 12:42
Ajouté
net_position
17 September 2026 12:42
Ajouté
settlement_batch
17 September 2026 12:42
Ajouté
buy_offset_budget
17 September 2026 12:42
Ajouté
buy_offset
17 September 2026 12:42
Ajouté
verra_retirement_record
17 September 2026 12:42
Ajouté
verra_supply
17 September 2026 12:42
Ajouté
delist_credit
17 September 2026 12:42
Ajouté
list_credit
17 September 2026 12:42