Repository navigation
Conversation
Adds skills/wallet-mcp/plugins/carbonmark.md: retire tokenized carbon credits on Base through Carbonmark's x402 Carbon Retirement API. The plugin reads supply and prices over HTTP GET, fetches an unsigned [approve, retire] batch, submits it with send_calls, and resolves the public Carbonmark certificate for the confirmed transaction. Appends three new tags (carbon-credits, carbon-retirement, climate) to the tag vocabulary in plugin-spec.md, as Contribution Scope asks. Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
🟡 Heimdall Review Status
|
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Adds a Carbonmark plugin (
skills/wallet-mcp/plugins/carbonmark.md) so a Wallet MCP user can retire tokenized carbon credits on Base and receive a public certificate. No current plugin covers carbon credits.How it works:
get_wallets→ wallet address.GET https://x402.klimalabs.com/api/discover→ retirable supply with live USDC prices per tonne (pooled carbon classes and fixed-price marketplace listings).GET /api/quote→ price, fee and total for the requested tonnes.GET /api/prepare/retire→ an unsigned, ordered[approve, retire]batch plus the authoritative quote.send_callsonbase.get_request_status→ transaction hash →GET /api/certificate→ the certificate URL onapp.carbonmark.com.Frontmatter:
integration: http-api,chains: [base],allowlist: [x402.klimalabs.com],auth: none,risk: [irreversible]. Every call is a GET with all parameters in the query string, so the user-paste fallback inreferences/custom-plugins.mdworks while the host is not allowlisted.Per Contribution Scope, the diff is the plugin file plus three new tags (
carbon-credits,carbon-retirement,climate) appended to the vocabulary inplugin-spec.md. TheSKILL.mdregistry table is left to maintainers.This replaces the earlier submission base/skills#102, which targeted the
base-mcpskill before it moved to this repository. The plugin text is that file, maintained by the endpoint's developers, with the wording moved from Base MCP to Wallet MCP, the plugin renamed fromklimatocarbonmark, and two details corrected against the live API (thecreditfilter ondiscover, and whole-tonne minimums being per class rather than Puro-only).Change type
Validation
Run, on 2026-11-17 against production (
x402.klimalabs.com), with read-only calls:http-apiin canonical order with canonical names, and every relative link and#anchorresolving.discover: response fields named in the plugin are present (carbonClasses[],marketplaceListings[],marketplaceEnabled,creditsDetailed[].liquidityFormatted,minRetirementTonnesFormatted,leftToSellFormatted,minFillFormatted).maxUsdcPricePerTonne=15narrowed 6 classes to 4. An unknown parameter, includingchainId, returns400 schema_validation.quote: 0.001 t returned price,fee,total,suggestedMaxInput(total × 1.04),humanSummary,resolvedCreditandalternatives.prepare/retire: returnedchain: "base"andtransactions[]of exactlyapprove(to USDC) thenprepareRetire(to the Settlement Contract, which is alsoapprovalInstructions.spender), both withvalue: "0x0", with and without adetailsobject.chainId=84532→400 unsupported_chain_id;chainId=1→400 schema_validation; 0.5 t of a whole-tonne class →422 amount_not_whole_tonneswithnearestUpTonnes;certificatefor an unknown hash →404 retirement_not_found.python3 -m unittest discover -s testson Windows: 32 of 38 pass. The other 6 fail identically on an unmodified checkout ofmain(symlink privilege, CRLF checkout and code-page errors), so they are not caused by this change. Not run on Linux.Not run:
get_wallets,send_callsandget_request_statuswere not exercised and no transaction was signed for this PR. The earlier submission reported the same approve + retire batch as tested under Base MCP; it has not been re-run under Wallet MCP. It is unverified whetherget_request_statusreturns the on-chain transaction hash that/api/certificateneeds.x402.klimalabs.comis on theweb_requestallowlist.plugin-reviewskill referenced inplugin-spec.mdis not in the repository, so it was not run.Checklist (harness and packaging items do not apply to a plugin file):
Release considerations
SKILL.mdplugin table and whether to allowlistx402.klimalabs.comforweb_request.🤖 Generated with Claude Code