MCP Radar
MCP Server

Spoolis

com.spoolis/mcp
Business & Operations Payments & Fintech Public & reachable MCP 2025-11-25

What this MCP does

Manages agreements, acceptance criteria, evidence, verification, disputes, signed receipts, and payment settlement for completed work.

Capabilities

Tools

32 tools
abandon_spool
Spool abandonment
Abandon an active Spool (the agreement object) before payment is committed. Use when the initiator no longer wants to proceed; this ends the agreement and cannot verify work or settle value. Works in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}}, 'additionalProperties': False}
accept_spool
Spool acceptance
Confirm the compiled contract by accepting a proposed Spool (the agreement object). Use only after reviewing its terms and acceptance criteria; this records agreement acceptance but does not verify fulfillment or settle payment. Production agent agreements require the current quote digest. Works in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}, 'quote_digest': {'type': 'string', 'pattern': '^sha256:[0-9a-f]{64}$'}}, 'additionalProperties': False}
add_source
Source addition
Add a source connection for a Spool (the agreement object). Use before ingestion; this creates a connection and does not ingest evidence. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['kind', 'name', 'config', 'auth', 'deletion_semantics', 'correction_semantics'], 'properties': {'auth': {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'enum': ['none', 'api_key', 'bearer', 'basic', 'signed_webhook', 'db_credentials'], 'type': 'string'}, 'secret_ref': {'type': 'string', 'nullable': True}}, 'additionalProperties': False}, 'kind': {'enum': ['csv', 'json', 'file_upload', 'http_openapi', 'webhook_signed', 'sql_readonly', 'object_store_s3', 'cloudevents'], 'type': 'string'}, 'name': {'type': 'string', 'minLength': 1}, 'config': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'spool_id': {'type': 'string', 'pattern': '^spl_.*', 'nullable': True}, 'schema_version': {'type': 'string', 'default': '1'}, 'deletion_semantics': {'enum': ['hard', 'soft', 'tombstone', 'unknown'], 'type': 'string'}, 'correction_semantics': {'enum': ['in_place', 'append_new_version', 'unknown'], 'type': 'string'}}, 'additionalProperties': False}
amend_spool
Spool amendment
Change acceptance criteria or unit-based earned-value rules on a proposed Spool (the agreement object). Use before acceptance when the draft does not match the intended purchase; this replaces proposal details and does not accept or verify the work. Works in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}, 'unitization': {'type': 'object', 'required': ['total_units', 'unit_amount_cents'], 'properties': {'identity': {'type': 'object', 'required': ['key', 'visibility'], 'properties': {'key': {'type': 'string', 'minLength': 1}, 'visibility': {'enum': ['label', 'pseudonymous'], 'type': 'string'}}, 'additionalProperties': False}, 'total_units': {'type': 'integer', 'maximum': 100000, 'exclusiveMinimum': 0}, 'unit_amount_cents': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'add_conditions': {'type': 'array', 'items': {'type': 'object', 'required': ['description', 'required', 'verification_method'], 'properties': {'required': {'type': 'boolean'}, 'description': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'external_judge': {'type': 'object', 'required': ['evaluator_id', 'kind', 'proof_requirement'], 'properties': {'kind': {'enum': ['external_service', 'zk_verifier', 'marketplace_evaluator', 'buyer_owned', 'ai_evaluator', 'human_arbitration'], 'type': 'string'}, 'on_missing': {'enum': ['uncertain', 'fail'], 'type': 'string'}, 'public_key': {'type': 'string', 'maxLength': 10000, 'minLength': 1}, 'evaluator_id': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'score_mapping': {'type': 'object', 'required': ['schema_id', 'quality_gte', 'consensus_gte'], 'properties': {'schema_id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'quality_gte': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'consensus_gte': {'type': 'integer', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}, 'evaluator_version': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'proof_requirement': {'enum': ['signed', 'hashed_ref', 'declared'], 'type': 'string'}}, 'additionalProperties': False}, 'deterministic_check': {'oneOf': [{'type': 'object', 'required': ['checker', 'expected'], 'properties': {'checker': {'type': 'string', 'const': 'row_count'}, 'expected': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'required_fields'], 'properties': {'checker': {'type': 'string', 'const': 'completeness'}, 'required_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'minItems': 1}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'key', 'maximum'], 'properties': {'key': {'type': 'string', 'minLength': 1}, 'checker': {'type': 'string', 'const': 'duplicate_rate'}, 'maximum': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'field'], 'properties': {'field': {'type': 'string', 'minLength': 1}, 'checker': {'type': 'string', 'const': 'url_format'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'path', 'expected', 'operator'], 'properties': {'path': {'type': 'string', 'minLength': 1}, 'checker': {'type': 'string', 'const': 'json_path'}, 'expected': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}, 'operator': {'enum': ['eq', 'gte', 'lte', 'contains'], 'type': 'string'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'url', 'expected_status'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'checker': {'type': 'string', 'const': 'http_status'}, 'timeout_ms': {'type': 'integer', 'maximum': 5000, 'exclusiveMinimum': 0}, 'expected_status': {'type': 'integer', 'maximum': 599, 'minimum': 100}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'needle'], 'properties': {'field': {'type': 'string', 'minLength': 1}, 'needle': {'type': 'string', 'minLength': 1}, 'checker': {'type': 'string', 'const': 'text_contains'}, 'case_sensitive': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'algorithm', 'expected'], 'properties': {'checker': {'type': 'string', 'const': 'hash_matches'}, 'expected': {'type': 'string', 'pattern': '^[a-fA-F0-9]{64}$'}, 'algorithm': {'type': 'string', 'const': 'sha256'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'due_at'], 'properties': {'due_at': {'type': 'string', 'format': 'date-time', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$'}, 'checker': {'type': 'string', 'const': 'deadline_met'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'claim'], 'properties': {'claim': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'checker': {'type': 'string', 'const': 'claim_cited'}, 'evidence_ref': {'type': 'string', 'pattern': '^evd_.*'}}, 'additionalProperties': False}]}, 'verification_method': {'enum': ['buyer_confirm', 'both_confirm', 'deterministic', 'ai_assisted', 'third_party'], 'type': 'string'}, 'evidence_requirements': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'expected_type', 'source'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'source': {'type': 'object', 'required': ['ref'], 'properties': {'ref': {'type': 'string', 'minLength': 1}, 'description': {'type': 'string'}}, 'additionalProperties': False}, 'on_missing': {'enum': ['uncertain', 'fail'], 'type': 'string'}, 'provenance': {'type': 'object', 'properties': {'min_class': {'enum': ['submitted_by_provider', 'submitted_by_buyer', 'fetched_by_spoolis', 'signed_by_external_system', 'confirmed_by_human', 'unknown_origin'], 'type': 'string'}, 'independent_of': {'enum': ['provider', 'buyer'], 'type': 'string'}}, 'additionalProperties': False}, 'expected_type': {'type': 'string', 'minLength': 1}, 'who_may_supply': {'type': 'array', 'items': {'enum': ['provider', 'buyer', 'spoolis', 'external_system', 'human'], 'type': 'string'}}, 'freshness_seconds': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'maxItems': 50}, 'remove_condition_ids': {'type': 'array', 'items': {'type': 'string', 'pattern': '^cond_[A-Za-z0-9_-]+$'}, 'maxItems': 50}}, 'additionalProperties': False}
cancel_spool
Spool cancellation
Cancel a Spool (the agreement object) that should not continue. Use only when cancellation is an allowed action; this changes lifecycle state and does not verify fulfillment or settle payment. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}}, 'additionalProperties': False}
commit_payment
Payment commitment
Ask the configured settlement adapter to authorize and, where supported, hold the maximum value for a Spool (the agreement object). Use after terms are accepted when the selected payment path requires commitment; this may create a payment authorization or hold, but does not verify work or determine earned value. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}}, 'additionalProperties': False}
compile_spool
Spool draft
Turn purchase intent into a proposed DRAFT Spool (the agreement object) with explicit acceptance criteria and earned-value rules. Use before both parties confirm terms; do not use for one-call unilateral result verification. This creates a persisted draft to inspect, then accept_spool confirms it, amend_spool changes conditions or unitization, and abandon_spool discards it. Works in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['source'], 'properties': {'source': {'type': 'string', 'maxLength': 8192, 'minLength': 1}}, 'additionalProperties': False}
complete_spool
Completed Spool
Read a Spool (the agreement object) whose outcome is already completed. Use for compatibility when a completed result is expected; it has no side effects and does not run verification or settlement. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}}, 'additionalProperties': False}
create_counterparty_invite
Counterparty invite
Create a 15-minute, single-use grant that lets the other party join a Spool (the agreement object). Use when a counterparty needs scoped access without signing in; do not use as payment authority. This creates a credential that expires after use or 15 minutes. Requires the initiator's full-scope key. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}}, 'additionalProperties': False}
create_spool
Spool creation
Create a production Spool (the agreement object) from structured terms and acceptance criteria. Use when both parties will participate in the agreement lifecycle; do not use for one-call unilateral verification. This persists a proposed agreement and may send the counterparty invite reported in the response handoff block. The type field defaults to the person or business service path, while agent selects the agent settlement rail. Conditions may declare verification_method third_party with an external_judge so verification consumes your own evaluator's bound result instead of Spoolis judging those conditions. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['parties', 'value', 'deliverable', 'terms', 'conditions'], 'properties': {'type': {'enum': ['goods_in_person', 'service', 'digital', 'agent_task'], 'type': 'string', 'default': 'service'}, 'terms': {'type': 'array', 'items': {'type': 'object', 'required': ['text', 'provenance'], 'properties': {'text': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'provenance': {'type': 'object', 'required': ['source'], 'properties': {'origin': {'enum': ['extracted', 'inferred', 'spoolis_proposed', 'user_added', 'user_edited', 'mutually_agreed'], 'type': 'string'}, 'source': {'enum': ['listing', 'chat', 'image', 'freeform', 'user_added'], 'type': 'string'}, 'source_ref': {'type': 'string', 'maxLength': 500}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'maxItems': 50, 'minItems': 1}, 'value': {'type': 'object', 'required': ['amount_cents', 'currency'], 'properties': {'currency': {'type': 'string', 'const': 'USD'}, 'amount_cents': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'rail_preference': {'type': 'string', 'maxLength': 100}}, 'additionalProperties': False}, 'parties': {'type': 'array', 'items': {'type': 'object', 'required': ['role', 'kind', 'display_name'], 'properties': {'kind': {'enum': ['human', 'agent', 'org', 'service'], 'type': 'string'}, 'role': {'enum': ['buyer', 'seller', 'client', 'provider'], 'type': 'string'}, 'contact': {'type': 'string', 'maxLength': 300}, 'account_id': {'type': 'string', 'maxLength': 200}, 'display_name': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'stripe_account_id': {'type': 'string', 'pattern': '^acct_.*'}, 'settlement_address': {'type': 'string', 'pattern': '^(?:wallet:eip155:(?:8453|42431):)?0x[a-fA-F0-9]{40}$'}}, 'additionalProperties': False}, 'maxItems': 2, 'minItems': 2}, 'finality': {'type': 'object', 'required': ['window', 'reopen', 'correction', 'on_silence'], 'properties': {'reopen': {'type': 'object', 'required': ['allowed', 'by', 'until'], 'properties': {'by': {'type': 'array', 'items': {'enum': ['buyer', 'provider', 'third_party'], 'type': 'string'}}, 'until': {'enum': ['final', 'never'], 'type': 'string'}, 'allowed': {'type': 'boolean'}}, 'additionalProperties': False}, 'window': {'type': 'object', 'required': ['after', 'duration_iso8601'], 'properties': {'after': {'enum': ['acceptance', 'evidence', 'period_end'], 'type': 'string'}, 'duration_iso8601': {'type': 'string', 'pattern': '^P(?=\\d|T\\d)'}}, 'additionalProperties': False}, 'correction': {'type': 'object', 'required': ['allowed', 'requires_authority'], 'properties': {'allowed': {'type': 'boolean'}, 'requires_authority': {'type': 'boolean'}}, 'additionalProperties': False}, 'on_silence': {'enum': ['keep', 'hold', 'reject'], 'type': 'string'}}, 'additionalProperties': False}, 'agreement': {'type': 'object', 'required': ['mode'], 'properties': {'mode': {'enum': ['bilateral', 'unilateral'], 'type': 'string'}}, 'additionalProperties': False}, 'economics': {'type': 'object', 'properties': {'expiry': {'type': 'string', 'format': 'date-time', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$'}, 'fee_cents': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'unitization': {'type': 'object', 'required': ['total_units', 'unit_amount_cents'], 'properties': {'identity': {'type': 'object', 'required': ['key', 'visibility'], 'properties': {'key': {'type': 'string', 'minLength': 1}, 'visibility': {'enum': ['label', 'pseudonymous'], 'type': 'string'}}, 'additionalProperties': False}, 'total_units': {'type': 'integer', 'maximum': 100000, 'exclusiveMinimum': 0}, 'unit_amount_cents': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'capture_policy': {'type': 'object', 'required': ['auto_capture'], 'properties': {'auto_capture': {'type': 'array', 'items': {'type': 'string', 'const': 'grounded'}}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'conditions': {'type': 'array', 'items': {'type': 'object', 'required': ['description', 'required', 'verification_method'], 'properties': {'required': {'type': 'boolean'}, 'description': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'external_judge': {'type': 'object', 'required': ['evaluator_id', 'kind', 'proof_requirement'], 'properties': {'kind': {'enum': ['external_service', 'zk_verifier', 'marketplace_evaluator', 'buyer_owned', 'ai_evaluator', 'human_arbitration'], 'type': 'string'}, 'on_missing': {'enum': ['uncertain', 'fail'], 'type': 'string'}, 'public_key': {'type': 'string', 'maxLength': 10000, 'minLength': 1}, 'evaluator_id': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'score_mapping': {'type': 'object', 'required': ['schema_id', 'quality_gte', 'consensus_gte'], 'properties': {'schema_id': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'quality_gte': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'consensus_gte': {'type': 'integer', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}, 'evaluator_version': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'proof_requirement': {'enum': ['signed', 'hashed_ref', 'declared'], 'type': 'string'}}, 'additionalProperties': False}, 'deterministic_check': {'oneOf': [{'type': 'object', 'required': ['checker', 'expected'], 'properties': {'checker': {'type': 'string', 'const': 'row_count'}, 'expected': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'required_fields'], 'properties': {'checker': {'type': 'string', 'const': 'completeness'}, 'required_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'minItems': 1}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'key', 'maximum'], 'properties': {'key': {'type': 'string', 'minLength': 1}, 'checker': {'type': 'string', 'const': 'duplicate_rate'}, 'maximum': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'field'], 'properties': {'field': {'type': 'string', 'minLength': 1}, 'checker': {'type': 'string', 'const': 'url_format'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'path', 'expected', 'operator'], 'properties': {'path': {'type': 'string', 'minLength': 1}, 'checker': {'type': 'string', 'const': 'json_path'}, 'expected': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}, 'operator': {'enum': ['eq', 'gte', 'lte', 'contains'], 'type': 'string'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'url', 'expected_status'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'checker': {'type': 'string', 'const': 'http_status'}, 'timeout_ms': {'type': 'integer', 'maximum': 5000, 'exclusiveMinimum': 0}, 'expected_status': {'type': 'integer', 'maximum': 599, 'minimum': 100}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'needle'], 'properties': {'field': {'type': 'string', 'minLength': 1}, 'needle': {'type': 'string', 'minLength': 1}, 'checker': {'type': 'string', 'const': 'text_contains'}, 'case_sensitive': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'algorithm', 'expected'], 'properties': {'checker': {'type': 'string', 'const': 'hash_matches'}, 'expected': {'type': 'string', 'pattern': '^[a-fA-F0-9]{64}$'}, 'algorithm': {'type': 'string', 'const': 'sha256'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'due_at'], 'properties': {'due_at': {'type': 'string', 'format': 'date-time', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$'}, 'checker': {'type': 'string', 'const': 'deadline_met'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'claim'], 'properties': {'claim': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'checker': {'type': 'string', 'const': 'claim_cited'}, 'evidence_ref': {'type': 'string', 'pattern': '^evd_.*'}}, 'additionalProperties': False}]}, 'verification_method': {'enum': ['buyer_confirm', 'both_confirm', 'deterministic', 'ai_assisted', 'third_party'], 'type': 'string'}, 'evidence_requirements': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'expected_type', 'source'], 'properties': {'id': {'type': 'string', 'minLength': 1}, 'source': {'type': 'object', 'required': ['ref'], 'properties': {'ref': {'type': 'string', 'minLength': 1}, 'description': {'type': 'string'}}, 'additionalProperties': False}, 'on_missing': {'enum': ['uncertain', 'fail'], 'type': 'string'}, 'provenance': {'type': 'object', 'properties': {'min_class': {'enum': ['submitted_by_provider', 'submitted_by_buyer', 'fetched_by_spoolis', 'signed_by_external_system', 'confirmed_by_human', 'unknown_origin'], 'type': 'string'}, 'independent_of': {'enum': ['provider', 'buyer'], 'type': 'string'}}, 'additionalProperties': False}, 'expected_type': {'type': 'string', 'minLength': 1}, 'who_may_supply': {'type': 'array', 'items': {'enum': ['provider', 'buyer', 'spoolis', 'external_system', 'human'], 'type': 'string'}}, 'freshness_seconds': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'maxItems': 50}, 'deliverable': {'type': 'object', 'required': ['type', 'title', 'description', 'attributes'], 'properties': {'type': {'type': 'string', 'minLength': 1}, 'title': {'type': 'string', 'minLength': 1}, 'attributes': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'description': {'type': 'string'}}, 'additionalProperties': False}, 'gated_action': {'enum': ['payment', 'workflow_step', 'publish', 'merge', 'delegation', 'other'], 'type': 'string', 'nullable': True}, 'dispute_policy': {'type': 'object', 'required': ['who_may_dispute', 'window_seconds', 'scope', 'on_dispute', 'new_evidence', 'escalation', 'finality'], 'properties': {'scope': {'enum': ['units', 'outcome'], 'type': 'string'}, 'finality': {'enum': ['escalation_is_final', 'unresolved_stays_disputed'], 'type': 'string'}, 'escalation': {'oneOf': [{'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string', 'const': 'reverify'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['kind', 'ref'], 'properties': {'ref': {'type': 'string', 'minLength': 1}, 'kind': {'type': 'string', 'const': 'external_judge'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string', 'const': 'none'}}, 'additionalProperties': False}]}, 'on_dispute': {'enum': ['freeze_disputed_value', 'freeze_all'], 'type': 'string'}, 'new_evidence': {'enum': ['allowed', 'not_allowed'], 'type': 'string'}, 'window_seconds': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'who_may_dispute': {'type': 'array', 'items': {'enum': ['buyer', 'provider'], 'type': 'string'}, 'minItems': 1}}, 'additionalProperties': False}, 'gated_action_note': {'type': 'string', 'nullable': True, 'maxLength': 120}}, 'additionalProperties': False}
decide_review
Review decision
Decide a pending review for a Spool (the agreement object). Use after inspecting its evidence; this records confirmation or creates a dispute and does not settle payment. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['review_id', 'verdict', 'reason'], 'properties': {'reason': {'type': 'string', 'maxLength': 1000, 'minLength': 1}, 'verdict': {'enum': ['confirm', 'dispute'], 'type': 'string'}, 'review_id': {'type': 'string', 'pattern': '^rvq_[23456789A-HJ-NP-Za-km-z]{21}$'}, 'counter_evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'enum': ['text', 'url'], 'type': 'string'}, 'value': {'type': 'string', 'maxLength': 10000, 'minLength': 1}}, 'additionalProperties': False}, 'default': [], 'maxItems': 10, 'nullable': True}}, 'additionalProperties': False}
decline_spool
Spool decline
Decline a proposed Spool (the agreement object). Use when the counterparty rejects its terms; this ends the proposal without accepting it, verifying work, or settling payment. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}}, 'additionalProperties': False}
get_dispute
Dispute details
Read a dispute for a Spool (the agreement object). Use to inspect claimed, accepted, disputed, final, and payable figures plus resolution state; it has no side effects. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['dispute_id'], 'properties': {'dispute_id': {'type': 'string', 'pattern': '^dsp_[23456789A-HJ-NP-Za-km-z]{21}$'}}, 'additionalProperties': False}
get_receipt_status
Outcome Receipt status
Check whether an Outcome Receipt is still current or has been superseded, before acting on it. Returns state (current, superseded, unknown) and status (active, corrected, revoked). Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['receipt_id'], 'properties': {'receipt_id': {'type': 'string', 'pattern': '^ocr_[a-f0-9]{24}$'}}, 'additionalProperties': False}
get_review
Review details
Read the review request for a Spool (the agreement object). Use to poll its state; it has no side effects. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['review_id'], 'properties': {'review_id': {'type': 'string', 'pattern': '^rvq_[23456789A-HJ-NP-Za-km-z]{21}$'}}, 'additionalProperties': False}
get_spool
Spool details
Read a Spool (the agreement object), including hash-covered evidence requirements, dispute policy, and salted unit identity configuration. Use for status checks; it has no side effects. A party named in who_may_dispute can supersede an issued receipt through POST /api/v1/receipts/{receipt_id}/supersede. There is no review queue or UI. Works in the no-key sandbox.
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}}, 'additionalProperties': False}
get_spool_events
Spool event history
Read the canonical audit history for a Spool (the agreement object), including agreement, fulfillment, verification, and settlement events. Use to reconstruct what happened; it has no side effects. Works in the no-key sandbox.
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}}, 'additionalProperties': False}
list_discrepancies
Discrepancy list
Read discrepancies for a Spool (the agreement object). Use for inspecting differences; it has no side effects. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}}, 'additionalProperties': False}
list_facts
Fact list
Read typed facts for a Spool (the agreement object). Use to inspect observed evidence; it has no side effects. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}}, 'additionalProperties': False}
list_matches
Match list
Read matches for a Spool (the agreement object). Use to inspect outcomes and explanations; it has no side effects. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}}, 'additionalProperties': False}
list_sources
Source list
Read source connections for a Spool (the agreement object). Use for source health inspection; it has no side effects. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Read only
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}, 'additionalProperties': False}
open_discrepancy
Discrepancy opening
Open a discrepancy for a Spool (the agreement object). Use when expected and observed figures do not reconcile; this records the difference and does not assume either source is wrong. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'kind', 'expected', 'observed', 'explanation'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}, 'kind': {'enum': ['amount', 'count', 'timing', 'attribution', 'definition', 'evidence', 'duplicate', 'other'], 'type': 'string'}, 'unit': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'links': {'type': 'object', 'default': {'match_ids': []}, 'properties': {'match_ids': {'type': 'array', 'items': {'type': 'string'}, 'default': []}, 'dispute_id': {'type': 'string', 'pattern': '^dsp_.*'}, 'review_request_id': {'type': 'string', 'pattern': '^rvq_.*'}}, 'additionalProperties': False}, 'expected': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'observed': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'receipt_id': {'type': 'string', 'pattern': '^ocr_[a-f0-9]{24}$'}, 'explanation': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'sandbox_session_id': {'type': 'string'}}, 'additionalProperties': False}
open_dispute
Dispute opening
Open a dispute for a Spool (the agreement object). Use inside its declared window; this records counter-evidence and marks policy-defined value as not currently final or payable. It does not restrict money. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['receipt_id', 'scope', 'reason'], 'properties': {'scope': {'type': 'object', 'oneOf': [{'type': 'object', 'required': ['kind', 'units'], 'properties': {'kind': {'type': 'string', 'const': 'units'}, 'units': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 1000, 'minItems': 1}}, 'additionalProperties': False}, {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string', 'const': 'outcome'}}, 'additionalProperties': False}]}, 'reason': {'type': 'string', 'maxLength': 1000, 'minLength': 1}, 'receipt_id': {'type': 'string', 'pattern': '^ocr_[a-f0-9]{24}$'}, 'counter_evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'value'], 'properties': {'type': {'enum': ['text', 'url'], 'type': 'string'}, 'value': {'type': 'string', 'maxLength': 10000, 'minLength': 1}}, 'additionalProperties': False}, 'default': [], 'maxItems': 10, 'nullable': True}}, 'additionalProperties': False}
propose_spool
Spool proposal
Move a draft Spool (the agreement object) into the proposed state so the counterparty can review it. Use after the acceptance criteria are ready; this changes agreement state and does not accept terms or settle payment. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}}, 'additionalProperties': False}
request_review
Review request
Route receipt units from a Spool (the agreement object) or its whole outcome to a named reviewer. Use when a human decision is required; this creates a review request and hosted link but does not decide it. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['receipt_id', 'scope', 'reviewer', 'deadline_at', 'on_timeout'], 'properties': {'scope': {'type': 'object', 'oneOf': [{'type': 'object', 'required': ['kind', 'units'], 'properties': {'kind': {'type': 'string', 'const': 'units'}, 'units': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 1000, 'minItems': 1}}, 'additionalProperties': False}, {'type': 'object', 'required': ['kind'], 'properties': {'kind': {'type': 'string', 'const': 'outcome'}}, 'additionalProperties': False}]}, 'reviewer': {'type': 'object', 'required': ['subject', 'role'], 'properties': {'role': {'enum': ['buyer', 'provider', 'third_party'], 'type': 'string'}, 'email': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", 'nullable': True, 'maxLength': 254}, 'subject': {'type': 'string', 'pattern': '^[a-z0-9_-]+:[^\\s]+$', 'maxLength': 200, 'minLength': 3}, 'display_name': {'type': 'string', 'nullable': True, 'maxLength': 100, 'minLength': 1}}, 'additionalProperties': False}, 'on_timeout': {'enum': ['hold', 'reject', 'keep_accepted'], 'type': 'string'}, 'receipt_id': {'type': 'string', 'pattern': '^ocr_[a-f0-9]{24}$'}, 'deadline_at': {'type': 'string', 'format': 'date-time', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$'}}, 'additionalProperties': False}
resolve_discrepancy
Discrepancy resolution
Resolve a discrepancy for a Spool (the agreement object). Use after authority determines the outcome; this records the resolution and does not initiate settlement. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['discrepancy_id', 'outcome', 'resolved_by'], 'properties': {'outcome': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'resolved_by': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'discrepancy_id': {'type': 'string', 'pattern': '^dsc_[23456789A-HJ-NP-Za-km-z]{21}$'}, 'superseding_receipt_id': {'type': 'string', 'pattern': '^ocr_[a-f0-9]{24}$'}}, 'additionalProperties': False}
run_matching
Matching run
Run matching for a Spool (the agreement object). Use after claims and facts exist; this records explainable results and discrepancies. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}}, 'additionalProperties': False}
run_sandbox_scenario
Sandbox scenario
Evaluate Spoolis without a key or account: run a seeded synthetic scenario through a real demo Spool (the agreement object), verification, and a signed demo Outcome Receipt. Use to observe which units may continue after verification and inspect seeded truth only after the Outcome exists. Scenarios: data_enrichment, external_judge_two_consumers, qualified_meetings, production_migration, review_and_dispute, and sources_and_matching. This persists only run parameters and aggregate results; modeled economics are labeled modeled. commercial_state opens and resolves a blocking discrepancy, proving the Outcome moves from uncertain back to accepted. Works in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['scenario'], 'properties': {'seed': {'type': 'string', 'maxLength': 128, 'minLength': 1}, 'scenario': {'enum': ['commercial_state', 'data_enrichment', 'external_judge_two_consumers', 'production_migration', 'qualified_meetings', 'review_and_dispute', 'sources_and_matching'], 'type': 'string'}, 'defect_rate': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'record_count': {'type': 'integer', 'maximum': 1000, 'minimum': 1}, 'modeled_cost_per_unit': {'type': 'number', 'maximum': 1000000, 'minimum': 0}, 'adversarial_case_count': {'type': 'integer', 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}
submit_evidence
Evidence submission
Attach fulfillment evidence to an acceptance criterion in a Spool (the agreement object). Use after work is delivered and before verification; this persists evidence but does not decide whether it passes or what was earned. Works in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id', 'condition_id', 'type', 'source'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}, 'type': {'enum': ['photo', 'text', 'file', 'url', 'dataset', 'confirmation'], 'type': 'string'}, 'source': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'metadata': {'type': 'object', 'default': {}, 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'provenance': {'enum': ['api_response', 'uploaded_json', 'url_fetch', 'external_tool_result'], 'type': 'string'}, 'claim_class': {'enum': ['actor_identity', 'artifact_state', 'machine_fact'], 'type': 'string'}, 'condition_id': {'type': 'string', 'pattern': '^cond_.*'}, 'on_behalf_of': {'type': 'string', 'pattern': '^pty_.*'}}, 'additionalProperties': False}
sync_source
Source sync
Sync a source for a Spool (the agreement object). Use after configuration; this creates an idempotent checkpointed job. Production only: set SPOOLIS_API_KEY; not available in the no-key sandbox.
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^src_.*'}}, 'additionalProperties': False}
verify_result
Result verification
Get a signed, durable, portable Outcome Receipt: a verdict artifact, per unit for unitized work, another system can fetch and independently verify. Spoolis makes it by verifying returned work against explicit acceptance criteria. Use when an agent, vendor, or tool reports work as done and the next action depends on whether the delivery actually met the agreed criteria. This runs in one call using exactly one of inline conditions or a locally registered recipe slug and hash, creating an inspectable unilateral Spool, the versioned acceptance policy. The maximum amount field is optional for verification-only runs. Omit it when nobody is paying; the earned amount is then zero and the receipt omits committed value. The maximum amount field is required when unit is present because unit math needs the cap. Recipe verification uses the hosted conditions exactly as written and fails closed when the hash differs. The external provider does not accept conditions in Spoolis. For a batch delivery where items can pass, fail, or remain uncertain individually, pass unit (its unit count matching the item count) AND evidence type dataset with exactly one row per delivered item, keeping a field present with a null value when it is missing; that returns distinct per-unit verdicts and earned value only for passing units. Text evidence with unit is batch-only and settles all-or-nothing. For a keyless production alternative, use POST /api/v1/verify/x402. Sandbox dataset evidence is limited to 100 records. Works in the no-key sandbox.
Open world
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['evidence'], 'properties': {'unit': {'type': 'object', 'nullable': True, 'required': ['total_units', 'unit_amount_cents'], 'properties': {'identity': {'type': 'object', 'required': ['key', 'visibility'], 'properties': {'key': {'type': 'string', 'minLength': 1}, 'visibility': {'enum': ['label', 'pseudonymous'], 'type': 'string'}}, 'additionalProperties': False}, 'total_units': {'type': 'integer', 'maximum': 100000, 'exclusiveMinimum': 0}, 'unit_amount_cents': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}}, 'additionalProperties': False}, 'recipe': {'type': 'object', 'nullable': True, 'required': ['slug', 'hash'], 'properties': {'hash': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'slug': {'type': 'string', 'maxLength': 200, 'minLength': 1}}, 'additionalProperties': False}, 'evidence': {'type': 'object', 'required': ['type', 'provenance'], 'properties': {'rows': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'maxItems': 100000}, 'type': {'enum': ['dataset', 'text', 'url'], 'type': 'string'}, 'payload': {}, 'provenance': {'enum': ['api_response', 'uploaded_json', 'url_fetch'], 'type': 'string'}}, 'additionalProperties': False}, 'conditions': {'type': ['string', 'array'], 'anyOf': [{'type': 'string', 'maxLength': 2000, 'minLength': 1}, {'type': 'array', 'items': {'type': 'object', 'required': ['description', 'deterministic_check'], 'properties': {'description': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'deterministic_check': {'oneOf': [{'type': 'object', 'required': ['checker', 'expected'], 'properties': {'checker': {'type': 'string', 'const': 'row_count'}, 'expected': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'required_fields'], 'properties': {'checker': {'type': 'string', 'const': 'completeness'}, 'required_fields': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'minItems': 1}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'key', 'maximum'], 'properties': {'key': {'type': 'string', 'minLength': 1}, 'checker': {'type': 'string', 'const': 'duplicate_rate'}, 'maximum': {'type': 'number', 'maximum': 1, 'minimum': 0}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'field'], 'properties': {'field': {'type': 'string', 'minLength': 1}, 'checker': {'type': 'string', 'const': 'url_format'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'path', 'expected', 'operator'], 'properties': {'path': {'type': 'string', 'minLength': 1}, 'checker': {'type': 'string', 'const': 'json_path'}, 'expected': {'anyOf': [{'type': 'string'}, {'type': 'number'}, {'type': 'boolean'}]}, 'operator': {'enum': ['eq', 'gte', 'lte', 'contains'], 'type': 'string'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'url', 'expected_status'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'checker': {'type': 'string', 'const': 'http_status'}, 'timeout_ms': {'type': 'integer', 'maximum': 5000, 'exclusiveMinimum': 0}, 'expected_status': {'type': 'integer', 'maximum': 599, 'minimum': 100}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'needle'], 'properties': {'field': {'type': 'string', 'minLength': 1}, 'needle': {'type': 'string', 'minLength': 1}, 'checker': {'type': 'string', 'const': 'text_contains'}, 'case_sensitive': {'type': 'boolean'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'algorithm', 'expected'], 'properties': {'checker': {'type': 'string', 'const': 'hash_matches'}, 'expected': {'type': 'string', 'pattern': '^[a-fA-F0-9]{64}$'}, 'algorithm': {'type': 'string', 'const': 'sha256'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'due_at'], 'properties': {'due_at': {'type': 'string', 'format': 'date-time', 'pattern': '^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$'}, 'checker': {'type': 'string', 'const': 'deadline_met'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['checker', 'claim'], 'properties': {'claim': {'type': 'string', 'maxLength': 2000, 'minLength': 1}, 'checker': {'type': 'string', 'const': 'claim_cited'}, 'evidence_ref': {'type': 'string', 'pattern': '^evd_.*'}}, 'additionalProperties': False}]}}, 'additionalProperties': False}, 'maxItems': 50, 'minItems': 1}], 'nullable': True}, 'settlement': {'enum': ['external', 'managed'], 'type': 'string', 'default': 'external', 'nullable': True}, 'gated_action': {'enum': ['payment', 'workflow_step', 'publish', 'merge', 'delegation', 'other'], 'type': 'string', 'nullable': True}, 'idempotency_key': {'type': 'string', 'nullable': True, 'maxLength': 128, 'minLength': 1}, 'max_amount_cents': {'type': 'integer', 'maximum': 9007199254740991, 'nullable': True, 'exclusiveMinimum': 0}, 'gated_action_note': {'type': 'string', 'nullable': True, 'maxLength': 120}}, 'additionalProperties': False}
verify_spool
Spool verification
Issue a signed, durable, portable Outcome Receipt from this Spool, the versioned acceptance policy. The receipt is a verdict artifact, per unit for unitized work, another system can fetch and independently verify. Spoolis makes it by evaluating submitted evidence against the acceptance criteria and determining what was earned. Use after evidence is attached; this records the verdict and required evidence as present, missing, stale, unavailable, or provenance unsatisfied. Missing required evidence defaults to uncertain. Conditions with verification_method third_party keep your own judge: verification consumes the declared external evaluator's result, bound to this agreement and evidence per its declared proof requirement, instead of Spoolis judging those conditions itself. Unitized receipts may include salted public unit identities. Sandbox dataset evidence is limited to 100 records. Canonical recipe: compile -> verify -> Outcome Receipt -> verifyReceipt -> optional status check -> consumer acts on earned. Works in the no-key sandbox.
Open world
Input schema 
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^spl_.*'}, 'confirmations': {'type': 'array', 'items': {'type': 'object', 'required': ['condition_id', 'method', 'outcome', 'evidence_refs'], 'properties': {'detail': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'method': {'enum': ['buyer_confirm', 'both_confirm'], 'type': 'string'}, 'outcome': {'enum': ['passed', 'failed', 'waived'], 'type': 'string'}, 'condition_id': {'type': 'string', 'pattern': '^cond_.*'}, 'evidence_refs': {'type': 'array', 'items': {'type': 'string', 'pattern': '^evd_.*'}}}, 'additionalProperties': False}, 'default': []}}, 'additionalProperties': False}
History

Recent tool changes

Added
list_matches
Sept. 19, 2026, 2:52 a.m.
Added
run_matching
Sept. 19, 2026, 2:52 a.m.
Added
list_facts
Sept. 19, 2026, 2:52 a.m.
Added
sync_source
Sept. 19, 2026, 2:52 a.m.
Added
add_source
Sept. 19, 2026, 2:52 a.m.
Added
list_sources
Sept. 19, 2026, 2:52 a.m.
Added
resolve_discrepancy
Sept. 19, 2026, 2:52 a.m.
Added
open_discrepancy
Sept. 19, 2026, 2:52 a.m.
Added
list_discrepancies
Sept. 19, 2026, 2:52 a.m.
Added
get_dispute
Sept. 19, 2026, 2:52 a.m.
Added
open_dispute
Sept. 19, 2026, 2:52 a.m.
Added
decide_review
Sept. 19, 2026, 2:52 a.m.
Added
get_review
Sept. 19, 2026, 2:52 a.m.
Added
request_review
Sept. 19, 2026, 2:52 a.m.
Changed
create_spool
Sept. 19, 2026, 2:52 a.m.
Changed
run_sandbox_scenario
Sept. 19, 2026, 2:52 a.m.
Added
get_spool_events
Sept. 17, 2026, 12:37 p.m.
Added
complete_spool
Sept. 17, 2026, 12:37 p.m.
Added
verify_spool
Sept. 17, 2026, 12:37 p.m.
Added
submit_evidence
Sept. 17, 2026, 12:37 p.m.
Added
commit_payment
Sept. 17, 2026, 12:37 p.m.
Added
cancel_spool
Sept. 17, 2026, 12:37 p.m.
Added
decline_spool
Sept. 17, 2026, 12:37 p.m.
Added
abandon_spool
Sept. 17, 2026, 12:37 p.m.
Added
amend_spool
Sept. 17, 2026, 12:37 p.m.
Added
accept_spool
Sept. 17, 2026, 12:37 p.m.
Added
propose_spool
Sept. 17, 2026, 12:37 p.m.
Added
create_counterparty_invite
Sept. 17, 2026, 12:37 p.m.
Added
get_receipt_status
Sept. 17, 2026, 12:37 p.m.
Added
get_spool
Sept. 17, 2026, 12:37 p.m.
Discover

Similar MCP servers

Lovie Company Formation

co.lovie/company-formation

Supports company formation and business administration with bank accounts, cards, invoicing, bookkeeping, accounting periods, and…

AgentLot Marketplace

io.agentlot/marketplace

Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.

BeeL

es.beel/mcp

Provides Spanish company administration and VeriFactu-compliant invoicing, including customers, products, invoice issuance, corre…

corply

io.github.corply-dev/corply

Supports company formation and corporate administration including incorporation documents, signatures, cap tables, corporate acti…

Focxle: AI governance for B2B deals between agents

com.focxle/afos

Provides agent spending controls, delegated budgets, signed authority checks, negotiations, escrow contracts, workforce hiring, a…

Conta Azul MCP

io.github.douglac/contaazul-mcp

Connects to Conta Azul ERP for managing customers, sales, budgets, contracts, financial accounts, receivables, invoices, settleme…

Molt2Meet

io.github.molt2meet-org/molt2meet

Dispatches physical-world tasks to human operators, manages scheduling and proof of completion, and supports direct settlement or…

mcp-server

me.ceki/mcp-server

Supports hiring and coordinating human specialists through contracts, schedules, bookings, escrow holds, billable events, approva…