MCP Server
agent-metering
io.github.jdhart81/agent-metering
What this MCP does
Creates usage meters, records tamper-evident service events, calculates billing and SLA metrics, produces reports, and closes billing periods for agent services.
Capabilities
Tools
11
tools
close_period
Freeze all open events into an immutable invoice (exactly-once).
The invoice amount is what agent-escrow-agent should settle.
Input schema
{'type': 'object', 'title': 'close_periodArguments', 'required': ['meter_id'], 'properties': {'meter_id': {'type': 'string', 'title': 'Meter Id'}}}
Output schema
{'type': 'object', 'title': 'close_periodOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Input schema
{'type': 'object', 'title': 'create_meterArguments', 'required': ['provider', 'consumer', 'unit', 'price_minor_per_unit'], 'properties': {'unit': {'type': 'string', 'title': 'Unit'}, 'consumer': {'type': 'string', 'title': 'Consumer'}, 'currency': {'type': 'string', 'title': 'Currency', 'default': 'USD'}, 'provider': {'type': 'string', 'title': 'Provider'}, 'sla_target': {'type': 'number', 'title': 'Sla Target', 'default': 0.99}, 'price_minor_per_unit': {'type': 'number', 'title': 'Price Minor Per Unit'}}}
Output schema
{'type': 'object', 'title': 'create_meterOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
describe_agent
Fleet-standard self-description.
Input schema
{'type': 'object', 'title': 'describe_agentArguments', 'properties': {}}
Output schema
{'type': 'object', 'title': 'describe_agentOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Input schema
{'type': 'object', 'title': 'flag_meterArguments', 'required': ['meter_id', 'is_test', 'admin_token'], 'properties': {'note': {'type': 'string', 'title': 'Note', 'default': ''}, 'is_test': {'type': 'boolean', 'title': 'Is Test'}, 'meter_id': {'type': 'string', 'title': 'Meter Id'}, 'admin_token': {'type': 'string', 'title': 'Admin Token'}}}
Output schema
{'type': 'object', 'title': 'flag_meterOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Input schema
{'type': 'object', 'title': 'list_eventsArguments', 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 100}, 'since': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Since', 'default': None}, 'until': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Until', 'default': None}, 'cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Cursor', 'default': None}, 'channel': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Channel', 'default': None}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Outcome', 'default': None}, 'meter_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Meter Id', 'default': None}, 'provider': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Provider', 'default': None}, 'include_test': {'type': 'boolean', 'title': 'Include Test', 'default': False}, 'consumer_class': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Consumer Class', 'default': None}}}
Output schema
{'type': 'object', 'title': 'list_eventsOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
list_meters
List all meters with event/invoice counts.
Input schema
{'type': 'object', 'title': 'list_metersArguments', 'properties': {}}
Output schema
{'type': 'object', 'title': 'list_metersOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Input schema
{'type': 'object', 'title': 'record_usageArguments', 'required': ['meter_id', 'event_id', 'quantity'], 'properties': {'outcome': {'type': 'string', 'title': 'Outcome', 'default': 'ok'}, 'event_id': {'type': 'string', 'title': 'Event Id'}, 'metadata': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'title': 'Metadata', 'default': None}, 'meter_id': {'type': 'string', 'title': 'Meter Id'}, 'quantity': {'type': 'number', 'title': 'Quantity'}}}
Output schema
{'type': 'object', 'title': 'record_usageOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
sla_report
Pure SLA report: success_rate vs sla_target, breach flag. No mutation.
Input schema
{'type': 'object', 'title': 'sla_reportArguments', 'required': ['meter_id'], 'properties': {'meter_id': {'type': 'string', 'title': 'Meter Id'}}}
Output schema
{'type': 'object', 'title': 'sla_reportOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
usage_summary
Totals for a meter: event count, total quantity, accrued minor units.
Input schema
{'type': 'object', 'title': 'usage_summaryArguments', 'required': ['meter_id'], 'properties': {'meter_id': {'type': 'string', 'title': 'Meter Id'}}}
Output schema
{'type': 'object', 'title': 'usage_summaryOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Input schema
{'type': 'object', 'title': 'usage_timeseriesArguments', 'properties': {'since': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Since', 'default': None}, 'until': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Until', 'default': None}, 'bucket': {'type': 'string', 'title': 'Bucket', 'default': 'day'}, 'channel': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Channel', 'default': None}, 'meter_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Meter Id', 'default': None}, 'provider': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Provider', 'default': None}, 'include_test': {'type': 'boolean', 'title': 'Include Test', 'default': False}, 'consumer_class': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Consumer Class', 'default': None}}}
Output schema
{'type': 'object', 'title': 'usage_timeseriesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
verify_chain
Verify the tamper-evident event hash chain for a meter.
Input schema
{'type': 'object', 'title': 'verify_chainArguments', 'required': ['meter_id'], 'properties': {'meter_id': {'type': 'string', 'title': 'Meter Id'}}}
Output schema
{'type': 'object', 'title': 'verify_chainOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
History
Recent tool changes
Added
describe_agent
Sept. 17, 2026, 12:42 p.m.
Added
flag_meter
Sept. 17, 2026, 12:42 p.m.
Added
usage_timeseries
Sept. 17, 2026, 12:42 p.m.
Added
list_events
Sept. 17, 2026, 12:42 p.m.
Added
list_meters
Sept. 17, 2026, 12:42 p.m.
Added
verify_chain
Sept. 17, 2026, 12:42 p.m.
Added
close_period
Sept. 17, 2026, 12:42 p.m.
Added
sla_report
Sept. 17, 2026, 12:42 p.m.
Added
usage_summary
Sept. 17, 2026, 12:42 p.m.
Added
record_usage
Sept. 17, 2026, 12:42 p.m.
Added
create_meter
Sept. 17, 2026, 12:42 p.m.
Discover
Similar MCP servers
synter-ads
io.github.Synter-Media-AI/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
synter-ads
io.github.jshorwitz/synter-ads
Manages cross-platform advertising campaigns, audiences, tracking, creative, landing pages, campaign audits, technology intellige…
Stratalize Finance
com.stratalize/finance
Provides financial, macroeconomic, banking, credit, commodities, M&A, ESG, labor, and regulatory benchmarks for analysis and plan…
Stratalize Healthcare
com.stratalize/healthcare
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Governance
com.stratalize/governance
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Oracle
com.stratalize/oracle
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…
Stratalize Intelligence
com.stratalize/intelligence
Provides vendor, market, SaaS, workforce, government contract, public company, regulatory, competitive, and AI-brand intelligence…
Stratalize Real Estate
com.stratalize/realestate
Retired Stratalize server exposing benchmark, market intelligence, compliance, financial, healthcare, legal, real estate, and eco…