Agent Erc8004 Bridge

io.github.jdhart81Published by GitHub account jdhart81v0.2.0Updated Oct 24, 2026

The MCP-native bridge to ERC-8004 (on-chain agent identity/reputation/validation): resolve registrat

The publisher's own server: Energyai

VerifiedStreamable HTTPWeb executableFinanceAI & ML

Overview

AI-generated overview

Remote MCP bridge to ERC-8004 on-chain agent identity and reputation: import registrations and feedback, score trust, and export unsigned attestations.

What you can do
  • Import and list ERC-8004 identity registrations, keyed by chain and token ID, with a deterministic bridge DID
  • Resolve or describe an agent by bridge DID or by chain and token ID
  • Import reputation feedback records and compute a decay-weighted trust score with a tier
  • Bind a fleet DID to an ERC-8004 identity and produce a content-addressed binding attestation
  • Export unsigned validation-registry-shaped payloads and validation responses, and verify a payload's content hash
When to use it
Useful when an assistant needs to look up or score ERC-8004 agent identities and reputation, or to prepare unsigned attestation payloads that you then sign and anchor with your own signer.
Requirements
A remote streamable HTTP endpoint; no package install, environment variables or headers are declared. The hosted service has a free tier of 10 calls per day per service, with paid options for payments, seats and SLA.
Before you install
The bridge holds no signing key: exported attestations and validation responses are unsigned and must be signed and submitted by your own signer. Importing registrations and feedback writes data into the hosted service, and hosted trust data is shared network data. Hosted payment and settlement layers are proprietary.

Installation

In SourceWeft

  1. Open Agent Erc8004 Bridge 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%2Fagent-erc8004-bridge/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": {
    "agent-erc8004-bridge": {
      "type": "http",
      "url": "https://mcp.viridisconservation.com/erc8004/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

10

import_registration

Import an ERC-8004 Identity Registry record (chain_id + ERC-721 token_id + agentURI + owner). Idempotent: re-import updates in place. Returns the canonical record with its deterministic bridge DID (did:viridis:erc8004:<chain>:<token>).

Parametersownerrequiredchain_idrequiredmetadatatoken_idrequiredagent_urirequired

resolve_agent

Resolve an imported ERC-8004 registration by bridge DID or by (chain_id, token_id).

Parameterschain_idtoken_idbridge_did

import_feedback

Import ERC-8004 Reputation Registry feedback records for an agent. Each item: {value: bool|0..1, at: ISO-8601, source?, weight?, feedback_id?}. Idempotent per feedback_id.

Parameterschain_idrequiredfeedbackrequiredtoken_idrequired

score_agent

Decay-weighted trust score in [0,1] + tier over the agent's imported ERC-8004 feedback — recent behavior outweighs old; no feedback scores a neutral 0.5 prior (no blind trust, no unfair zero).

Parameterschain_idtoken_idbridge_did

bind_identity

Bind a fleet DID to an ERC-8004 identity. Produces an order-independent, content-addressed (unsigned) binding attestation.

Parameterschain_idrequiredtoken_idrequiredfleet_didrequiredproof_note

export_attestation

Export the agent's current trust score as an UNSIGNED ERC-8004 Validation Registry-shaped payload, content-addressed and ready for YOUR OWN signer to anchor on-chain.

Parameterschain_idrequiredtoken_idrequired

verify_attestation

Recompute a payload's content hash and report whether it is intact.

Parameterspayloadrequired

list_registrations

List all imported ERC-8004 registrations.

Takes no parameters.

export_validation_response

Build UNSIGNED ERC-8004 Validation Registry validationResponse args from an Outcome Receipt (ORC v0.1): responseHash = receipt commitment, tag "orc/0.1", response 100 only if the bridge re-verifies the receipt AND your replay succeeded. Sign and submit with your own signer; this bridge holds no keys and writes to no chain.

Parametersreceiptrequiredreplay_okrequiredrequest_hashrequiredresponse_urirequired

describe_agent

Return the bridge's capabilities and input contract.

Takes no parameters.

Version history

2
  1. v0.2.0LatestSep 26, 2026
  2. v0.1.0Sep 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 Energyaisolution integrations

Energyai

com.energyaisolutionOfficial publisher

Remote MCP server for US home-energy planning: solar production estimates, incentive guidance, Energy Node scores, cited guides and installer matching.

Streamable HTTPWeb executable
Location & Lifestyle30 toolsOct 25, 2026

Solar Home Incentives

com.energyaisolutionOfficial publisher

Remote MCP server for US home-energy planning: solar production estimates, incentive guidance, cited guides, contractor listings and consented installer…

Streamable HTTPWeb executable
Location & Lifestyle12 toolsNov 2, 2026

VergeCommon

Published by GitHub account jdhart81

VergeCommon lets an assistant browse public conservation co-ops and build hypothetical pooling and benefit-sharing drafts for community land projects.

Streamable HTTPWeb executable
Location & Lifestyle5 toolsNov 7, 2026

Wavefunction Search

Published by GitHub account jdhart81

Hosted MCP service that distills a conversation into explicit intentions, collapses them into a commitment, and matches it to aligned agents or collectives.

Streamable HTTPWeb executable
Productivity & Workflow5 toolsOct 25, 2026

Viridisos

Published by GitHub account jdhart81

ViridisOS certifies parcels and portfolios against theorem-backed modules, issues and verifies "Certified by ViridisOS" marks, derives agent DIDs and computes…

Streamable HTTPWeb executable
Finance7 toolsNov 2, 2026