io.github.jdhart81/agent-offset-clearinghouse

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "agent-offset-clearinghouse": {
      "url": "https://mcp.viridisconservation.com/offsets/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (19)

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

  Parameters:

  • issuer (required) — string
  • project_id (required) — string
  • mass_g (required) — integer
  • price_minor_per_kg (required) — integer
  • verification_ref (required) — string
  • vintage — string
  • registry — string
  • methodology — string
  • serial_number — string
  • vcs_project_id — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • credit_id (required) — string
  • reason (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • purchase_id (required) — string
  • retirement_reason — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • buyer (required) — string
  • purchase_id (required) — string
  • mass_g (required) — integer
  • dry_run — boolean

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • buyer (required) — string
  • purchase_id (required) — string
  • budget_minor (required) — integer
  • dry_run — boolean

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • buyer (required) — string
  • since — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• net_position

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

  Parameters:

  • buyer (required) — string
  • emitted_g (required) — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• verify_certificate

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

  Parameters:

  • certificate (required) — object

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• book

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_purchase

  Fetch a past purchase / offset certificate by id.

  Parameters:

  • purchase_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • purchase_id (required) — string
  • required_g — integer

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • project_id (required) — string
  • verification_ref (required) — string
  • name — string
  • location — string
  • beneficiary — string
  • methodology — string
  • registry_ref — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • project_id — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_projects

  List all registered restoration projects with their metadata.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • project_id — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • batch_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• verify_disbursement

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• describe_agent

  Fleet-standard self-description.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.