{"id":46797026,"url":"https://github.com/regen-network/regen-compute","last_synced_at":"2026-03-10T04:34:49.816Z","repository":{"id":339274884,"uuid":"1161205941","full_name":"regen-network/regen-compute","owner":"regen-network","description":"An MCP agent that funds verified ecological regeneration from AI compute usage via Regen Network","archived":false,"fork":false,"pushed_at":"2026-03-03T19:41:07.000Z","size":241,"stargazers_count":1,"open_issues_count":14,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-03T23:25:52.561Z","etag":null,"topics":["carbon-credits","claude","claude-code","ecocredits","mcp","mcp-server","model-context-protocol","regen-network","regenerative-ai","sustainability"],"latest_commit_sha":null,"homepage":"https://github.com/CShear/regen-for-ai#readme","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/regen-network.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-18T21:12:51.000Z","updated_at":"2026-03-03T19:41:10.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/regen-network/regen-compute","commit_stats":null,"previous_names":["cshear/regen-compute-credits","cshear/regen-for-ai","regen-network/regen-compute"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/regen-network/regen-compute","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regen-network%2Fregen-compute","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regen-network%2Fregen-compute/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regen-network%2Fregen-compute/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regen-network%2Fregen-compute/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/regen-network","download_url":"https://codeload.github.com/regen-network/regen-compute/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regen-network%2Fregen-compute/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30324463,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T01:36:58.598Z","status":"online","status_checked_at":"2026-03-10T02:00:06.579Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["carbon-credits","claude","claude-code","ecocredits","mcp","mcp-server","model-context-protocol","regen-network","regenerative-ai","sustainability"],"created_at":"2026-03-10T04:34:49.165Z","updated_at":"2026-03-10T04:34:49.797Z","avatar_url":"https://github.com/regen-network.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Regenerative Compute\n\n**Add Regenerative AI to your AI coding assistant in 30 seconds.**\n\n[![npm version](https://img.shields.io/npm/v/regen-compute)](https://www.npmjs.com/package/regen-compute)\n[![CI](https://github.com/regen-network/regen-compute/actions/workflows/ci.yml/badge.svg)](https://github.com/regen-network/regen-compute/actions/workflows/ci.yml)\n[![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-green)](LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)\n\nEvery AI session consumes energy. This MCP server lets your AI assistant estimate that footprint and retire verified ecocredits on [Regen Network](https://regen.network) — with immutable on-chain proof.\n\nThis is **regenerative contribution**, not carbon offsetting. No neutrality claims. Just verified funding of ecological regeneration.\n\n## Install\n\n```bash\nclaude mcp add -s user regen-compute -- npx regen-compute\n```\n\nThat's it. Works immediately — no API keys, no wallet, no configuration needed for read-only tools.\n\n### Supported Platforms\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eCursor\u003c/b\u003e\u003c/summary\u003e\n\nAdd to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project):\n\n```json\n{\n  \"mcpServers\": {\n    \"regen-compute\": {\n      \"command\": \"npx\",\n      \"args\": [\"regen-compute\"]\n    }\n  }\n}\n```\n\nRestart Cursor. Tools appear in Cursor's AI chat.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eWindsurf\u003c/b\u003e\u003c/summary\u003e\n\nAdd to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"regen-compute\": {\n      \"command\": \"npx\",\n      \"args\": [\"regen-compute\"]\n    }\n  }\n}\n```\n\nOpen Windsurf Settings \u003e Cascade \u003e MCP Servers to verify the connection.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eVS Code (GitHub Copilot)\u003c/b\u003e\u003c/summary\u003e\n\nAdd to `.vscode/mcp.json` in your workspace:\n\n```json\n{\n  \"servers\": {\n    \"regen-compute\": {\n      \"command\": \"npx\",\n      \"args\": [\"regen-compute\"]\n    }\n  }\n}\n```\n\nRequires VS Code 1.99+ with GitHub Copilot. Tools are available in Agent mode.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eJetBrains (IntelliJ, WebStorm, PyCharm, etc.)\u003c/b\u003e\u003c/summary\u003e\n\nGo to **Settings \u003e Tools \u003e AI Assistant \u003e Model Context Protocol (MCP)**, click **+**, and paste:\n\n```json\n{\n  \"mcpServers\": {\n    \"regen-compute\": {\n      \"command\": \"npx\",\n      \"args\": [\"regen-compute\"]\n    }\n  }\n}\n```\n\nRequires a JetBrains AI Assistant subscription.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eGemini CLI\u003c/b\u003e\u003c/summary\u003e\n\nAdd to `~/.gemini/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"regen-compute\": {\n      \"command\": \"npx\",\n      \"args\": [\"regen-compute\"]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eContinue.dev\u003c/b\u003e\u003c/summary\u003e\n\nCreate `.continue/mcpServers/regen-compute.yaml` in your workspace:\n\n```yaml\nname: Regenerative Compute\nversion: 0.0.1\nschema: v1\nmcpServers:\n  - name: regen-compute\n    type: stdio\n    command: npx\n    args:\n      - \"regen-compute\"\n```\n\nNote: MCP tools are only available in Continue's agent mode.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eSourcegraph Cody\u003c/b\u003e\u003c/summary\u003e\n\nCody uses the OpenCtx bridge, which requires a local file path (not npx). Install first:\n\n```bash\nnpm install -g regen-compute\n```\n\nThen add to your VS Code `settings.json`:\n\n```json\n{\n  \"openctx.providers\": {\n    \"https://openctx.org/npm/@openctx/provider-modelcontextprotocol\": {\n      \"nodeCommand\": \"node\",\n      \"mcp.provider.uri\": \"file:///ABSOLUTE/PATH/TO/node_modules/regen-compute/dist/index.js\"\n    }\n  }\n}\n```\n\nReplace the path with the actual location of the installed package.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003eAny MCP-compatible client\u003c/b\u003e\u003c/summary\u003e\n\nMost MCP clients accept this standard config:\n\n```json\n{\n  \"mcpServers\": {\n    \"regen-compute\": {\n      \"command\": \"npx\",\n      \"args\": [\"regen-compute\"]\n    }\n  }\n}\n```\n\n\u003c/details\u003e\n\n\u003e **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](ROADMAP.md).\n\n## Quick Start\n\nAfter installing, ask your AI assistant to run these tools:\n\n1. **`estimate_session_footprint`** — See the energy and CO2 cost of your current session\n2. **`browse_available_credits`** — Explore live ecological credits (carbon, biodiversity, marine) on Regen Marketplace\n3. **`retire_credits`** — Retire credits to fund regeneration (credit card link by default, or on-chain with a wallet)\n4. **`get_retirement_certificate`** — Get a verifiable on-chain proof of your contribution\n\nOr just ask: *\"Estimate my session's footprint and show me credits I can retire\"* — the AI handles the rest.\n\n## What You Get\n\n| Tool | What it does |\n|------|-------------|\n| `estimate_session_footprint` | Estimate energy, CO2, and retirement cost for your AI session |\n| `browse_available_credits` | Browse live sell orders on Regen Marketplace (carbon, biodiversity, marine, species) |\n| `retire_credits` | Retire credits on-chain (with wallet) or get a credit card purchase link (without) |\n| `get_retirement_certificate` | Verify any retirement with on-chain proof |\n| `get_impact_summary` | Regen Network aggregate stats — projects, retirements, jurisdictions |\n| `browse_ecobridge_tokens` | List 50+ tokens across 10+ chains for cross-chain payment |\n| `retire_via_ecobridge` | Pay with USDC/ETH/etc. on Ethereum, Base, Polygon, Arbitrum, and more |\n\n### Three payment modes — pick what works for you\n\n1. **Credit card** (default, no setup) — get a Regen Marketplace link\n2. **Direct on-chain** — set `REGEN_WALLET_MNEMONIC`, retire in a single tx\n3. **Any token, any chain** — USDC on Base, ETH on Arbitrum, etc. via [ecoBridge](https://bridge.eco)\n\n## How It Works\n\n```\nYour AI Assistant (Claude Code / Cursor / etc.)\n    │\n    │ MCP Protocol (stdio)\n    ▼\nRegenerative Compute MCP Server\n    │\n    ├─ Footprint estimation (heuristic, clearly labeled as approximate)\n    ├─ Credit browsing (live sell order data from Regen Ledger)\n    ├─ Retirement execution (MsgBuyDirect with auto-retire)\n    └─ Certificate retrieval (on-chain verification)\n    │\n    ▼\nRegen Network Ledger (immutable, verifiable, non-reversible)\n```\n\nIf anything fails during on-chain retirement, it falls back to a marketplace link. Users are never stuck.\n\n## Configuration\n\nWorks with zero config. Set environment variables for advanced features:\n\n```bash\ncp .env.example .env\n```\n\n| Variable | Required | What it enables |\n|----------|----------|----------------|\n| *(none)* | — | Footprint estimation, credit browsing, impact stats, marketplace links |\n| `REGEN_WALLET_MNEMONIC` | Optional | Direct on-chain retirement (MsgBuyDirect) |\n| `ECOBRIDGE_EVM_MNEMONIC` | Optional | Cross-chain payment via ecoBridge (send USDC, ETH, etc.) |\n| `ECOBRIDGE_ENABLED=false` | Optional | Disable ecoBridge tools |\n\nSee [`.env.example`](.env.example) for all options with inline documentation.\n\n## MCP Prompts\n\nPre-built workflows you can invoke:\n\n| Prompt | Workflow |\n|--------|----------|\n| `offset_my_session` | Estimate footprint → browse credits → retire |\n| `show_regen_impact` | Pull live network stats and summarize |\n| `retire_with_any_token` | Browse ecoBridge tokens → pick chain/token → retire |\n\n## Credit Types\n\n| Type | Description |\n|------|-------------|\n| Carbon (C) | Verified carbon removal and avoidance |\n| Biodiversity (BT) | Terrasos voluntary biodiversity credits |\n| Marine Biodiversity (MBS) | Marine ecosystem stewardship |\n| Umbrella Species (USS) | Habitat conservation via umbrella species |\n| Kilo-Sheep-Hour (KSH) | Grazing-based land stewardship |\n\n## Data Sources\n\n| Source | What it provides |\n|--------|------------------|\n| [Regen Ledger REST](https://lcd-regen.keplr.app) | Credit classes, projects, batches, sell orders |\n| [Regen Indexer GraphQL](https://api.regen.network/indexer/v1/graphql) | Retirement certificates, marketplace orders, stats |\n| [Regen Marketplace](https://app.regen.network) | Credit card purchase flow |\n| [ecoBridge API](https://api.bridge.eco) | Cross-chain tokens, prices, widget links |\n\n## Development\n\n### Local setup\n\n```bash\ngit clone https://github.com/regen-network/regen-compute.git\ncd regen-compute\nnpm install\ncp .env.example .env  # fill in your keys (optional — read-only tools work without)\nnpm run build\n```\n\n### Connect to Claude Code (local build)\n\nPoint your MCP config at the local build so changes are reflected immediately:\n\n```bash\nclaude mcp add regen-compute -s user -- node /path/to/regen-compute/dist/index.js\n```\n\nTo enable ecoBridge tools locally:\n\n```bash\nclaude mcp add regen-compute -s user \\\n  --env ECOBRIDGE_ENABLED=true \\\n  -- node /path/to/regen-compute/dist/index.js\n```\n\n### Scripts\n\n| Command | What it does |\n|---------|-------------|\n| `npm run dev` | Watch mode with hot reload (tsx) |\n| `npm run build` | Production build (tsc) |\n| `npm run typecheck` | Type checking only |\n| `npm test` | Run test suite (vitest) |\n| `npm run test:watch` | Run tests in watch mode |\n\n### Running tests\n\n```bash\nnpm test              # single run\nnpm run test:watch    # re-run on file changes\n```\n\nTests mock all external APIs (RPC providers, ecoBridge, Regen Ledger) — no network calls, no wallets needed.\n\n## Roadmap\n\n| Phase | Status |\n|-------|--------|\n| **1.0** Read-only MCP — footprint, browsing, marketplace links, certificates | Complete |\n| **1.5** On-chain retirement — wallet signing, order routing, ecoBridge cross-chain | Complete |\n| **2.0** Subscription pool — Stripe, monthly batch retirements, fractional attribution | [In progress](ROADMAP.md) |\n| **3.0** Smart contract — CosmWasm pool, automated retirement, REGEN burn | Planned |\n| **4.0** Scale — enterprise API, platform partnerships, credit supply development | Planned |\n\nSee [ROADMAP.md](ROADMAP.md) for the full 3-track rollout plan, dependency graph, and business context.\n\n## Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](.github/CONTRIBUTING.md) for the issue workflow, label guide, and branch conventions.\n\nGood first issues: [`gh issue list --label \"good first issue\"`](https://github.com/regen-network/regen-compute/labels/good%20first%20issue)\n\n## License\n\nApache-2.0 — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fregen-network%2Fregen-compute","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fregen-network%2Fregen-compute","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fregen-network%2Fregen-compute/lists"}