Developer Docs

Build on Regen Compute

Embed verified ecological credit retirement into any app, agent, or AI workflow. Three integration paths — pick the one that fits.

MCP Server REST API Regen Ledger On-chain certificates

MCP Server — zero-code integration

The fastest path for Claude Code, Cursor, or any MCP-compatible agent. One command adds ecological footprint estimation, credit browsing, and on-chain retirement as native AI tools. No API key required for read-only use.

Install

claude mcp add -s user regen-compute -- npx regen-compute

Or run the server manually

npx regen-compute

Available tools

ToolAuth requiredDescription
estimate_session_footprintPublicEstimate the ecological footprint of the current session by duration and tool call count.
browse_available_creditsPublicLive sell order snapshot from Regen Ledger — carbon, biodiversity, and more.
get_impact_summaryPublicNetwork-wide stats: total retirements, active projects, credit types.
get_retirement_certificatePublicLook up an on-chain retirement certificate by node ID or tx hash.
retire_creditsSubscriptionExecute an on-chain retirement or return a Marketplace purchase link.
check_subscription_statusPublicShow the user's subscription tier, balance, impact, and referral link.

Typical workflow (Claude will handle this automatically)

  1. 1estimate_session_footprint — Claude calls this at end of session to calculate ecological cost.
  2. 2browse_available_credits — Surfaces live credit options with real prices.
  3. 3retire_credits — Retires credits on-chain (subscribed users) or returns a Marketplace link.
  4. 4get_retirement_certificate — Returns a permanent, shareable certificate URL on Regen Network.

Agent framework integration (non-Claude)

Any MCP-compatible framework can install the server. For frameworks that don't support MCP, use the REST API below instead.

# LangChain / CrewAI / custom agent # Start the MCP server as a subprocess and connect via stdio transport npx regen-compute # listens on stdin/stdout per MCP spec

Get your API key

Subscribe to unlock retire_credits and the full REST API. Free tier includes all read-only tools.

View plans & pricing

REST API — embed retirement anywhere

A JSON API at /api/v1/ mirrors all MCP tools. Use it from any language, any framework. Perfect for web apps, agent pipelines, game backends, or serverless functions.

Authentication

Most endpoints require a valid API key. Include it as a Bearer token in every request:

Authorization: Bearer rfa_your_api_key_here

Get your key by subscribing at /#pricing. Your key appears in the Dashboard immediately after checkout.

Quick start — Node.js

const API = "https://compute.regen.network/api/v1"; const KEY = process.env.REGEN_API_KEY; const hdrs = { Authorization: `Bearer ${KEY}`, "Content-Type": "application/json" }; // 1. Estimate footprint for a 30-minute session with 12 tool calls const fp = await fetch(`${API}/footprint?session_minutes=30&tool_calls=12`, { headers: hdrs }); const { kg_co2e, suggested_credits } = await fp.json(); // 2. Browse available credits const cr = await fetch(`${API}/credits`, { headers: hdrs }); const { credit_classes } = await cr.json(); // 3. Retire credits on-chain const ret = await fetch(`${API}/retire`, { method: "POST", headers: hdrs, body: JSON.stringify({ quantity: suggested_credits, beneficiary_name: "My App" }) }); const { tx_hash, certificate_url } = await ret.json(); console.log("Certificate:", certificate_url);

Quick start — curl

# Set your key export REGEN_API_KEY=rfa_your_api_key_here # Footprint estimate curl -H "Authorization: Bearer $REGEN_API_KEY" "https://compute.regen.network/api/v1/footprint?session_minutes=30&tool_calls=12" # Browse credits curl -H "Authorization: Bearer $REGEN_API_KEY" "https://compute.regen.network/api/v1/credits" # Retire 0.5 credits curl -X POST -H "Authorization: Bearer $REGEN_API_KEY" -H "Content-Type: application/json" -d '{"quantity":0.5,"beneficiary_name":"My App"}' "https://compute.regen.network/api/v1/retire"

Rate limits

TierRequests / minuteRetire credits
Public (no key)—No
Dabbler60 req/minYes
Builder60 req/minYes
Agent60 req/minYes

OpenAPI spec

Full machine-readable spec. Import into Postman, Insomnia, or any OpenAPI client.

