io.github.jdhart81/agent-metering — Usage Metering & SLA Accounting MCP Server

The io.github.jdhart81/agent-metering MCP server provides usage metering and SLA accounting for agent services, described as the “meter behind x402 micropayments.” It exposes paid HTTP routes intended to verify and settle before execution, returning structured JSON and a payment receipt.

🛠️ Key Features

Usage metering and SLA accounting for agent services
Seven deterministic paid HTTP routes
Payment verification and settlement before execution
Structured JSON responses plus a payment receipt
Payment entrypoint: first paid call from a new wallet is $0.01

🚀 Use Cases

Carbon and compliance workflow steps: measure → account → disclose → claim → scan
Multi-agent problem solving

⚡ Developer Benefits

Deterministic paid routes mapped to a five-step workflow
Payment receipt available with responses
“MCP security preflight” included among capabilities

⚠️ Limitations

Paid access via x402/USDC on Base; pricing after the first call uses unchanged list prices (list not included here)
Scope described as “seven deterministic paid HTTP routes” (additional tools not detailed)

📚 Topics

Usage metering
SLA accounting
Agent services
x402 micropayments
Base
x402/USDC
Carbon and compliance workflow

{ "type": "object", "properties": { "provider": { "title": "Provider", "type": "string" }, "consumer": { "title": "Consumer", "type": "string" }, "unit": { "title": "Unit", "type": "string" }, "price_minor_per_unit": { "title": "Price Minor Per Unit", "type": "number" }, "currency": { "default": "USD", "title": "Currency", "type": "string" }, "sla_target": { "default": 0.99, "title": "Sla Target", "type": "number" } }, "required": [ "provider", "consumer", "unit", "price_minor_per_unit" ], "title": "create_meterArguments" }

{ "type": "object", "properties": { "meter_id": { "title": "Meter Id", "type": "string" }, "event_id": { "title": "Event Id", "type": "string" }, "quantity": { "title": "Quantity", "type": "number" }, "outcome": { "default": "ok", "title": "Outcome", "type": "string" }, "metadata": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "default": null, "title": "Metadata" } }, "required": [ "meter_id", "event_id", "quantity" ], "title": "record_usageArguments" }

{ "type": "object", "properties": { "meter_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Meter Id" }, "provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Provider" }, "consumer_class": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Consumer Class" }, "channel": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Channel" }, "outcome": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Outcome" }, "since": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Since" }, "until": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Until" }, "include_test": { "default": false, "title": "Include Test", "type": "boolean" }, "limit": { "default": 100, "title": "Limit", "type": "integer" }, "cursor": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Cursor" } }, "title": "list_eventsArguments" }

{ "type": "object", "properties": { "bucket": { "default": "day", "title": "Bucket", "type": "string" }, "provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Provider" }, "meter_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Meter Id" }, "consumer_class": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Consumer Class" }, "channel": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Channel" }, "since": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Since" }, "until": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "default": null, "title": "Until" }, "include_test": { "default": false, "title": "Include Test", "type": "boolean" } }, "title": "usage_timeseriesArguments" }

{ "type": "object", "properties": { "meter_id": { "title": "Meter Id", "type": "string" }, "is_test": { "title": "Is Test", "type": "boolean" }, "admin_token": { "title": "Admin Token", "type": "string" }, "note": { "default": "", "title": "Note", "type": "string" } }, "required": [ "meter_id", "is_test", "admin_token" ], "title": "flag_meterArguments" }

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.

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

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.

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.

Install

Tools (11)

create_meterrecord_usageusage_summarysla_reportclose_periodverify_chainlist_meterslist_events

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.viridisconservation.com/metering/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "agent-metering": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.viridisconservation.com/metering/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.jdhart81/agent-metering