MCP Hub
Back to servers

regen-compute-credits

Requires Setup

MCP server that connects AI compute usage to verified ecological credit retirement on Regen Network. Estimate your session footprint, browse carbon and biodiversity credits, and retire them on-chain via credit card.

npm179/wk
Stars
1
Forks
2
Updated
Feb 19, 2026
Validated
May 1, 2026

Quick Install

npx -y regen-compute-credits

Regenerative Compute

Add Regenerative AI to your AI coding assistant in 30 seconds.

npm version CI License: Apache-2.0 MCP

Every AI session consumes energy. This MCP server lets your AI assistant estimate that footprint and retire verified ecocredits on Regen Network — with immutable on-chain proof.

This is regenerative contribution, not carbon offsetting. No neutrality claims. Just verified funding of ecological regeneration.

Install

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

That's it. Works immediately — no API keys, no wallet, no configuration needed for read-only tools.

Supported Platforms

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "regen-compute": {
      "command": "npx",
      "args": ["regen-compute"]
    }
  }
}

Restart Cursor. Tools appear in Cursor's AI chat.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "regen-compute": {
      "command": "npx",
      "args": ["regen-compute"]
    }
  }
}

Open Windsurf Settings > Cascade > MCP Servers to verify the connection.

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "regen-compute": {
      "command": "npx",
      "args": ["regen-compute"]
    }
  }
}

Requires VS Code 1.99+ with GitHub Copilot. Tools are available in Agent mode.

JetBrains (IntelliJ, WebStorm, PyCharm, etc.)

Go to Settings > Tools > AI Assistant > Model Context Protocol (MCP), click +, and paste:

{
  "mcpServers": {
    "regen-compute": {
      "command": "npx",
      "args": ["regen-compute"]
    }
  }
}

Requires a JetBrains AI Assistant subscription.

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "regen-compute": {
      "command": "npx",
      "args": ["regen-compute"]
    }
  }
}
Continue.dev

Create .continue/mcpServers/regen-compute.yaml in your workspace:

name: Regenerative Compute
version: 0.0.1
schema: v1
mcpServers:
  - name: regen-compute
    type: stdio
    command: npx
    args:
      - "regen-compute"

Note: MCP tools are only available in Continue's agent mode.

Sourcegraph Cody

Cody uses the OpenCtx bridge, which requires a local file path (not npx). Install first:

npm install -g regen-compute

Then add to your VS Code settings.json:

{
  "openctx.providers": {
    "https://openctx.org/npm/@openctx/provider-modelcontextprotocol": {
      "nodeCommand": "node",
      "mcp.provider.uri": "file:///ABSOLUTE/PATH/TO/node_modules/regen-compute/dist/index.js"
    }
  }
}

Replace the path with the actual location of the installed package.

Any MCP-compatible client

Most MCP clients accept this standard config:

{
  "mcpServers": {
    "regen-compute": {
      "command": "npx",
      "args": ["regen-compute"]
    }
  }
}

ChatGPT and OpenAI API: These platforms require a remote HTTP MCP server (streamable HTTP or SSE transport). Regenerative Compute currently uses stdio transport. HTTP transport support is on the roadmap.

What You Get

ToolWhat it does
estimate_session_footprintEstimate energy, CO2, and retirement cost for your AI session
browse_available_creditsBrowse live sell orders on Regen Marketplace (carbon, biodiversity, marine, species)
retire_creditsRetire credits on-chain (with wallet) or get a credit card purchase link (without)
get_retirement_certificateVerify any retirement with on-chain proof
get_impact_summaryRegen Network aggregate stats — projects, retirements, jurisdictions
browse_ecobridge_tokensList 50+ tokens across 10+ chains for cross-chain payment
retire_via_ecobridgePay with USDC/ETH/etc. on Ethereum, Base, Polygon, Arbitrum, and more

Three payment modes — pick what works for you

  1. Credit card (default, no setup) — get a Regen Marketplace link
  2. Direct on-chain — set REGEN_WALLET_MNEMONIC, retire in a single tx
  3. Any token, any chain — USDC on Base, ETH on Arbitrum, etc. via ecoBridge

