MCP Server
Ardaro Agent Runtime Utilities
io.github.ashevilleislove/ardaro-agent-utilities
What this MCP does
Provides advisory utilities for agent spending checks, intent classification, context formatting, and billing-ledger reconciliation, including readiness and pricing information.
Capabilities
Tools
6
tools
authorize_agent_spend
Advisory spending check
Compare a proposed downstream cost with caller-supplied limits and history. Advisory only: does not authenticate policy, reserve funds, issue authorization or block external API calls. Evaluation excludes this service fee. Paid: 0.10 USDC per accepted analysis, including an unfavorable advisory result. Check get_utility_service_status with service='authorize_agent_spend' and the free fixed example first. Owner-authorized x402 payment is required; tool discovery does not authorize spending.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['proposed_cost', 'currency', 'policy', 'history'], 'properties': {'policy': {'type': 'object', 'required': ['currency', 'max_per_transaction', 'max_per_hour', 'max_checks_per_minute'], 'properties': {'currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'max_per_hour': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$', 'maxLength': 16, 'minLength': 1}, 'max_per_transaction': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$', 'maxLength': 16, 'minLength': 1}, 'max_checks_per_minute': {'type': 'integer', 'maximum': 1000000, 'minimum': 1}}, 'additionalProperties': False}, 'history': {'type': 'object', 'required': ['currency', 'committed_last_hour', 'pending_reserved', 'checks_last_minute'], 'properties': {'currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'pending_reserved': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$', 'maxLength': 16, 'minLength': 1}, 'checks_last_minute': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'committed_last_hour': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$', 'maxLength': 16, 'minLength': 1}}, 'additionalProperties': False}, 'currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'proposed_cost': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$', 'maxLength': 16, 'minLength': 1}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'anyOf': [{'type': 'object', 'required': ['contract_version', 'service_id', 'status', 'result', 'identities'], 'properties': {'result': {'type': 'object', 'required': ['tool', 'authorization_status', 'currency', 'policy_currency', 'history_currency', 'proposed_cost', 'submitted_budget_in_use', 'proposed_hour_total', 'hourly_remaining_after_proposal', 'checks', 'findings', 'policy'], 'properties': {'tool': {'const': 'authorize_agent_spend'}, 'checks': {'type': 'object', 'required': ['currency_consistent', 'transaction_within_limit', 'hourly_within_limit', 'rate_within_limit'], 'properties': {'rate_within_limit': {'type': 'boolean'}, 'currency_consistent': {'type': 'boolean'}, 'hourly_within_limit': {'type': ['boolean', 'null']}, 'transaction_within_limit': {'type': ['boolean', 'null']}}, 'additionalProperties': False}, 'policy': {'type': 'object', 'required': ['advisory_only', 'stateless', 'submitted_records_retained', 'caller_identity_authenticated', 'submitted_evidence_verified', 'external_spend_enforced', 'downstream_payment_authorized', 'reservation_created', 'ledger_updated', 'credentials_issued', 'delivery_verified', 'model_calls', 'human_review_required', 'policy_authenticated', 'history_verified', 'checks_exclude_service_fee', 'scope', 'fee_scope', 'history_scope'], 'properties': {'scope': {'const': 'Compares caller-supplied downstream maximum cost with caller-supplied limits and history. A within-limits result is not authorization, a reservation, or evidence that actual spend is controlled.'}, 'fee_scope': {'const': 'The separately quoted service fee is excluded from these checks and must be budgeted separately in USDC. No USD/USDC conversion is performed.'}, 'stateless': {'const': True}, 'model_calls': {'const': 0}, 'advisory_only': {'const': True}, 'history_scope': {'const': 'The caller supplies committed cost for its intended rolling-hour window, all unresolved pending reservations, and the count of prior checks in its intended minute. Completeness and timing are not verified.'}, 'ledger_updated': {'const': False}, 'history_verified': {'const': False}, 'delivery_verified': {'const': False}, 'credentials_issued': {'const': False}, 'reservation_created': {'const': False}, 'policy_authenticated': {'const': False}, 'human_review_required': {'const': True}, 'external_spend_enforced': {'const': False}, 'checks_exclude_service_fee': {'const': True}, 'submitted_records_retained': {'const': False}, 'submitted_evidence_verified': {'const': False}, 'caller_identity_authenticated': {'const': False}, 'downstream_payment_authorized': {'const': False}}, 'additionalProperties': False}, 'currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'findings': {'type': 'array', 'items': {'enum': ['CURRENCY_MISMATCH', 'TRANSACTION_LIMIT_EXCEEDED', 'HOURLY_LIMIT_EXCEEDED', 'RATE_THRESHOLD_EXCEEDED']}, 'maxItems': 3, 'uniqueItems': True}, 'proposed_cost': {'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$', 'maxLength': 18, 'minLength': 8}, 'policy_currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'history_currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'proposed_hour_total': {'anyOf': [{'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$', 'maxLength': 18, 'minLength': 8}, {'type': 'null'}]}, 'authorization_status': {'enum': ['WITHIN_SUBMITTED_LIMITS', 'EXCEEDS_SUBMITTED_LIMITS', 'RATE_THRESHOLD_EXCEEDED', 'CURRENCY_MISMATCH']}, 'submitted_budget_in_use': {'anyOf': [{'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$', 'maxLength': 18, 'minLength': 8}, {'type': 'null'}]}, 'hourly_remaining_after_proposal': {'anyOf': [{'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$', 'maxLength': 18, 'minLength': 8}, {'type': 'null'}]}}, 'additionalProperties': False}, 'status': {'const': 'review_required'}, 'identities': {'type': 'object', 'required': ['analysis_result_identity', 'payment_identity'], 'properties': {'payment_identity': {'type': 'object', 'required': ['protocol', 'reference', 'replayed'], 'properties': {'protocol': {'const': 'x402-v2'}, 'replayed': {'type': 'boolean'}, 'reference': {'type': 'string', 'pattern': '^pay_[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'analysis_result_identity': {'type': 'string', 'pattern': '^res_[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'service_id': {'const': 'ardaro.authorize_agent_spend'}, 'contract_version': {'const': 'ardaro.agent-utilities.response.v1'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['contract_version', 'status', 'error'], 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string', 'maxLength': 100}, 'message': {'type': 'string', 'maxLength': 300}}, 'additionalProperties': False}, 'status': {'const': 'error'}, 'contract_version': {'const': 'ardaro.agent-utilities.response.v1'}}, 'additionalProperties': False}, {'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['contract_version', 'status', 'error'], 'properties': {'error': {'type': 'object', 'required': ['code', 'service_code', 'message', 'retryable', 'remediation'], 'properties': {'code': {'type': 'string', 'maxLength': 80}, 'message': {'type': 'string', 'maxLength': 280}, 'retryable': {'type': 'boolean'}, 'remediation': {'type': 'string', 'maxLength': 280}, 'service_code': {'enum': ['ARDARO_ARITHMETIC_MISMATCH', 'ARDARO_DOCUMENT_TOO_LARGE', 'ARDARO_DUPLICATE_SUSPECTED', 'ARDARO_EXTRACTION_LOW_CONFIDENCE', 'ARDARO_IDEMPOTENCY_CONFLICT', 'ARDARO_INPUT_UNSUPPORTED', 'ARDARO_PAYMENT_INVALID', 'ARDARO_PAYMENT_RECONCILIATION_REQUIRED', 'ARDARO_PAYMENT_REQUIRED', 'ARDARO_RATE_LIMITED', 'ARDARO_SERVICE_UNAVAILABLE']}}, 'additionalProperties': False}, 'status': {'const': 'error'}, 'contract_version': {'const': 'ardaro.agent-receipt-intelligence.response.v1'}}, 'additionalProperties': False}, {'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['contract_version', 'status', 'service', 'error'], 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string', 'maxLength': 80, 'minLength': 1}, 'message': {'const': 'Service is not ready.'}}, 'additionalProperties': False}, 'status': {'const': 'not_ready'}, 'service': {'const': 'ardaro-receipt-intelligence'}, 'contract_version': {'const': 'ardaro.agent-receipt-intelligence.response.v1'}}, 'additionalProperties': False}, {'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['accepts'], 'properties': {'error': {'type': ['string', 'null']}, 'accepts': {'type': 'array', 'items': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}}}, 'resource': {'oneOf': [{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string'}, 'tags': {'oneOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}]}, 'iconUrl': {'type': ['string', 'null']}, 'mimeType': {'type': ['string', 'null']}, 'description': {'type': ['string', 'null']}, 'serviceName': {'type': ['string', 'null']}}}, {'type': 'null'}]}, 'extensions': {'oneOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}]}, 'x402Version': {'type': 'integer', 'const': 2, 'default': 2}}}, {'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['error'], 'properties': {'error': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'message'], 'properties': {'status': {'const': 'error'}, 'message': {'type': 'string'}}, 'additionalProperties': False}]}
compress_agent_context
Context formatting review
Return a blank-line compaction candidate for human review. Preserves words and role headers. No verified token savings, semantic equivalence or speed improvement. Paid: 0.05 USDC per accepted analysis, including an unfavorable advisory result. Check get_utility_service_status with service='compress_agent_context' and the free fixed example first. Owner-authorized x402 payment is required; tool discovery does not authorize spending.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['raw_conversation_history'], 'properties': {'raw_conversation_history': {'type': 'string', 'maxLength': 32768, 'minLength': 1, 'description': 'Caller-supplied text; do not submit secrets or private tenant data.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'anyOf': [{'type': 'object', 'required': ['contract_version', 'service_id', 'status', 'result', 'identities'], 'properties': {'result': {'type': 'object', 'required': ['status', 'compressed_prompt_payload', 'transformation', 'original_characters', 'candidate_characters', 'characters_removed', 'tokens_saved', 'tokenizer_used', 'compression_ratio', 'semantic_preservation_verified', 'human_review_required', 'latency_or_cost_savings_verified'], 'properties': {'status': {'type': 'string', 'const': 'REVIEW_CANDIDATE'}, 'tokens_saved': {'type': 'null'}, 'tokenizer_used': {'type': 'null'}, 'transformation': {'type': 'string', 'const': 'Reduce three or more consecutive LF/CRLF line breaks to two LF line breaks; no words or role headers removed'}, 'compression_ratio': {'type': 'null'}, 'characters_removed': {'type': 'integer', 'maximum': 32767, 'minimum': 0}, 'original_characters': {'type': 'integer', 'maximum': 32768, 'minimum': 1}, 'candidate_characters': {'type': 'integer', 'maximum': 32768, 'minimum': 1}, 'human_review_required': {'type': 'boolean', 'const': True}, 'compressed_prompt_payload': {'type': 'string', 'maxLength': 32768, 'minLength': 1}, 'semantic_preservation_verified': {'type': 'boolean', 'const': False}, 'latency_or_cost_savings_verified': {'type': 'boolean', 'const': False}}, 'additionalProperties': False}, 'status': {'const': 'review_required'}, 'identities': {'type': 'object', 'required': ['analysis_result_identity', 'payment_identity'], 'properties': {'payment_identity': {'type': 'object', 'required': ['protocol', 'reference', 'replayed'], 'properties': {'protocol': {'const': 'x402-v2'}, 'replayed': {'type': 'boolean'}, 'reference': {'type': 'string', 'pattern': '^pay_[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'analysis_result_identity': {'type': 'string', 'pattern': '^res_[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'service_id': {'const': 'ardaro.compress_agent_context'}, 'contract_version': {'const': 'ardaro.agent-utilities.response.v1'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['contract_version', 'status', 'error'], 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string', 'maxLength': 100}, 'message': {'type': 'string', 'maxLength': 300}}, 'additionalProperties': False}, 'status': {'const': 'error'}, 'contract_version': {'const': 'ardaro.agent-utilities.response.v1'}}, 'additionalProperties': False}, {'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['contract_version', 'status', 'error'], 'properties': {'error': {'type': 'object', 'required': ['code', 'service_code', 'message', 'retryable', 'remediation'], 'properties': {'code': {'type': 'string', 'maxLength': 80}, 'message': {'type': 'string', 'maxLength': 280}, 'retryable': {'type': 'boolean'}, 'remediation': {'type': 'string', 'maxLength': 280}, 'service_code': {'enum': ['ARDARO_ARITHMETIC_MISMATCH', 'ARDARO_DOCUMENT_TOO_LARGE', 'ARDARO_DUPLICATE_SUSPECTED', 'ARDARO_EXTRACTION_LOW_CONFIDENCE', 'ARDARO_IDEMPOTENCY_CONFLICT', 'ARDARO_INPUT_UNSUPPORTED', 'ARDARO_PAYMENT_INVALID', 'ARDARO_PAYMENT_RECONCILIATION_REQUIRED', 'ARDARO_PAYMENT_REQUIRED', 'ARDARO_RATE_LIMITED', 'ARDARO_SERVICE_UNAVAILABLE']}}, 'additionalProperties': False}, 'status': {'const': 'error'}, 'contract_version': {'const': 'ardaro.agent-receipt-intelligence.response.v1'}}, 'additionalProperties': False}, {'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['contract_version', 'status', 'service', 'error'], 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string', 'maxLength': 80, 'minLength': 1}, 'message': {'const': 'Service is not ready.'}}, 'additionalProperties': False}, 'status': {'const': 'not_ready'}, 'service': {'const': 'ardaro-receipt-intelligence'}, 'contract_version': {'const': 'ardaro.agent-receipt-intelligence.response.v1'}}, 'additionalProperties': False}, {'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['accepts'], 'properties': {'error': {'type': ['string', 'null']}, 'accepts': {'type': 'array', 'items': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}}}, 'resource': {'oneOf': [{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string'}, 'tags': {'oneOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}]}, 'iconUrl': {'type': ['string', 'null']}, 'mimeType': {'type': ['string', 'null']}, 'description': {'type': ['string', 'null']}, 'serviceName': {'type': ['string', 'null']}}}, {'type': 'null'}]}, 'extensions': {'oneOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}]}, 'x402Version': {'type': 'integer', 'const': 2, 'default': 2}}}, {'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['error'], 'properties': {'error': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'message'], 'properties': {'status': {'const': 'error'}, 'message': {'type': 'string'}}, 'additionalProperties': False}]}
get_utility_example
Get utility example
Inspect a fixed synthetic request and expected result before integrating or paying. Select service from the enum; no caller document is accepted, processed or stored. Returns service and details containing that service's example. Free; no wallet authorization. Use get_utility_service_status for current readiness, prices and retention instead.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['service'], 'properties': {'service': {'enum': ['compress_agent_context', 'route_model_intent', 'authorize_agent_spend', 'reconcile_api_ledger'], 'type': 'string', 'description': 'Service whose fixed example or current terms to inspect.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['service', 'details'], 'properties': {'details': {'type': 'object', 'required': ['example_version', 'service_id', 'synthetic_only', 'request', 'response', 'policy'], 'properties': {'policy': {'type': 'object', 'required': ['payment_required', 'human_review_required', 'financial_posting_supported'], 'properties': {'payment_required': {'const': False}, 'human_review_required': {'const': True}, 'financial_posting_supported': {'const': False}}}, 'request': {'type': 'object', 'required': ['raw_conversation_history'], 'properties': {'raw_conversation_history': {'type': 'string', 'maxLength': 32768, 'minLength': 1, 'description': 'Caller-supplied text; do not submit secrets or private tenant data.'}}, 'additionalProperties': False}, 'response': {'type': 'object', 'required': ['contract_version', 'service_id', 'status', 'result', 'identities'], 'properties': {'result': {'type': 'object', 'required': ['status', 'compressed_prompt_payload', 'transformation', 'original_characters', 'candidate_characters', 'characters_removed', 'tokens_saved', 'tokenizer_used', 'compression_ratio', 'semantic_preservation_verified', 'human_review_required', 'latency_or_cost_savings_verified'], 'properties': {'status': {'type': 'string', 'const': 'REVIEW_CANDIDATE'}, 'tokens_saved': {'type': 'null'}, 'tokenizer_used': {'type': 'null'}, 'transformation': {'type': 'string', 'const': 'Reduce three or more consecutive LF/CRLF line breaks to two LF line breaks; no words or role headers removed'}, 'compression_ratio': {'type': 'null'}, 'characters_removed': {'type': 'integer', 'maximum': 32767, 'minimum': 0}, 'original_characters': {'type': 'integer', 'maximum': 32768, 'minimum': 1}, 'candidate_characters': {'type': 'integer', 'maximum': 32768, 'minimum': 1}, 'human_review_required': {'type': 'boolean', 'const': True}, 'compressed_prompt_payload': {'type': 'string', 'maxLength': 32768, 'minLength': 1}, 'semantic_preservation_verified': {'type': 'boolean', 'const': False}, 'latency_or_cost_savings_verified': {'type': 'boolean', 'const': False}}, 'additionalProperties': False}, 'status': {'const': 'review_required'}, 'identities': {'type': 'object', 'required': ['analysis_result_identity'], 'properties': {'payment_identity': {'type': 'object', 'required': ['protocol', 'reference', 'replayed'], 'properties': {'protocol': {'const': 'x402-v2'}, 'replayed': {'type': 'boolean'}, 'reference': {'type': 'string', 'pattern': '^pay_[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'analysis_result_identity': {'type': 'string', 'pattern': '^res_[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'service_id': {'const': 'ardaro.compress_agent_context'}, 'contract_version': {'const': 'ardaro.agent-utilities.response.v1'}}, 'additionalProperties': False}, 'service_id': {'const': 'ardaro.compress_agent_context'}, 'synthetic_only': {'const': True}, 'example_version': {'const': 'ardaro.agent-utilities.example.v1'}}, 'additionalProperties': False}, 'service': {'const': 'compress_agent_context'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['service', 'details'], 'properties': {'details': {'type': 'object', 'required': ['example_version', 'service_id', 'synthetic_only', 'request', 'response', 'policy'], 'properties': {'policy': {'type': 'object', 'required': ['payment_required', 'human_review_required', 'financial_posting_supported'], 'properties': {'payment_required': {'const': False}, 'human_review_required': {'const': True}, 'financial_posting_supported': {'const': False}}}, 'request': {'type': 'object', 'required': ['intent_payload'], 'properties': {'intent_payload': {'type': 'string', 'maxLength': 32768, 'minLength': 1, 'description': 'Caller-supplied text; do not submit secrets or private tenant data.'}}, 'additionalProperties': False}, 'response': {'type': 'object', 'required': ['contract_version', 'service_id', 'status', 'result', 'identities'], 'properties': {'result': {'type': 'object', 'required': ['status', 'route_category', 'routing_basis', 'recommended_model', 'route_executed', 'human_review_required'], 'properties': {'status': {'type': 'string', 'const': 'ADVISORY_ROUTE'}, 'routing_basis': {'type': 'string', 'const': 'Keyword heuristic only; no model capability, availability or price comparison'}, 'route_category': {'enum': ['structured-calculation-review', 'general-text-review'], 'type': 'string'}, 'route_executed': {'type': 'boolean', 'const': False}, 'recommended_model': {'type': 'null'}, 'human_review_required': {'type': 'boolean', 'const': True}}, 'additionalProperties': False}, 'status': {'const': 'review_required'}, 'identities': {'type': 'object', 'required': ['analysis_result_identity'], 'properties': {'payment_identity': {'type': 'object', 'required': ['protocol', 'reference', 'replayed'], 'properties': {'protocol': {'const': 'x402-v2'}, 'replayed': {'type': 'boolean'}, 'reference': {'type': 'string', 'pattern': '^pay_[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'analysis_result_identity': {'type': 'string', 'pattern': '^res_[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'service_id': {'const': 'ardaro.route_model_intent'}, 'contract_version': {'const': 'ardaro.agent-utilities.response.v1'}}, 'additionalProperties': False}, 'service_id': {'const': 'ardaro.route_model_intent'}, 'synthetic_only': {'const': True}, 'example_version': {'const': 'ardaro.agent-utilities.example.v1'}}, 'additionalProperties': False}, 'service': {'const': 'route_model_intent'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['service', 'details'], 'properties': {'details': {'type': 'object', 'required': ['example_version', 'service_id', 'synthetic_only', 'request', 'response', 'policy'], 'properties': {'policy': {'type': 'object', 'required': ['payment_required', 'human_review_required', 'financial_posting_supported'], 'properties': {'payment_required': {'const': False}, 'human_review_required': {'const': True}, 'financial_posting_supported': {'const': False}}}, 'request': {'type': 'object', 'required': ['proposed_cost', 'currency', 'policy', 'history'], 'properties': {'policy': {'type': 'object', 'required': ['currency', 'max_per_transaction', 'max_per_hour', 'max_checks_per_minute'], 'properties': {'currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'max_per_hour': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$', 'maxLength': 16, 'minLength': 1}, 'max_per_transaction': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$', 'maxLength': 16, 'minLength': 1}, 'max_checks_per_minute': {'type': 'integer', 'maximum': 1000000, 'minimum': 1}}, 'additionalProperties': False}, 'history': {'type': 'object', 'required': ['currency', 'committed_last_hour', 'pending_reserved', 'checks_last_minute'], 'properties': {'currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'pending_reserved': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$', 'maxLength': 16, 'minLength': 1}, 'checks_last_minute': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}, 'committed_last_hour': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$', 'maxLength': 16, 'minLength': 1}}, 'additionalProperties': False}, 'currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'proposed_cost': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$', 'maxLength': 16, 'minLength': 1}}, 'additionalProperties': False}, 'response': {'type': 'object', 'required': ['contract_version', 'service_id', 'status', 'result', 'identities'], 'properties': {'result': {'type': 'object', 'required': ['tool', 'authorization_status', 'currency', 'policy_currency', 'history_currency', 'proposed_cost', 'submitted_budget_in_use', 'proposed_hour_total', 'hourly_remaining_after_proposal', 'checks', 'findings', 'policy'], 'properties': {'tool': {'const': 'authorize_agent_spend'}, 'checks': {'type': 'object', 'required': ['currency_consistent', 'transaction_within_limit', 'hourly_within_limit', 'rate_within_limit'], 'properties': {'rate_within_limit': {'type': 'boolean'}, 'currency_consistent': {'type': 'boolean'}, 'hourly_within_limit': {'type': ['boolean', 'null']}, 'transaction_within_limit': {'type': ['boolean', 'null']}}, 'additionalProperties': False}, 'policy': {'type': 'object', 'required': ['advisory_only', 'stateless', 'submitted_records_retained', 'caller_identity_authenticated', 'submitted_evidence_verified', 'external_spend_enforced', 'downstream_payment_authorized', 'reservation_created', 'ledger_updated', 'credentials_issued', 'delivery_verified', 'model_calls', 'human_review_required', 'policy_authenticated', 'history_verified', 'checks_exclude_service_fee', 'scope', 'fee_scope', 'history_scope'], 'properties': {'scope': {'const': 'Compares caller-supplied downstream maximum cost with caller-supplied limits and history. A within-limits result is not authorization, a reservation, or evidence that actual spend is controlled.'}, 'fee_scope': {'const': 'The separately quoted service fee is excluded from these checks and must be budgeted separately in USDC. No USD/USDC conversion is performed.'}, 'stateless': {'const': True}, 'model_calls': {'const': 0}, 'advisory_only': {'const': True}, 'history_scope': {'const': 'The caller supplies committed cost for its intended rolling-hour window, all unresolved pending reservations, and the count of prior checks in its intended minute. Completeness and timing are not verified.'}, 'ledger_updated': {'const': False}, 'history_verified': {'const': False}, 'delivery_verified': {'const': False}, 'credentials_issued': {'const': False}, 'reservation_created': {'const': False}, 'policy_authenticated': {'const': False}, 'human_review_required': {'const': True}, 'external_spend_enforced': {'const': False}, 'checks_exclude_service_fee': {'const': True}, 'submitted_records_retained': {'const': False}, 'submitted_evidence_verified': {'const': False}, 'caller_identity_authenticated': {'const': False}, 'downstream_payment_authorized': {'const': False}}, 'additionalProperties': False}, 'currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'findings': {'type': 'array', 'items': {'enum': ['CURRENCY_MISMATCH', 'TRANSACTION_LIMIT_EXCEEDED', 'HOURLY_LIMIT_EXCEEDED', 'RATE_THRESHOLD_EXCEEDED']}, 'maxItems': 3, 'uniqueItems': True}, 'proposed_cost': {'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$', 'maxLength': 18, 'minLength': 8}, 'policy_currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'history_currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'proposed_hour_total': {'anyOf': [{'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$', 'maxLength': 18, 'minLength': 8}, {'type': 'null'}]}, 'authorization_status': {'enum': ['WITHIN_SUBMITTED_LIMITS', 'EXCEEDS_SUBMITTED_LIMITS', 'RATE_THRESHOLD_EXCEEDED', 'CURRENCY_MISMATCH']}, 'submitted_budget_in_use': {'anyOf': [{'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$', 'maxLength': 18, 'minLength': 8}, {'type': 'null'}]}, 'hourly_remaining_after_proposal': {'anyOf': [{'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$', 'maxLength': 18, 'minLength': 8}, {'type': 'null'}]}}, 'additionalProperties': False}, 'status': {'const': 'review_required'}, 'identities': {'type': 'object', 'required': ['analysis_result_identity'], 'properties': {'payment_identity': {'type': 'object', 'required': ['protocol', 'reference', 'replayed'], 'properties': {'protocol': {'const': 'x402-v2'}, 'replayed': {'type': 'boolean'}, 'reference': {'type': 'string', 'pattern': '^pay_[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'analysis_result_identity': {'type': 'string', 'pattern': '^res_[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'service_id': {'const': 'ardaro.authorize_agent_spend'}, 'contract_version': {'const': 'ardaro.agent-utilities.response.v1'}}, 'additionalProperties': False}, 'service_id': {'const': 'ardaro.authorize_agent_spend'}, 'synthetic_only': {'const': True}, 'example_version': {'const': 'ardaro.agent-utilities.example.v1'}}, 'additionalProperties': False}, 'service': {'const': 'authorize_agent_spend'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['service', 'details'], 'properties': {'details': {'type': 'object', 'required': ['example_version', 'service_id', 'synthetic_only', 'request', 'response', 'policy'], 'properties': {'policy': {'type': 'object', 'required': ['payment_required', 'human_review_required', 'financial_posting_supported'], 'properties': {'payment_required': {'const': False}, 'human_review_required': {'const': True}, 'financial_posting_supported': {'const': False}}}, 'request': {'type': 'object', 'required': ['billing_records', 'usage_records'], 'properties': {'usage_records': {'type': 'array', 'items': {'type': 'object', 'required': ['request_id', 'amount', 'currency'], 'properties': {'amount': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$', 'maxLength': 16, 'minLength': 1}, 'currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'request_id': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$', 'maxLength': 128, 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 100}, 'billing_records': {'type': 'array', 'items': {'type': 'object', 'required': ['request_id', 'amount', 'currency'], 'properties': {'amount': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$', 'maxLength': 16, 'minLength': 1}, 'currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'request_id': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$', 'maxLength': 128, 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 100}}, 'additionalProperties': False}, 'response': {'type': 'object', 'required': ['contract_version', 'service_id', 'status', 'result', 'identities'], 'properties': {'result': {'type': 'object', 'required': ['tool', 'reconciliation_status', 'records_compared', 'matched_record_count', 'issues', 'totals_by_currency', 'policy'], 'properties': {'tool': {'const': 'reconcile_api_ledger'}, 'issues': {'type': 'array', 'items': {'type': 'object', 'required': ['request_id', 'codes'], 'properties': {'codes': {'type': 'array', 'items': {'enum': ['MISSING_BILLING_RECORD', 'MISSING_USAGE_RECORD', 'CURRENCY_MISMATCH', 'AMOUNT_MISMATCH']}, 'maxItems': 1, 'minItems': 1}, 'request_id': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$', 'maxLength': 128, 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 200}, 'policy': {'type': 'object', 'required': ['advisory_only', 'stateless', 'submitted_records_retained', 'caller_identity_authenticated', 'submitted_evidence_verified', 'external_spend_enforced', 'downstream_payment_authorized', 'reservation_created', 'ledger_updated', 'credentials_issued', 'delivery_verified', 'model_calls', 'human_review_required', 'telemetry_independently_verified', 'scope'], 'properties': {'scope': {'const': 'Compares caller-supplied billing and usage observations only. Matching records may both be inaccurate or incomplete. No reservation database, authenticated provider receipt, network packet, delivery, or blockchain record is inspected.'}, 'stateless': {'const': True}, 'model_calls': {'const': 0}, 'advisory_only': {'const': True}, 'ledger_updated': {'const': False}, 'delivery_verified': {'const': False}, 'credentials_issued': {'const': False}, 'reservation_created': {'const': False}, 'human_review_required': {'const': True}, 'external_spend_enforced': {'const': False}, 'submitted_records_retained': {'const': False}, 'submitted_evidence_verified': {'const': False}, 'caller_identity_authenticated': {'const': False}, 'downstream_payment_authorized': {'const': False}, 'telemetry_independently_verified': {'const': False}}, 'additionalProperties': False}, 'records_compared': {'type': 'integer', 'maximum': 200, 'minimum': 0}, 'totals_by_currency': {'type': 'array', 'items': {'type': 'object', 'required': ['currency', 'billing_total', 'usage_total', 'billing_count', 'usage_count'], 'properties': {'currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'usage_count': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'usage_total': {'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$', 'maxLength': 18, 'minLength': 8}, 'billing_count': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'billing_total': {'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$', 'maxLength': 18, 'minLength': 8}}, 'additionalProperties': False}, 'maxItems': 2}, 'matched_record_count': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'reconciliation_status': {'enum': ['NO_RECORDS', 'MATCHED_SUBMITTED_RECORDS', 'DISCREPANCIES_FOUND']}}, 'additionalProperties': False}, 'status': {'const': 'review_required'}, 'identities': {'type': 'object', 'required': ['analysis_result_identity'], 'properties': {'payment_identity': {'type': 'object', 'required': ['protocol', 'reference', 'replayed'], 'properties': {'protocol': {'const': 'x402-v2'}, 'replayed': {'type': 'boolean'}, 'reference': {'type': 'string', 'pattern': '^pay_[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'analysis_result_identity': {'type': 'string', 'pattern': '^res_[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'service_id': {'const': 'ardaro.reconcile_api_ledger'}, 'contract_version': {'const': 'ardaro.agent-utilities.response.v1'}}, 'additionalProperties': False}, 'service_id': {'const': 'ardaro.reconcile_api_ledger'}, 'synthetic_only': {'const': True}, 'example_version': {'const': 'ardaro.agent-utilities.example.v1'}}, 'additionalProperties': False}, 'service': {'const': 'reconcile_api_ledger'}}, 'additionalProperties': False}]}
get_utility_service_status
Get utility readiness and terms
Check the selected service's current runtime readiness, input limits, pricing and retention before use. Returns service and details; ready=false means the underlying service is unavailable. Free cached runtime read; no external probe, payment, analysis or historical document retrieval. Use get_utility_example for a fixed integration sample instead.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['service'], 'properties': {'service': {'enum': ['compress_agent_context', 'route_model_intent', 'authorize_agent_spend', 'reconcile_api_ledger'], 'type': 'string', 'description': 'Service whose fixed example or current terms to inspect.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['service', 'details'], 'properties': {'details': {'type': 'object', 'required': ['status_version', 'service_id', 'ready', 'reason', 'price', 'policy', 'retention', 'limits', 'endpoints'], 'properties': {'price': {'type': 'object', 'required': ['amount', 'amount_atomic', 'currency', 'network'], 'properties': {'amount': {'type': 'string'}, 'network': {'type': 'string'}, 'currency': {'const': 'USDC'}, 'amount_atomic': {'type': 'string', 'pattern': '^[0-9]+$'}}}, 'ready': {'type': 'boolean'}, 'limits': {'type': 'object'}, 'policy': {'type': 'object'}, 'reason': {'type': 'string'}, 'endpoints': {'type': 'object'}, 'retention': {'type': 'object'}, 'service_id': {'const': 'ardaro.compress_agent_context'}, 'description': {'type': 'string'}, 'status_version': {'const': 'ardaro.agent-utilities.status.v1'}, 'settlement_proven': {'type': 'boolean'}, 'acceptance_evidence': {'type': ['object', 'null']}, 'settlement_proven_transport': {'type': ['string', 'null']}}}, 'service': {'const': 'compress_agent_context'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['service', 'details'], 'properties': {'details': {'type': 'object', 'required': ['status_version', 'service_id', 'ready', 'reason', 'price', 'policy', 'retention', 'limits', 'endpoints'], 'properties': {'price': {'type': 'object', 'required': ['amount', 'amount_atomic', 'currency', 'network'], 'properties': {'amount': {'type': 'string'}, 'network': {'type': 'string'}, 'currency': {'const': 'USDC'}, 'amount_atomic': {'type': 'string', 'pattern': '^[0-9]+$'}}}, 'ready': {'type': 'boolean'}, 'limits': {'type': 'object'}, 'policy': {'type': 'object'}, 'reason': {'type': 'string'}, 'endpoints': {'type': 'object'}, 'retention': {'type': 'object'}, 'service_id': {'const': 'ardaro.route_model_intent'}, 'description': {'type': 'string'}, 'status_version': {'const': 'ardaro.agent-utilities.status.v1'}, 'settlement_proven': {'type': 'boolean'}, 'acceptance_evidence': {'type': ['object', 'null']}, 'settlement_proven_transport': {'type': ['string', 'null']}}}, 'service': {'const': 'route_model_intent'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['service', 'details'], 'properties': {'details': {'type': 'object', 'required': ['status_version', 'service_id', 'ready', 'reason', 'price', 'policy', 'retention', 'limits', 'endpoints'], 'properties': {'price': {'type': 'object', 'required': ['amount', 'amount_atomic', 'currency', 'network'], 'properties': {'amount': {'type': 'string'}, 'network': {'type': 'string'}, 'currency': {'const': 'USDC'}, 'amount_atomic': {'type': 'string', 'pattern': '^[0-9]+$'}}}, 'ready': {'type': 'boolean'}, 'limits': {'type': 'object'}, 'policy': {'type': 'object'}, 'reason': {'type': 'string'}, 'endpoints': {'type': 'object'}, 'retention': {'type': 'object'}, 'service_id': {'const': 'ardaro.authorize_agent_spend'}, 'description': {'type': 'string'}, 'status_version': {'const': 'ardaro.agent-utilities.status.v1'}, 'settlement_proven': {'type': 'boolean'}, 'acceptance_evidence': {'type': ['object', 'null']}, 'settlement_proven_transport': {'type': ['string', 'null']}}}, 'service': {'const': 'authorize_agent_spend'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['service', 'details'], 'properties': {'details': {'type': 'object', 'required': ['status_version', 'service_id', 'ready', 'reason', 'price', 'policy', 'retention', 'limits', 'endpoints'], 'properties': {'price': {'type': 'object', 'required': ['amount', 'amount_atomic', 'currency', 'network'], 'properties': {'amount': {'type': 'string'}, 'network': {'type': 'string'}, 'currency': {'const': 'USDC'}, 'amount_atomic': {'type': 'string', 'pattern': '^[0-9]+$'}}}, 'ready': {'type': 'boolean'}, 'limits': {'type': 'object'}, 'policy': {'type': 'object'}, 'reason': {'type': 'string'}, 'endpoints': {'type': 'object'}, 'retention': {'type': 'object'}, 'service_id': {'const': 'ardaro.reconcile_api_ledger'}, 'description': {'type': 'string'}, 'status_version': {'const': 'ardaro.agent-utilities.status.v1'}, 'settlement_proven': {'type': 'boolean'}, 'acceptance_evidence': {'type': ['object', 'null']}, 'settlement_proven_transport': {'type': ['string', 'null']}}}, 'service': {'const': 'reconcile_api_ledger'}}, 'additionalProperties': False}]}
reconcile_api_ledger
Submitted billing reconciliation
Compare supplied billing and usage records by request ID, exact amount and currency. Flags missing or mismatched records. Does not authenticate telemetry, verify delivery or post to accounting. Paid: 0.25 USDC per accepted analysis, including an unfavorable advisory result. Check get_utility_service_status with service='reconcile_api_ledger' and the free fixed example first. Owner-authorized x402 payment is required; tool discovery does not authorize spending.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['billing_records', 'usage_records'], 'properties': {'usage_records': {'type': 'array', 'items': {'type': 'object', 'required': ['request_id', 'amount', 'currency'], 'properties': {'amount': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$', 'maxLength': 16, 'minLength': 1}, 'currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'request_id': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$', 'maxLength': 128, 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 100}, 'billing_records': {'type': 'array', 'items': {'type': 'object', 'required': ['request_id', 'amount', 'currency'], 'properties': {'amount': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,8})(?:\\.[0-9]{1,6})?$', 'maxLength': 16, 'minLength': 1}, 'currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'request_id': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$', 'maxLength': 128, 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 100}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'anyOf': [{'type': 'object', 'required': ['contract_version', 'service_id', 'status', 'result', 'identities'], 'properties': {'result': {'type': 'object', 'required': ['tool', 'reconciliation_status', 'records_compared', 'matched_record_count', 'issues', 'totals_by_currency', 'policy'], 'properties': {'tool': {'const': 'reconcile_api_ledger'}, 'issues': {'type': 'array', 'items': {'type': 'object', 'required': ['request_id', 'codes'], 'properties': {'codes': {'type': 'array', 'items': {'enum': ['MISSING_BILLING_RECORD', 'MISSING_USAGE_RECORD', 'CURRENCY_MISMATCH', 'AMOUNT_MISMATCH']}, 'maxItems': 1, 'minItems': 1}, 'request_id': {'not': {'pattern': '\\n'}, 'type': 'string', 'pattern': '^[A-Za-z0-9][A-Za-z0-9_.:-]{0,127}$', 'maxLength': 128, 'minLength': 1}}, 'additionalProperties': False}, 'maxItems': 200}, 'policy': {'type': 'object', 'required': ['advisory_only', 'stateless', 'submitted_records_retained', 'caller_identity_authenticated', 'submitted_evidence_verified', 'external_spend_enforced', 'downstream_payment_authorized', 'reservation_created', 'ledger_updated', 'credentials_issued', 'delivery_verified', 'model_calls', 'human_review_required', 'telemetry_independently_verified', 'scope'], 'properties': {'scope': {'const': 'Compares caller-supplied billing and usage observations only. Matching records may both be inaccurate or incomplete. No reservation database, authenticated provider receipt, network packet, delivery, or blockchain record is inspected.'}, 'stateless': {'const': True}, 'model_calls': {'const': 0}, 'advisory_only': {'const': True}, 'ledger_updated': {'const': False}, 'delivery_verified': {'const': False}, 'credentials_issued': {'const': False}, 'reservation_created': {'const': False}, 'human_review_required': {'const': True}, 'external_spend_enforced': {'const': False}, 'submitted_records_retained': {'const': False}, 'submitted_evidence_verified': {'const': False}, 'caller_identity_authenticated': {'const': False}, 'downstream_payment_authorized': {'const': False}, 'telemetry_independently_verified': {'const': False}}, 'additionalProperties': False}, 'records_compared': {'type': 'integer', 'maximum': 200, 'minimum': 0}, 'totals_by_currency': {'type': 'array', 'items': {'type': 'object', 'required': ['currency', 'billing_total', 'usage_total', 'billing_count', 'usage_count'], 'properties': {'currency': {'enum': ['USD', 'USDC'], 'type': 'string'}, 'usage_count': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'usage_total': {'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$', 'maxLength': 18, 'minLength': 8}, 'billing_count': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'billing_total': {'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,10})\\.[0-9]{6}$', 'maxLength': 18, 'minLength': 8}}, 'additionalProperties': False}, 'maxItems': 2}, 'matched_record_count': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'reconciliation_status': {'enum': ['NO_RECORDS', 'MATCHED_SUBMITTED_RECORDS', 'DISCREPANCIES_FOUND']}}, 'additionalProperties': False}, 'status': {'const': 'review_required'}, 'identities': {'type': 'object', 'required': ['analysis_result_identity', 'payment_identity'], 'properties': {'payment_identity': {'type': 'object', 'required': ['protocol', 'reference', 'replayed'], 'properties': {'protocol': {'const': 'x402-v2'}, 'replayed': {'type': 'boolean'}, 'reference': {'type': 'string', 'pattern': '^pay_[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'analysis_result_identity': {'type': 'string', 'pattern': '^res_[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'service_id': {'const': 'ardaro.reconcile_api_ledger'}, 'contract_version': {'const': 'ardaro.agent-utilities.response.v1'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['contract_version', 'status', 'error'], 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string', 'maxLength': 100}, 'message': {'type': 'string', 'maxLength': 300}}, 'additionalProperties': False}, 'status': {'const': 'error'}, 'contract_version': {'const': 'ardaro.agent-utilities.response.v1'}}, 'additionalProperties': False}, {'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['contract_version', 'status', 'error'], 'properties': {'error': {'type': 'object', 'required': ['code', 'service_code', 'message', 'retryable', 'remediation'], 'properties': {'code': {'type': 'string', 'maxLength': 80}, 'message': {'type': 'string', 'maxLength': 280}, 'retryable': {'type': 'boolean'}, 'remediation': {'type': 'string', 'maxLength': 280}, 'service_code': {'enum': ['ARDARO_ARITHMETIC_MISMATCH', 'ARDARO_DOCUMENT_TOO_LARGE', 'ARDARO_DUPLICATE_SUSPECTED', 'ARDARO_EXTRACTION_LOW_CONFIDENCE', 'ARDARO_IDEMPOTENCY_CONFLICT', 'ARDARO_INPUT_UNSUPPORTED', 'ARDARO_PAYMENT_INVALID', 'ARDARO_PAYMENT_RECONCILIATION_REQUIRED', 'ARDARO_PAYMENT_REQUIRED', 'ARDARO_RATE_LIMITED', 'ARDARO_SERVICE_UNAVAILABLE']}}, 'additionalProperties': False}, 'status': {'const': 'error'}, 'contract_version': {'const': 'ardaro.agent-receipt-intelligence.response.v1'}}, 'additionalProperties': False}, {'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['contract_version', 'status', 'service', 'error'], 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string', 'maxLength': 80, 'minLength': 1}, 'message': {'const': 'Service is not ready.'}}, 'additionalProperties': False}, 'status': {'const': 'not_ready'}, 'service': {'const': 'ardaro-receipt-intelligence'}, 'contract_version': {'const': 'ardaro.agent-receipt-intelligence.response.v1'}}, 'additionalProperties': False}, {'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['accepts'], 'properties': {'error': {'type': ['string', 'null']}, 'accepts': {'type': 'array', 'items': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}}}, 'resource': {'oneOf': [{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string'}, 'tags': {'oneOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}]}, 'iconUrl': {'type': ['string', 'null']}, 'mimeType': {'type': ['string', 'null']}, 'description': {'type': ['string', 'null']}, 'serviceName': {'type': ['string', 'null']}}}, {'type': 'null'}]}, 'extensions': {'oneOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}]}, 'x402Version': {'type': 'integer', 'const': 2, 'default': 2}}}, {'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['error'], 'properties': {'error': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'message'], 'properties': {'status': {'const': 'error'}, 'message': {'type': 'string'}}, 'additionalProperties': False}]}
route_model_intent
Intent classification review
Classify text with a bounded keyword heuristic for human review. Does not execute a model, select a verified cheapest model or prove routing savings. Paid: 0.15 USDC per accepted analysis, including an unfavorable advisory result. Check get_utility_service_status with service='route_model_intent' and the free fixed example first. Owner-authorized x402 payment is required; tool discovery does not authorize spending.
Read only
Idempotent
Input schema
{'type': 'object', 'required': ['intent_payload'], 'properties': {'intent_payload': {'type': 'string', 'maxLength': 32768, 'minLength': 1, 'description': 'Caller-supplied text; do not submit secrets or private tenant data.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'anyOf': [{'type': 'object', 'required': ['contract_version', 'service_id', 'status', 'result', 'identities'], 'properties': {'result': {'type': 'object', 'required': ['status', 'route_category', 'routing_basis', 'recommended_model', 'route_executed', 'human_review_required'], 'properties': {'status': {'type': 'string', 'const': 'ADVISORY_ROUTE'}, 'routing_basis': {'type': 'string', 'const': 'Keyword heuristic only; no model capability, availability or price comparison'}, 'route_category': {'enum': ['structured-calculation-review', 'general-text-review'], 'type': 'string'}, 'route_executed': {'type': 'boolean', 'const': False}, 'recommended_model': {'type': 'null'}, 'human_review_required': {'type': 'boolean', 'const': True}}, 'additionalProperties': False}, 'status': {'const': 'review_required'}, 'identities': {'type': 'object', 'required': ['analysis_result_identity', 'payment_identity'], 'properties': {'payment_identity': {'type': 'object', 'required': ['protocol', 'reference', 'replayed'], 'properties': {'protocol': {'const': 'x402-v2'}, 'replayed': {'type': 'boolean'}, 'reference': {'type': 'string', 'pattern': '^pay_[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'analysis_result_identity': {'type': 'string', 'pattern': '^res_[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'service_id': {'const': 'ardaro.route_model_intent'}, 'contract_version': {'const': 'ardaro.agent-utilities.response.v1'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['contract_version', 'status', 'error'], 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string', 'maxLength': 100}, 'message': {'type': 'string', 'maxLength': 300}}, 'additionalProperties': False}, 'status': {'const': 'error'}, 'contract_version': {'const': 'ardaro.agent-utilities.response.v1'}}, 'additionalProperties': False}, {'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['contract_version', 'status', 'error'], 'properties': {'error': {'type': 'object', 'required': ['code', 'service_code', 'message', 'retryable', 'remediation'], 'properties': {'code': {'type': 'string', 'maxLength': 80}, 'message': {'type': 'string', 'maxLength': 280}, 'retryable': {'type': 'boolean'}, 'remediation': {'type': 'string', 'maxLength': 280}, 'service_code': {'enum': ['ARDARO_ARITHMETIC_MISMATCH', 'ARDARO_DOCUMENT_TOO_LARGE', 'ARDARO_DUPLICATE_SUSPECTED', 'ARDARO_EXTRACTION_LOW_CONFIDENCE', 'ARDARO_IDEMPOTENCY_CONFLICT', 'ARDARO_INPUT_UNSUPPORTED', 'ARDARO_PAYMENT_INVALID', 'ARDARO_PAYMENT_RECONCILIATION_REQUIRED', 'ARDARO_PAYMENT_REQUIRED', 'ARDARO_RATE_LIMITED', 'ARDARO_SERVICE_UNAVAILABLE']}}, 'additionalProperties': False}, 'status': {'const': 'error'}, 'contract_version': {'const': 'ardaro.agent-receipt-intelligence.response.v1'}}, 'additionalProperties': False}, {'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['contract_version', 'status', 'service', 'error'], 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'string', 'maxLength': 80, 'minLength': 1}, 'message': {'const': 'Service is not ready.'}}, 'additionalProperties': False}, 'status': {'const': 'not_ready'}, 'service': {'const': 'ardaro-receipt-intelligence'}, 'contract_version': {'const': 'ardaro.agent-receipt-intelligence.response.v1'}}, 'additionalProperties': False}, {'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['accepts'], 'properties': {'error': {'type': ['string', 'null']}, 'accepts': {'type': 'array', 'items': {'type': 'object', 'required': ['scheme', 'network', 'asset', 'amount', 'payTo', 'maxTimeoutSeconds'], 'properties': {'asset': {'type': 'string'}, 'extra': {'type': 'object', 'additionalProperties': True}, 'payTo': {'type': 'string'}, 'amount': {'type': 'string'}, 'scheme': {'type': 'string'}, 'network': {'type': 'string'}, 'maxTimeoutSeconds': {'type': 'integer'}}}}, 'resource': {'oneOf': [{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string'}, 'tags': {'oneOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}]}, 'iconUrl': {'type': ['string', 'null']}, 'mimeType': {'type': ['string', 'null']}, 'description': {'type': ['string', 'null']}, 'serviceName': {'type': ['string', 'null']}}}, {'type': 'null'}]}, 'extensions': {'oneOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}]}, 'x402Version': {'type': 'integer', 'const': 2, 'default': 2}}}, {'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['error'], 'properties': {'error': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['status', 'message'], 'properties': {'status': {'const': 'error'}, 'message': {'type': 'string'}}, 'additionalProperties': False}]}
History
Recent tool changes
Added
get_utility_service_status
Sept. 19, 2026, 2:41 a.m.
Added
get_utility_example
Sept. 19, 2026, 2:41 a.m.
Added
reconcile_api_ledger
Sept. 19, 2026, 2:41 a.m.
Added
authorize_agent_spend
Sept. 19, 2026, 2:41 a.m.
Added
route_model_intent
Sept. 19, 2026, 2:41 a.m.
Added
compress_agent_context
Sept. 19, 2026, 2:41 a.m.
Discover
Similar MCP servers
Delx Commerce — Pay-per-Result APIs for Agents
io.github.davidmosiah/delx-mcp-a2a
Provides pay-per-result APIs and agent protocol tools for continuity, multi-agent coordination, document OCR, and crypto-related …
SAP MCP Server
ai.oobeprotocol.sap.mcp/sap-mcp
Provides an MCP gateway connecting SAP-related tools with Solana, DeFi, decentralized identity, and x402 payments.
TheProtocol — Sovereign AI Agent Platform
cloud.theprotocol/registry
Manages sovereign AI agents, identities, contracts, payments, governance, exchanges, and cross-frame token transfers.
AIMEAT
io.aimeat/aimeat
Provides a self-hosted agent operating system with agent work delegation, access controls, federation, hooks, SSO, security admin…
hyperion
com.thetempleofdoom.hyperion/hyperion
Acts as a paid MCP tool marketplace and utility gateway with server discovery, HTTP and JavaScript tools, research, data conversi…
GPT55 Model Gateway
xyz.558686.gpt55/token-gateway
Acts as a remote model gateway exposing GPT chat, coding and review services, lightweight text utilities, and prepaid or x402-bas…
Rokha
ai.rokha/rokha
Provides access to an agent-skill and MCP server registry, skill inspection and composition tools, OAuth connections, and agent a…
Japan Public Ledgers MCP
com.mcp-revenue-empire/japan-public-ledgers
Provides agent identity, memory, audit, trust, proxy, temporary email, webhook, CAPTCHA, and alerting capabilities alongside publ…