# agent-metering MCP server

Usage metering + SLA accounting for agent services (the meter behind x402 micropayments).

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-jdhart81-agent-metering
- Repository: https://github.com/jdhart81/viridis-agent-fleet

## Install
- Endpoint: https://mcp.viridisconservation.com/metering/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://mcp.viridisconservation.com/metering/mcp

## Tools
- create_meter - Create a usage meter between a provider and a consumer agent.

    unit: what is being counted (call, token, kwh, ...). Price is in minor
    currency units (cents) per unit. Returns the meter_id. Endpoint: https://mcp.viridisconservation.com/metering/mcp
- record_usage - Record a usage event. Idempotent on event_id (safe to retry — never
    double-billed). outcome is 'ok' or 'error' and feeds the SLA report. Endpoint: https://mcp.viridisconservation.com/metering/mcp
- usage_summary - Totals for a meter: event count, total quantity, accrued minor units. Endpoint: https://mcp.viridisconservation.com/metering/mcp
- sla_report - Pure SLA report: success_rate vs sla_target, breach flag. No mutation. Endpoint: https://mcp.viridisconservation.com/metering/mcp
- close_period - Freeze all open events into an immutable invoice (exactly-once).
    The invoice amount is what agent-escrow-agent should settle. Endpoint: https://mcp.viridisconservation.com/metering/mcp
- verify_chain - Verify the tamper-evident event hash chain for a meter. Endpoint: https://mcp.viridisconservation.com/metering/mcp
- list_meters - List all meters with event/invoice counts. Endpoint: https://mcp.viridisconservation.com/metering/mcp
- list_events - Read usage events (paginated, read-only). Filter by meter, provider,
    consumer_class (internal|external|unknown), channel, outcome (ok|error),
    and ISO date range [since, until). Test-flagged events are excluded
    unless include_test=true. Returns events + next_cursor. Endpoint: https://mcp.viridisconservation.com/metering/mcp
- usage_timeseries - Usage time series bucketed on each event's recorded_at (UTC;
    bucket=day|hour), grouped across meters by provider — a real time-series
    primitive, independent of meter creation times. Includes per-bucket
    breakdowns by consumer_class / channel / provider. est_accrued_minor is
    an estimate; authoritative billing stays with usage_summary. Endpoint: https://mcp.viridisconservation.com/metering/mcp
- flag_meter - Admin: flag/unflag a meter as test/synthetic so its events are
    excluded from usage statistics by default. Touches meter metadata only —
    never events, never the hash chain, never billing accruals. Requires the
    server's VIRIDIS_ADMIN_TOKEN. Endpoint: https://mcp.viridisconservation.com/metering/mcp
- describe_agent - Fleet-standard self-description. Endpoint: https://mcp.viridisconservation.com/metering/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.jdhart81
- Version: 0.2.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 15, 2026
- Source: https://registry.modelcontextprotocol.io
