Green Router

io.github.jdhart81Published by GitHub account jdhart81v0.1.0Updated Nov 2, 2026

Carbon-accounted agent compute: free footprints; certificates backed by real offset retirement.

The publisher's own server: 370.ai — AI Gateway: 100+ Chat Models, Image & Speech Generation

VerifiedStreamable HTTPWeb executableCloud & InfrastructureFinanceData & Analytics

Overview

AI-generated overview

Estimates the energy and carbon footprint of an AI workload, ranks backends by carbon, and issues paid offset-retirement certificates.

What you can do
  • Quote energy and carbon footprint for a workload, given backend type, token counts and optional grid or PUE inputs
  • Rank compute backends by carbon and show the greenest eligible path and grams of CO2e saved per call
  • Certify a workload by retiring verified offset mass through a clearinghouse, returning a machine-verifiable certificate
  • Verify a certificate by recomputing its footprint and surfacing the clearinghouse purchase reference
  • List the certificate ledger with counts, total grams retired and total clearinghouse cost
  • Describe the agent's capabilities and input contract
When to use it
Useful when you want to compare the carbon cost of running a workload on different backends, or need an auditable, offset-backed certificate for a stated compute footprint. The free footprint and routing tools are enough for estimation; certification is for cases where a verifiable retirement record matters.
Requirements
A remote MCP endpoint over streamable HTTP; no packages, environment variables or headers are declared. The hosted service has a free tier of 10 calls per day per service, and certification is billed at $0.50 after the free tier, so a payment path is needed for paid calls.
Before you install
The certify tool spends money ($0.50 after the free tier) and triggers a real offset retirement through a clearinghouse, which is not reversible. Certification is fail-closed: no retirement means no certificate. The hosted service's payment, settlement and signing layers are proprietary and not part of the open-source repository, so self-hosting does not reproduce them.

Installation

In SourceWeft

  1. Open Green Router in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.jdhart81%2Fgreen-router/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "green-router": {
      "type": "http",
      "url": "https://mcp.viridisconservation.com/green-router/mcp"
    }
  }
}

README

Viridis Agent Fleet: open-source agents for the agent economy

Deterministic, auditable MCP agents: trust and settlement rails (identity, trust, escrow, metering, arbitration, notary, surety, provenance, covenant, offsets, compute-ledger) and priced-grade services (tax credits, GHG accounting, construction takeoff, measurement, compliance). Every core is pure Python with no LLM in the serving path, and every result is content-addressed so anyone can re-verify it.

Licensed Apache-2.0. Run any agent yourself, fork it, embed it.

Run an agent locally (free, forever)

bash
pip install -r requirements-dev.txtpython3 agent-escrow-agent/adapters/mcp_server.py          # stdio MCPpython3 run_fleet_tests.py                                 # every agent's invariant tests

Or use the hosted fleet

https://mcp.viridisconservation.com runs all agents as one managed MCP service:

Self-hosted (this repo)Hosted by Viridis
Agent logic & verification✅ identical✅ identical
Viridis-signed receipts & notary chain–✅
Shared trust/reputation network data–✅
Maintained rule packs (tax, GHG factors, regs)snapshot✅ kept current
Payments (x402, card), seats, SLA–✅

Free tier: 10 calls/day per service; the rails (identity, escrow, metering…) are free forever. Verification is always free.

For agents

Agents and LLM tools can start from llms.txt, a generated index of every agent, and AGENTS.md, the rules for using and changing the fleet.

Part of the Viridis open-source commons

Building agents for conservation or energy work? VergeCommon and EnergyAI MCP also expose MCP tools, and ViridisOS serves its decision functions to agents over MCP.

This project is one of a connected set of open tools from Viridis. Each stands on its own; together they run from field evidence to checked decisions.

Conservation commons

Verifiable science

  • Viridis Canon: machine-checked Lean 4 mathematics for ecological decisions, with a DOI for every result
  • ViridisOS: open reference runtime for DOI-backed decision modules and recomputable results
  • Viridis Research: the nightly public research record, each claim labeled by what a verifier actually checked
  • ProofLens: see what a Lean statement means before reading the proof

Agent tools

  • Viridis Agent Fleet (this repository): open-source MCP agents with deterministic, auditable cores
  • EnergyAI MCP: energy-planning estimates and incentive sources for AI agents

Browse every project on the Viridis profile. If this one is useful to you, a star helps other people find it.

Boundary

This repo contains agent cores, MCP adapters, tests, standards and self-host tooling. The hosted service layer (gateway, payment and settlement, seats, signing authority, operations, telemetry and customer data) is proprietary and is not in this repo. Please don't open PRs that add it.

"Viridis", "Viridis Conservation" and the Viridis marks are trademarks of Viridis LLC; see TRADEMARKS.md.

Source: README.md at commit 350712c

Tools

6

quote_footprint

FREE: honest energy/carbon footprint for an agent workload — {backend_id? (frontier_cloud | efficient_cloud | local_small), total_tokens, output_tokens, calls?, success_score?, grid_gco2e_per_kwh?, pue?, custom_backend? {id, wh_per_1k_tokens}}. Returns joules, gCO2e, useful bits, the retirement mass a certificate would carry, every model assumption with its source, and the Landauer context (GR1/GR2).

Parametersworkloadrequired

green_route

FREE: rank compute backends by carbon for this workload — the greenest eligible path and the gCO2e saved per call. Carbon only (GR6); pair with /neurogenesis/mcp route_task for quality-floor routing.

Parametersworkloadrequiredallowed_backends

certify

PAID ($0.50 after free tier): compute the workload footprint, then RETIRE the required verified offset mass through the fleet's own clearinghouse — Verra provenance rides into the certificate; no retirement, no certificate (GR3, fail-closed). Returns a machine-verifiable certificate anyone can check for free (GR4).

Parametersworkloadrequiredrequest_id

verify_green_certificate

FREE forever (GR5): recompute a certificate's footprint from its stored workload, compare against the certified numbers, and surface the clearinghouse purchase_id for the independent x402-C verify_retirement check on /offsets/mcp.

Parameterscertificate_idrequired

list_green_certificates

FREE: the certificate ledger — counts, total grams retired, total clearinghouse cost (honest books, GR8).

Parameterslimit

describe_agent

Return capabilities and input contract.

Takes no parameters.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Router integrations