Servers Playground How we check Add a server Log in

Agent Offset Clearinghouse

Working · 108 ms

io.github.jdhart81/agent-offset-clearinghousev0.6.0

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

Finance & Payments

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

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

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

book

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

This tool takes no arguments.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Agent Offset Clearinghouse MCP server | mcptry

Tools (19)

book

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

No arguments.

Input schema (JSON)

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

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.

Argument	Type	Description
buyer*	string
mass_g*	integer
dry_run	boolean
purchase_id*	string

Input schema (JSON)

{
  "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"
    }
  }
}

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.

Argument	Type	Description
buyer*	string
dry_run	boolean
purchase_id*	string
budget_minor*	integer

Input schema (JSON)

{
  "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"
    }
  }
}

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.

Argument	Type	Description
batch_id*	string

Input schema (JSON)

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

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.

Argument	Type	Description
reason*	string
credit_id*	string

Input schema (JSON)

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

describe_agent

Fleet-standard self-description.

No arguments.

Input schema (JSON)

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

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

Argument	Type	Description
project_id	string

Input schema (JSON)

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

get_purchase

Fetch a past purchase / offset certificate by id.

Argument	Type	Description
purchase_id*	string

Input schema (JSON)

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

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.

Argument	Type	Description
issuer*	string
mass_g*	integer
vintage	string
registry	string
project_id*	string
methodology	string
serial_number	string
vcs_project_id	string
verification_ref*	string
price_minor_per_kg*

list_projects

List all registered restoration projects with their metadata.

No arguments.

Input schema (JSON)

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

net_position

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

Argument	Type	Description
buyer*	string
emitted_g*	number

Input schema (JSON)

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

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.

Argument	Type	Description
project_id	string

Input schema (JSON)

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

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.

Argument	Type	Description
name	string
location	string
project_id*	string
beneficiary	string
methodology	string
registry_ref	string
verification_ref*	string

Input schema (JSON)

{
  "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"
    }
  }
}

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.

Argument	Type	Description
buyer*	string
since	string

Input schema (JSON)

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

verify_certificate

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

Argument	Type	Description
certificate*	object

Input schema (JSON)

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

verify_disbursement

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

No arguments.

Input schema (JSON)

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

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.

Argument	Type	Description
required_g	integer
purchase_id*	string

Input schema (JSON)

{
  "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"
    }
  }
}

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

Argument	Type	Description
purchase_id*	string
retirement_reason	string

Input schema (JSON)

{
  "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": ""
    }
  }
}

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.

No arguments.

Input schema (JSON)

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