Download openapi.json

API Reference

All endpoints are under https://compute.regen.network/api/v1/. Click any endpoint to expand the full request/response spec.

Base URL & auth header

GET https://compute.regen.network/api/v1/{endpoint} Authorization: Bearer rfa_your_api_key_here
GET /footprint Estimate session footprint Auth required

Query parameters

ParamTypeRequiredDescription
session_minutesfloatYesDuration of the AI session in minutes
tool_callsintNoNumber of tool invocations (improves estimate accuracy)

Example response

{ "session_minutes": 30, "tool_calls": 12, "kg_co2e": 0.042, "suggested_credits": 0.05, "methodology": "Heuristic estimate based on session duration and tool usage.", "disclaimer": "This is an estimate. Actual compute energy varies by model and datacenter." }
GET /credits Browse available credit classes & sell orders Auth required

Query parameters

ParamTypeDefaultDescription
typestringallall | carbon | biodiversity
max_resultsint10Max credit classes to return (max 50)

Example response (truncated)

{ "credit_classes": [ { "id": "C01", "name": "Carbon Credit Class", "credit_type": "Carbon", "credit_type_abbreviation": "C", "projects": [...], "sell_orders": [...] } ], "marketplace_snapshot": [ { "credit_type": "Carbon", "available_credits": 1240.5, "sell_orders": 8 } ], "total_classes": 6, "data_source": "Regen Ledger (live)" }
POST /retire Execute an on-chain credit retirement Auth required

Request body

FieldTypeRequiredDescription
credit_classstringNoClass ID (e.g. C01). Defaults to lowest-cost available.
quantityfloatNoCredits to retire. Defaults to session footprint suggestion.
beneficiary_namestringNoName on the retirement certificate
jurisdictionstringNoISO 3166-1 alpha-2 (e.g. US)
reasonstringNoReason string recorded on-chain

Success response

{ "status": "success", "tx_hash": "A3F2...9C1D", "credits_retired": 0.5, "cost": { "amount": "2.50", "denom": "USDC" }, "certificate_url": "https://compute.regen.network/impact/bWVhbmluZ...", "jurisdiction": "US" }

Fallback response (when wallet not configured — returns marketplace link)

{ "status": "marketplace_link", "marketplace_url": "https://app.regen.network/...", "message": "Complete purchase at Regen Marketplace" }
GET /impact Network-wide impact stats Auth required

No parameters. Returns aggregate stats from Regen Ledger and the Indexer.

{ "credit_classes": 6, "active_projects": 42, "jurisdictions": 14, "total_retirements": 1823, "credit_types": [ { "abbreviation": "C", "name": "Carbon" }, { "abbreviation": "BT", "name": "Biodiversity (Terrasos)" }, { "abbreviation": "MBS", "name": "Marine Biodiversity Stewardship" } ] }
GET /certificates/:id Look up a retirement certificate Auth required

:id is the base64-encoded node ID from the Regen Indexer, or a tx hash.

{ "node_id": "bWVhbmluZ...", "amount": "0.5", "batch_denom": "C01-001-20230101-20231231-001", "owner": "regen1...", "jurisdiction": "US", "reason": "AI session — Regen Compute", "timestamp": "2026-03-23T14:32:00Z", "tx_hash": "A3F2...9C1D", "certificate_url": "https://compute.regen.network/impact/bWVhbmluZ..." }
GET /subscription Current user subscription & impact Auth required
{ "subscribed": true, "tier": "builder", "status": "active", "referral_count": 3, "referral_link": "https://compute.regen.network/r/ABC123", "cumulative_credits_retired": 12.5 }
GET /payment-info Crypto payment addresses for autonomous agents Public

Returns on-chain payment addresses for agents that want to subscribe autonomously via crypto (EIP-402 pattern).

{ "addresses": { "evm": { "address": "0x0687...", "chains": ["ethereum", "base", ...] }, "bitcoin": "bc1q...", "solana": "9npQ..." }, "minimum_usd": 1.25, "confirm_endpoint": "POST https://compute.regen.network/api/v1/confirm-payment" }

Full OpenAPI spec

Import into Postman, Insomnia, or use with any OpenAPI codegen.

openapi.json