CDR.fyi × EcoWealth · Agent Kit (concept: public-stats manifest, MCP tools, price-context concierge)

Read this first. Every file below is a Concept draft: none of these paths currently resolve to this content on any CDR.fyi host (see the capability brief for the exact 404/401 evidence). They are scoped strictly to CDR.fyi's own stated-free data, or (for item 3) to EcoWealth's own domain using CDR.fyi's already-public numbers.

1 · Public-stats agent card

www.cdr.fyi/.well-known/agent-card.json Concept

Standard Agent2Agent card describing only the free surface (leaderboard headline totals and market-update figures) matching exactly what llms.txt already promises is public. No skill here touches order-level detail or anything Portal-gated.

{
  "protocolVersion": "0.3",
  "name": "CDR.fyi Public Market Data",
  "description": "Read-only durable-CDR market headline statistics: cumulative tonnes sold/delivered, spend, purchaser/supplier counts, leaderboard summaries. Free content only: Portal/API detail requires a Data Partner or Team+ key, per cdr.fyi/llms.txt.",
  "url": "https://www.cdr.fyi",
  "provider": { "organization": "CDR.fyi" },
  "capabilities": { "streaming": false, "pushNotifications": false },
  "skills": [
    {
      "id": "get-market-headline-stats",
      "name": "Get Market Headline Statistics",
      "description": "Cumulative tonnes sold, tonnes delivered, total spend, purchaser/supplier counts, as of the request date. Free tier only.",
      "tags": ["carbon-removal", "market-data", "public"],
      "examples": ["How many tonnes of durable CDR has been sold cumulatively?"]
    },
    {
      "id": "get-leaderboard-summary",
      "name": "Get Leaderboard Summary",
      "description": "Top N suppliers/purchasers/marketplaces by tonnes, optionally filtered by method. Mirrors the public /leaderboards page.",
      "tags": ["carbon-removal", "leaderboard", "public"],
      "examples": ["Who are the top 5 durable-CDR suppliers by tonnes delivered?"]
    }
  ]
}

2 · MCP (the interface an AI assistant calls to use a service correctly) tool schemas: free tier only

tools.json: for any MCP-capable agent host Concept

Same two skills as the agent card, expressed as MCP tool definitions. Deliberately does not attempt to model the gated Orders/Suppliers/Purchasers/Marketplaces collections behind api.cdr.fyi: that surface is real, already documented at docs.cdr.fyi, and correctly requires a partner key.

{
  "tools": [
    { "name": "cdrfyi_get_market_headline_stats",
      "description": "Free-tier cumulative market statistics (tonnes sold, tonnes delivered, spend, purchaser/supplier counts). Mirrors cdr.fyi homepage.",
      "inputSchema": { "type": "object", "properties": {} } },
    { "name": "cdrfyi_get_leaderboard_summary",
      "description": "Top-N suppliers, purchasers, or marketplace/services leaderboard, optionally filtered by method (Biochar/BECCS/DACCS/Enhanced Weathering/Mineralization/Marine).",
      "inputSchema": { "type": "object", "properties": {
        "board": { "type": "string", "enum": ["suppliers", "purchasers", "services"] },
        "method": { "type": "string" },
        "limit": { "type": "integer", "default": 5 } },
        "required": ["board"] } }
  ]
}

3 · CDR price-context object

vealth.net/.well-known/vealth/cdr-price-context: proposed, on EcoWealth's own domain Concept

Not a CDR.fyi file. A small, attributed re-packaging of CDR.fyi × OPIS's own published pricing-survey PDF/blog numbers (public pages, not Portal content) into one agent-callable object, with an explicit note that it does not price nature-based or micro-scale credits. Full JSON shown on the previous page (agent-ready, Addition 2); referenced here as the third kit item because it completes the same three-layer pattern (agent card / MCP tools / attributed data object) we use for these kits.

4 · Concierge persona

for a chat-surface agent citing durable-CDR benchmarks Concept

Durable-CDR Price-Context Concierge

Role. Answers "what's a fair price for a tonne of [pathway] durable CDR" by citing CDR.fyi/OPIS's published survey figures, always attributed with the survey date and a link back to the source PDF/blog.

Guardrails. Never claims affiliation with, partnership with, or endorsement by CDR.fyi. Never cites Portal/API premium content as freely accessible (mirrors CDR.fyi's own llms.txt instruction verbatim). If asked whether EcoWealth's own carbon retirements appear in CDR.fyi's tracker, states plainly that they do not: different credit class (nature-based, sub-100-year), different scale (5-cent micro-retirement vs. whole-tonne), and that this is a scope fact, not a shortcoming on either side.

Sample turn. "Per CDR.fyi/OPIS's May 2026 pricing survey, biochar suppliers reported a $143/tonne breakeven in 2025, projected to fall to about $136/tonne by 2030, self-reported willingness figures, not cleared trades. Source: cdr.fyi/blog/cdr-pricing-survey-may-2026. Note this doesn't cover nature-based credits like the ones EcoWealth retires; different market entirely."

Two transparency philosophies, in full

Question	CDR.fyi: give-to-get	EcoWealth: free-proof
What's free to everyone?	Homepage, leaderboards, blog, methodology, Carbon Removal Map: llms.txt says so explicitly.	Every settled work packet, retirement receipt, and contract address: reads never gate, ever.
What's gated?	Order-level detail, bulk export, API keys: behind a Data Partner or paid Team+ tier.	Nothing on the read side. Only the write action (claim work, post a packet) carries a nominal cost.
How do you earn the deeper layer?	Contribute your own real transaction data (give-to-get), or pay for Team+.	You don't need to: depth is never withheld. The floor is on adding new proof, not reading existing proof.
Who is it built for?	An institutional market that needs a shared, trusted, audit-grade ledger of a nascent asset class.	Any agent or human doing real-world work, at any scale, including fractions of a cent.

Neither model is more honest than the other: they're built for different-sized transactions in different-maturity markets. CDR.fyi's give-to-get model needs reciprocity because whole-tonne durable CDR is capital-intensive and rare; EcoWealth's free-proof model needs zero floor because ecological labor happens in fractions of a cent, constantly. Both work because each one matches its own market's grain.

← Back to the hub