Usage metering + SLA accounting for agent services (the meter behind x402 micropayments).
| Endpoint | https://mcp.viridisconservation.com/metering/mcp (streamable-http) |
|---|---|
| Registry version | 0.2.0 |
| Now | 11 tools · grade B (85) · pin ts_a855311d7471146e82a16d977369a120 · protocol 2025-06-18 |
| First / last listed | 2026-11-04 03:20 UTC / 2026-11-04 03:20 UTC |
| Grade over time | 2026-11-04: B (85), 11 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: create_meter record_usage usage_summary sla_report close_period verify_chain list_meters list_events usage_timeseries flag_meter describe_agent
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. params: provider*, consumer*, unit*, price_minor_per_unit*, currency, sla_target |
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. params: meter_id*, event_id*, quantity*, outcome, metadata |
usage_summary | Totals for a meter: event count, total quantity, accrued minor units. params: meter_id* |
sla_report | Pure SLA report: success_rate vs sla_target, breach flag. No mutation. params: meter_id* |
close_period | Freeze all open events into an immutable invoice (exactly-once).
The invoice amount is what agent-escrow-agent should settle. params: meter_id* |
verify_chain | Verify the tamper-evident event hash chain for a meter. params: meter_id* |
list_meters | List all meters with event/invoice counts. params: none |
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. params: meter_id, provider, consumer_class, channel, outcome, since, until, include_test, limit, cursor |
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. params: bucket, provider, meter_id, consumer_class, channel, since, until, include_test |
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. params: meter_id*, is_test*, admin_token*, note |
describe_agent | Describe this agent: name, version, purpose, every action it supports
and the inputs each one takes. Read-only and free; call it first to learn
how to use this server. params: none |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.