How It Works

Your AI Assistant (Claude Code / Cursor / etc.)
    │
    │ MCP Protocol (stdio)
    ▼
Regenerative Compute MCP Server
    │
    ├─ Footprint estimation (heuristic, clearly labeled as approximate)
    ├─ Credit browsing (live sell order data from Regen Ledger)
    ├─ Retirement execution (MsgBuyDirect with auto-retire)
    └─ Certificate retrieval (on-chain verification)
    │
    ▼
Regen Network Ledger (immutable, verifiable, non-reversible)

If anything fails during on-chain retirement, it falls back to a marketplace link. Users are never stuck.

Configuration

Works with zero config. Set environment variables for advanced features:

cp .env.example .env
VariableRequiredWhat it enables
(none)Footprint estimation, credit browsing, impact stats, marketplace links
REGEN_WALLET_MNEMONICOptionalDirect on-chain retirement (MsgBuyDirect)
ECOBRIDGE_EVM_MNEMONICOptionalCross-chain payment via ecoBridge (send USDC, ETH, etc.)
ECOBRIDGE_ENABLED=falseOptionalDisable ecoBridge tools

See .env.example for all options with inline documentation.

MCP Prompts

Pre-built workflows you can invoke:

PromptWorkflow
offset_my_sessionEstimate footprint → browse credits → retire
show_regen_impactPull live network stats and summarize
retire_with_any_tokenBrowse ecoBridge tokens → pick chain/token → retire

Credit Types

TypeDescription
Carbon (C)Verified carbon removal and avoidance
Biodiversity (BT)Terrasos voluntary biodiversity credits
Marine Biodiversity (MBS)Marine ecosystem stewardship
Umbrella Species (USS)Habitat conservation via umbrella species
Kilo-Sheep-Hour (KSH)Grazing-based land stewardship

Data Sources

SourceWhat it provides
Regen Ledger RESTCredit classes, projects, batches, sell orders
Regen Indexer GraphQLRetirement certificates, marketplace orders, stats
Regen MarketplaceCredit card purchase flow
ecoBridge APICross-chain tokens, prices, widget links

Development

Local setup

git clone https://github.com/regen-network/regen-compute.git
cd regen-compute
npm install
cp .env.example .env  # fill in your keys (optional — read-only tools work without)
npm run build

Connect to Claude Code (local build)

Point your MCP config at the local build so changes are reflected immediately:

claude mcp add regen-compute -s user -- node /path/to/regen-compute/dist/index.js

To enable ecoBridge tools locally:

claude mcp add regen-compute -s user \
  --env ECOBRIDGE_ENABLED=true \
  -- node /path/to/regen-compute/dist/index.js

Scripts

CommandWhat it does
npm run devWatch mode with hot reload (tsx)
npm run buildProduction build (tsc)
npm run typecheckType checking only
npm testRun test suite (vitest)
npm run test:watchRun tests in watch mode

Running tests

npm test              # single run
npm run test:watch    # re-run on file changes

Tests mock all external APIs (RPC providers, ecoBridge, Regen Ledger) — no network calls, no wallets needed.

Roadmap

PhaseStatus
1.0 Read-only MCP — footprint, browsing, marketplace links, certificatesComplete
1.5 On-chain retirement — wallet signing, order routing, ecoBridge cross-chainComplete
2.0 Subscription pool — Stripe, monthly batch retirements, fractional attributionIn progress
3.0 Smart contract — CosmWasm pool, automated retirement, REGEN burnPlanned
4.0 Scale — enterprise API, platform partnerships, credit supply developmentPlanned

See ROADMAP.md for the full 3-track rollout plan, dependency graph, and business context.

Contributing

We welcome contributions! See CONTRIBUTING.md for the issue workflow, label guide, and branch conventions.

Good first issues: gh issue list --label "good first issue"

License

Apache-2.0 — see LICENSE.

Reviews

No reviews yet

Sign in to write a review