Servidor MCP

agent-offset-clearinghouse

io.github.jdhart81/agent-offset-clearinghouse
Negocio y operaciones Finanzas e inversión Público y accesible MCP 2025-11-25

Qué hace este 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.
Esquema de entrada
{'type': 'object', 'title': 'bookArguments', 'properties': {}}
Esquema de salida
{'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.
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Esquema de entrada
{'type': 'object', 'title': 'certify_disbursementArguments', 'required': ['batch_id'], 'properties': {'batch_id': {'type': 'string', 'title': 'Batch Id'}}}
Esquema de salida
{'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.
Esquema de entrada
{'type': 'object', 'title': 'delist_creditArguments', 'required': ['credit_id', 'reason'], 'properties': {'reason': {'type': 'string', 'title': 'Reason'}, 'credit_id': {'type': 'string', 'title': 'Credit Id'}}}
Esquema de salida
{'type': 'object', 'title': 'delist_creditOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
describe_agent
Fleet-standard self-description.
Esquema de entrada
{'type': 'object', 'title': 'describe_agentArguments', 'properties': {}}
Esquema de salida
{'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).
Esquema de entrada
{'type': 'object', 'title': 'disbursement_scheduleArguments', 'properties': {'project_id': {'type': 'string', 'title': 'Project Id', 'default': ''}}}
Esquema de salida
{'type': 'object', 'title': 'disbursement_scheduleOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_purchase
Fetch a past purchase / offset certificate by id.
Esquema de entrada
{'type': 'object', 'title': 'get_purchaseArguments', 'required': ['purchase_id'], 'properties': {'purchase_id': {'type': 'string', 'title': 'Purchase Id'}}}
Esquema de salida
{'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.
Esquema de entrada
{'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'}}}
Esquema de salida
{'type': 'object', 'title': 'list_creditOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
list_projects
List all registered restoration projects with their metadata.
Esquema de entrada
{'type': 'object', 'title': 'list_projectsArguments', 'properties': {}}
Esquema de salida
{'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.
Esquema de entrada
{'type': 'object', 'title': 'net_positionArguments', 'required': ['buyer', 'emitted_g'], 'properties': {'buyer': {'type': 'string', 'title': 'Buyer'}, 'emitted_g': {'type': 'number', 'title': 'Emitted G'}}}
Esquema de salida
{'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.
Esquema de entrada
{'type': 'object', 'title': 'project_fundingArguments', 'properties': {'project_id': {'type': 'string', 'title': 'Project Id', 'default': ''}}}
Esquema de salida
{'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.
Esquema de entrada
{'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'}}}
Esquema de salida
{'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.
Esquema de entrada
{'type': 'object', 'title': 'settlement_batchArguments', 'required': ['buyer'], 'properties': {'buyer': {'type': 'string', 'title': 'Buyer'}, 'since': {'type': 'string', 'title': 'Since', 'default': ''}}}
Esquema de salida
{'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.
Esquema de entrada
{'type': 'object', 'title': 'verify_certificateArguments', 'required': ['certificate'], 'properties': {'certificate': {'type': 'object', 'title': 'Certificate', 'additionalProperties': True}}}
Esquema de salida
{'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.
Esquema de entrada
{'type': 'object', 'title': 'verify_disbursementArguments', 'properties': {}}
Esquema de salida
{'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.
Esquema de entrada
{'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'}}}
Esquema de salida
{'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).
Esquema de entrada
{'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': ''}}}
Esquema de salida
{'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.
Esquema de entrada
{'type': 'object', 'title': 'verra_supplyArguments', 'properties': {}}
Esquema de salida
{'type': 'object', 'title': 'verra_supplyOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
Añadido
describe_agent
17 de September de 2026 a las 12:42
Añadido
verify_disbursement
17 de September de 2026 a las 12:42
Añadido
certify_disbursement
17 de September de 2026 a las 12:42
Añadido
disbursement_schedule
17 de September de 2026 a las 12:42
Añadido
list_projects
17 de September de 2026 a las 12:42
Añadido
project_funding
17 de September de 2026 a las 12:42
Añadido
register_project
17 de September de 2026 a las 12:42
Añadido
verify_retirement
17 de September de 2026 a las 12:42
Añadido
get_purchase
17 de September de 2026 a las 12:42
Añadido
book
17 de September de 2026 a las 12:42
Añadido
verify_certificate
17 de September de 2026 a las 12:42
Añadido
net_position
17 de September de 2026 a las 12:42
Añadido
settlement_batch
17 de September de 2026 a las 12:42
Añadido
buy_offset_budget
17 de September de 2026 a las 12:42
Añadido
buy_offset
17 de September de 2026 a las 12:42
Añadido
verra_retirement_record
17 de September de 2026 a las 12:42
Añadido
verra_supply
17 de September de 2026 a las 12:42
Añadido
delist_credit
17 de September de 2026 a las 12:42
Añadido
list_credit
17 de September de 2026 a las 12:42