MCP Hub
Back to servers

regen-compute-credits

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

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