MCP Server
API Acre
com.apiacre/api-acre
What this MCP does
Offers paid APIs for EVM blockchain inspection, data transformation and validation, geocoding, weather, currency conversion, and structured retailer price extraction.
Capabilities
Tools
73
tools
commerce.product-price
Paste one public retailer product URL to get its current publisher-supplied structured price, currency, availability, seller, shipping terms, aggregate rating, variant attributes, identifiers, observation time, and evidence hashes from Schema.org JSON-LD, Schema.org microdata, or paired product meta tags; optionally compare the selected offer with a buyer-supplied maximum. Fetching proceeds only when robots.txt permits it, without JavaScript, login, cookies, or anti-bot bypass.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'ProductPriceInput', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'format': 'uri', 'maxLength': 2083, 'minLength': 1}, 'maximum_price': {'anyOf': [{'type': 'number', 'maximum': 1000000000000.0, 'minimum': 0.0}, {'type': 'string', 'pattern': '^(?!^[-+.]*$)[+-]?0*(?:\\d{0,13}|(?=[\\d.]{1,20}0*$)\\d{0,13}\\.\\d{0,6}0*$)'}, {'type': 'null'}], 'title': 'Maximum Price', 'default': None, 'examples': ['49.99'], 'description': 'Optional maximum price in expected_currency; comparison is null when the publisher reports another currency'}, 'expected_currency': {'anyOf': [{'type': 'string', 'pattern': '^[A-Za-z]{3}$'}, {'type': 'null'}], 'title': 'Expected Currency', 'default': None, 'examples': ['GBP'], 'description': 'Optional ISO 4217 currency expected by the buyer'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['requestedUrl', 'url', 'observedAt', 'productCount', 'offerCount', 'products', 'headlineOffer', 'decision', 'evidence', 'warnings', 'limitations'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'decision': {'type': 'object', 'required': ['expectedCurrency', 'currencyMatches', 'maximumPrice', 'atOrBelowMaximum'], 'properties': {'maximumPrice': {'type': ['string', 'null'], 'pattern': '^[0-9]{1,16}(?:\\.[0-9]{1,6})?$'}, 'currencyMatches': {'type': ['boolean', 'null']}, 'atOrBelowMaximum': {'type': ['boolean', 'null']}, 'expectedCurrency': {'type': ['string', 'null'], 'pattern': '^[A-Z]{3}$'}}, 'additionalProperties': False}, 'evidence': {'type': 'object', 'required': ['method', 'publisherAsserted', 'independentlyVerified', 'bodySha256', 'jsonLdSha256', 'vocabulary', 'scriptsSeen', 'nodesSeen', 'response', 'access'], 'properties': {'access': {'type': 'object', 'required': ['robots', 'robotsUserAgent', 'sameOriginRedirectsOnly', 'authenticated', 'javascriptExecuted', 'antiBotBypassAttempted', 'networkRequestClasses', 'minimumNetworkRequestsMade', 'redirectsMayAddRequests'], 'properties': {'robots': {'type': 'object', 'required': ['respected', 'status', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'status': {'type': 'string', 'pattern': '^(?:loaded|http_[0-9]{3})$'}, 'respected': {'type': 'boolean', 'const': True}}, 'additionalProperties': False}, 'authenticated': {'type': 'boolean', 'const': False}, 'robotsUserAgent': {'type': 'string', 'const': 'APIAcre'}, 'javascriptExecuted': {'type': 'boolean', 'const': False}, 'networkRequestClasses': {'type': 'array', 'items': {'enum': ['robots.txt policy', 'product page'], 'type': 'string'}, 'maxItems': 2, 'minItems': 2}, 'antiBotBypassAttempted': {'type': 'boolean', 'const': False}, 'redirectsMayAddRequests': {'type': 'boolean', 'const': True}, 'sameOriginRedirectsOnly': {'type': 'boolean', 'const': True}, 'minimumNetworkRequestsMade': {'type': 'integer', 'const': 2}}, 'additionalProperties': False}, 'method': {'enum': ['publisher-supplied Schema.org Product JSON-LD in initial HTML', 'publisher-supplied Schema.org Product microdata in initial HTML', 'publisher-supplied paired product price meta tags in initial HTML'], 'type': 'string'}, 'response': {'type': 'object', 'required': ['statusCode', 'contentType', 'bytes', 'elapsedMs'], 'properties': {'bytes': {'type': 'integer', 'minimum': 0}, 'elapsedMs': {'type': 'integer', 'minimum': 0}, 'statusCode': {'type': 'integer', 'maximum': 299, 'minimum': 200}, 'contentType': {'type': ['string', 'null'], 'maxLength': 1000}}, 'additionalProperties': False}, 'nodesSeen': {'type': 'integer', 'minimum': 0}, 'bodySha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'vocabulary': {'anyOf': [{'type': 'object', 'required': ['name', 'url', 'license', 'licenseUrl'], 'properties': {'url': {'type': 'string', 'const': 'https://schema.org/'}, 'name': {'type': 'string', 'const': 'Schema.org'}, 'license': {'type': 'string', 'const': 'CC BY-SA 3.0'}, 'licenseUrl': {'type': 'string', 'const': 'https://creativecommons.org/licenses/by-sa/3.0/'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'scriptsSeen': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'jsonLdSha256': {'type': ['string', 'null'], 'pattern': '^[0-9a-f]{64}$'}, 'publisherAsserted': {'type': 'boolean', 'const': True}, 'independentlyVerified': {'type': 'boolean', 'const': False}}, 'additionalProperties': False}, 'products': {'type': 'array', 'items': {'type': 'object', 'required': ['index', 'id', 'name', 'description', 'url', 'image', 'brand', 'category', 'model', 'attributes', 'aggregateRating', 'identifiers', 'offers', 'evidence'], 'properties': {'id': {'type': ['string', 'null'], 'maxLength': 10000}, 'url': {'type': ['string', 'null'], 'maxLength': 10000}, 'name': {'type': ['string', 'null'], 'maxLength': 10000}, 'brand': {'anyOf': [{'type': 'string', 'maxLength': 10000, 'minLength': 1}, {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 10000, 'minLength': 1}, 'url': {'type': 'string', 'maxLength': 10000, 'minLength': 1}, 'name': {'type': 'string', 'maxLength': 10000, 'minLength': 1}}, 'minProperties': 1, 'additionalProperties': False}, {'type': 'null'}]}, 'image': {'anyOf': [{'type': 'string', 'maxLength': 10000, 'minLength': 1}, {'type': 'array', 'items': {'type': 'string', 'maxLength': 10000, 'minLength': 1}, 'minItems': 1}, {'type': 'null'}]}, 'index': {'type': 'integer', 'maximum': 9, 'minimum': 0}, 'model': {'anyOf': [{'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 20, 'minItems': 1}]}, {'type': 'null'}]}, 'offers': {'type': 'array', 'items': {'type': 'object', 'required': ['productIndex', 'offerIndex', 'amount', 'currency', 'priceKind', 'highPrice', 'offerCount', 'availability', 'availabilityUrl', 'priceValidUntil', 'expired', 'itemCondition', 'url', 'seller', 'shippingDetails'], 'properties': {'url': {'type': ['string', 'null'], 'maxLength': 10000}, 'amount': {'type': 'string', 'pattern': '^[0-9]{1,16}(?:\\.[0-9]{1,6})?$'}, 'seller': {'anyOf': [{'type': 'string', 'maxLength': 10000, 'minLength': 1}, {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 10000, 'minLength': 1}, 'url': {'type': 'string', 'maxLength': 10000, 'minLength': 1}, 'name': {'type': 'string', 'maxLength': 10000, 'minLength': 1}}, 'minProperties': 1, 'additionalProperties': False}, {'type': 'null'}]}, 'expired': {'type': ['boolean', 'null']}, 'currency': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'highPrice': {'type': ['string', 'null'], 'pattern': '^[0-9]{1,16}(?:\\.[0-9]{1,6})?$'}, 'priceKind': {'enum': ['direct', 'aggregate_low'], 'type': 'string'}, 'offerCount': {'type': ['integer', 'null'], 'maximum': 1000000000, 'minimum': 0}, 'offerIndex': {'type': 'integer', 'minimum': 0}, 'availability': {'type': ['string', 'null'], 'maxLength': 2000}, 'productIndex': {'type': 'integer', 'maximum': 9, 'minimum': 0}, 'itemCondition': {'type': ['string', 'null'], 'maxLength': 10000}, 'availabilityUrl': {'type': ['string', 'null'], 'maxLength': 2000}, 'priceValidUntil': {'type': ['string', 'null'], 'maxLength': 10000}, 'shippingDetails': {'type': 'array', 'items': {'type': 'object', 'properties': {'deliveryTime': {'type': 'object', 'properties': {'transitTime': {'type': 'object', 'properties': {'value': {'type': ['string', 'number'], 'maxLength': 50}, 'maxValue': {'type': ['string', 'number'], 'maxLength': 50}, 'minValue': {'type': ['string', 'number'], 'maxLength': 50}, 'unitCode': {'type': ['string', 'number'], 'maxLength': 50}, 'unitText': {'type': ['string', 'number'], 'maxLength': 50}}, 'minProperties': 1, 'additionalProperties': False}, 'handlingTime': {'type': 'object', 'properties': {'value': {'type': ['string', 'number'], 'maxLength': 50}, 'maxValue': {'type': ['string', 'number'], 'maxLength': 50}, 'minValue': {'type': ['string', 'number'], 'maxLength': 50}, 'unitCode': {'type': ['string', 'number'], 'maxLength': 50}, 'unitText': {'type': ['string', 'number'], 'maxLength': 50}}, 'minProperties': 1, 'additionalProperties': False}}, 'minProperties': 1, 'additionalProperties': False}, 'shippingRate': {'type': 'object', 'properties': {'value': {'type': ['string', 'number'], 'maxLength': 50}, 'currency': {'type': ['string', 'number'], 'maxLength': 50}, 'maxValue': {'type': ['string', 'number'], 'maxLength': 50}, 'minValue': {'type': ['string', 'number'], 'maxLength': 50}}, 'minProperties': 1, 'additionalProperties': False}, 'shippingLabel': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'shippingDestination': {'type': 'object', 'properties': {'addressRegion': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 20, 'minItems': 1}]}, 'addressCountry': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 20, 'minItems': 1}]}}, 'minProperties': 1, 'additionalProperties': False}}, 'minProperties': 1, 'additionalProperties': False}, 'maxItems': 10}}, 'additionalProperties': False}, 'maxItems': 25, 'minItems': 1}, 'category': {'anyOf': [{'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 20, 'minItems': 1}]}, {'type': 'null'}]}, 'evidence': {'type': 'array', 'items': {'oneOf': [{'type': 'object', 'required': ['field', 'blockIndex', 'jsonPointer', 'valueSha256'], 'properties': {'field': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'blockIndex': {'type': 'integer', 'maximum': 99, 'minimum': 0}, 'jsonPointer': {'type': 'string', 'pattern': '^/', 'maxLength': 10000}, 'valueSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['field', 'source', 'valueSha256'], 'properties': {'field': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'source': {'enum': ['schema.org-microdata', 'product-meta'], 'type': 'string'}, 'valueSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}}, 'additionalProperties': False}]}, 'maxItems': 24}, 'attributes': {'type': 'object', 'properties': {'size': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 20, 'minItems': 1}]}, 'color': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 20, 'minItems': 1}]}, 'pattern': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 20, 'minItems': 1}]}, 'material': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 20, 'minItems': 1}]}}, 'additionalProperties': False}, 'description': {'type': ['string', 'null'], 'maxLength': 2000}, 'identifiers': {'type': 'object', 'properties': {'mpn': {'type': ['string', 'number', 'boolean'], 'maxLength': 10000}, 'sku': {'type': ['string', 'number', 'boolean'], 'maxLength': 10000}, 'gtin': {'type': ['string', 'number', 'boolean'], 'maxLength': 10000}, 'gtin8': {'type': ['string', 'number', 'boolean'], 'maxLength': 10000}, 'gtin12': {'type': ['string', 'number', 'boolean'], 'maxLength': 10000}, 'gtin13': {'type': ['string', 'number', 'boolean'], 'maxLength': 10000}, 'gtin14': {'type': ['string', 'number', 'boolean'], 'maxLength': 10000}}, 'additionalProperties': False}, 'aggregateRating': {'anyOf': [{'type': 'object', 'properties': {'bestRating': {'type': ['string', 'number'], 'maxLength': 50}, 'ratingCount': {'type': ['string', 'number'], 'maxLength': 50}, 'ratingValue': {'type': ['string', 'number'], 'maxLength': 50}, 'reviewCount': {'type': ['string', 'number'], 'maxLength': 50}, 'worstRating': {'type': ['string', 'number'], 'maxLength': 50}}, 'minProperties': 1, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}, 'maxItems': 10, 'minItems': 1}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 300}, 'maxItems': 100}, 'observedAt': {'type': 'string', 'format': 'date-time'}, 'offerCount': {'type': 'integer', 'maximum': 25, 'minimum': 1}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 300}, 'maxItems': 5, 'minItems': 5}, 'productCount': {'type': 'integer', 'maximum': 10, 'minimum': 1}, 'requestedUrl': {'type': 'string', 'format': 'uri'}, 'headlineOffer': {'type': 'object', 'required': ['productIndex', 'offerIndex', 'amount', 'currency', 'priceKind', 'highPrice', 'offerCount', 'availability', 'availabilityUrl', 'priceValidUntil', 'expired', 'itemCondition', 'url', 'seller', 'shippingDetails', 'selection'], 'properties': {'url': {'type': ['string', 'null'], 'maxLength': 10000}, 'amount': {'type': 'string', 'pattern': '^[0-9]{1,16}(?:\\.[0-9]{1,6})?$'}, 'seller': {'anyOf': [{'type': 'string', 'maxLength': 10000, 'minLength': 1}, {'type': 'object', 'properties': {'id': {'type': 'string', 'maxLength': 10000, 'minLength': 1}, 'url': {'type': 'string', 'maxLength': 10000, 'minLength': 1}, 'name': {'type': 'string', 'maxLength': 10000, 'minLength': 1}}, 'minProperties': 1, 'additionalProperties': False}, {'type': 'null'}]}, 'expired': {'type': ['boolean', 'null']}, 'currency': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'highPrice': {'type': ['string', 'null'], 'pattern': '^[0-9]{1,16}(?:\\.[0-9]{1,6})?$'}, 'priceKind': {'enum': ['direct', 'aggregate_low'], 'type': 'string'}, 'selection': {'type': 'string', 'maxLength': 300, 'minLength': 1}, 'offerCount': {'type': ['integer', 'null'], 'maximum': 1000000000, 'minimum': 0}, 'offerIndex': {'type': 'integer', 'minimum': 0}, 'availability': {'type': ['string', 'null'], 'maxLength': 2000}, 'productIndex': {'type': 'integer', 'maximum': 9, 'minimum': 0}, 'itemCondition': {'type': ['string', 'null'], 'maxLength': 10000}, 'availabilityUrl': {'type': ['string', 'null'], 'maxLength': 2000}, 'priceValidUntil': {'type': ['string', 'null'], 'maxLength': 10000}, 'shippingDetails': {'type': 'array', 'items': {'type': 'object', 'properties': {'deliveryTime': {'type': 'object', 'properties': {'transitTime': {'type': 'object', 'properties': {'value': {'type': ['string', 'number'], 'maxLength': 50}, 'maxValue': {'type': ['string', 'number'], 'maxLength': 50}, 'minValue': {'type': ['string', 'number'], 'maxLength': 50}, 'unitCode': {'type': ['string', 'number'], 'maxLength': 50}, 'unitText': {'type': ['string', 'number'], 'maxLength': 50}}, 'minProperties': 1, 'additionalProperties': False}, 'handlingTime': {'type': 'object', 'properties': {'value': {'type': ['string', 'number'], 'maxLength': 50}, 'maxValue': {'type': ['string', 'number'], 'maxLength': 50}, 'minValue': {'type': ['string', 'number'], 'maxLength': 50}, 'unitCode': {'type': ['string', 'number'], 'maxLength': 50}, 'unitText': {'type': ['string', 'number'], 'maxLength': 50}}, 'minProperties': 1, 'additionalProperties': False}}, 'minProperties': 1, 'additionalProperties': False}, 'shippingRate': {'type': 'object', 'properties': {'value': {'type': ['string', 'number'], 'maxLength': 50}, 'currency': {'type': ['string', 'number'], 'maxLength': 50}, 'maxValue': {'type': ['string', 'number'], 'maxLength': 50}, 'minValue': {'type': ['string', 'number'], 'maxLength': 50}}, 'minProperties': 1, 'additionalProperties': False}, 'shippingLabel': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'shippingDestination': {'type': 'object', 'properties': {'addressRegion': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 20, 'minItems': 1}]}, 'addressCountry': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 1}, {'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 20, 'minItems': 1}]}}, 'minProperties': 1, 'additionalProperties': False}}, 'minProperties': 1, 'additionalProperties': False}, 'maxItems': 10}}, 'additionalProperties': False}}, 'description': 'Structured Live product price snapshot result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'commerce.product-price'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
crypto.address-inspect
Validate and normalize an Ethereum or EVM wallet address, distinguish valid, absent, or invalid ERC-55 checksum casing, and identify the zero address without a network request.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'AddressInput', 'required': ['address'], 'properties': {'address': {'type': 'string', 'title': 'Address', 'maxLength': 128, 'minLength': 2}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'bytes': {'type': ['integer', 'null'], 'maximum': 20, 'minimum': 20}, 'valid': {'type': 'boolean', 'description': 'Whether the input is syntactically a 20-byte hexadecimal EVM address.'}, 'isZero': {'type': ['boolean', 'null']}, 'reason': {'type': ['string', 'null']}, 'source': {'type': 'string', 'format': 'uri'}, 'address': {'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'inputCase': {'enum': ['lowercase', 'uppercase', 'mixed', 'numeric', 'invalid'], 'type': 'string'}, 'verification': {'type': 'object', 'required': ['standard', 'chainIndependent', 'networkRequestsMade', 'ownershipChecked', 'balanceChecked', 'contractCodeChecked'], 'properties': {'standard': {'type': 'string', 'const': 'ERC-55'}, 'balanceChecked': {'type': 'boolean', 'const': False}, 'chainIndependent': {'type': 'boolean', 'const': True}, 'ownershipChecked': {'type': 'boolean', 'const': False}, 'contractCodeChecked': {'type': 'boolean', 'const': False}, 'networkRequestsMade': {'type': 'boolean', 'const': False}}}, 'checksumStatus': {'enum': ['valid', 'not_provided', 'invalid', 'not_applicable'], 'type': 'string'}, 'checksumAddress': {'type': ['string', 'null'], 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'inputIsChecksum': {'type': 'boolean'}, 'normalizedAddress': {'type': ['string', 'null'], 'pattern': '^0x[0-9a-f]{40}$'}}, 'description': 'Structured EVM address inspection result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'crypto.address-inspect'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
crypto.base-account-snapshot
Read point-in-time ETH, native USDC, and up to four caller-selected ERC-20 balances plus account nonce and contract-code status at one resolved Base mainnet block.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'BaseAccountSnapshotInput', 'required': ['address'], 'properties': {'address': {'type': 'string', 'title': 'Address', 'maxLength': 42, 'minLength': 42, 'description': 'A 20-byte EVM address on Base mainnet'}, 'block_tag': {'enum': ['latest', 'safe', 'finalized'], 'type': 'string', 'title': 'Block Tag', 'default': 'safe', 'description': 'Base block tag resolved once and reused for the complete snapshot'}, 'token_contracts': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Token Contracts', 'maxItems': 4, 'description': 'Optional caller-selected ERC-20 contracts whose balanceOf, decimals, and symbol methods are read at the same resolved block'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'block': {'type': 'object'}, 'nonce': {'type': 'integer'}, 'source': {'type': 'string'}, 'tokens': {'type': 'array', 'items': {'type': 'object', 'required': ['contract', 'standard', 'status', 'symbol', 'decimals', 'balanceAtomic', 'balanceFormatted', 'warnings'], 'properties': {'status': {'enum': ['ok', 'unavailable'], 'type': 'string'}, 'symbol': {'type': ['string', 'null'], 'maxLength': 64}, 'contract': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'decimals': {'type': ['integer', 'null'], 'maximum': 255, 'minimum': 0}, 'standard': {'type': 'string', 'const': 'ERC-20'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'balanceAtomic': {'type': ['string', 'null'], 'pattern': '^[0-9]+$'}, 'balanceFormatted': {'type': ['string', 'null']}}}, 'maxItems': 4, 'description': 'Balances for only the caller-selected token contracts; this is not a discovered or complete portfolio.'}, 'address': {'type': 'string'}, 'hasCode': {'type': 'boolean'}, 'network': {'type': 'string'}, 'balances': {'type': 'object'}, 'disclaimer': {'type': 'string'}, 'usdcSource': {'type': 'string'}, 'explorerUrl': {'type': 'string'}, 'tokenSource': {'type': 'string'}, 'codeSizeBytes': {'type': 'integer'}, 'requestedTokenCount': {'type': 'integer'}}, 'description': 'Structured Base account snapshot result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'crypto.base-account-snapshot'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
crypto.base-account-status
Check one Base mainnet wallet or contract for ETH and official USDC balances, transaction nonce, and contract-bytecode evidence at a single resolved block.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'BaseAccountStatusInput', 'required': ['address'], 'properties': {'address': {'type': 'string', 'title': 'Address', 'maxLength': 42, 'minLength': 42, 'description': 'A 20-byte EVM address on Base mainnet'}, 'block_tag': {'enum': ['latest', 'safe', 'finalized'], 'type': 'string', 'title': 'Block Tag', 'default': 'safe', 'description': 'Base block tag resolved once and reused for every account read'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'code': {'type': 'object', 'required': ['status', 'sizeBytes', 'sha256'], 'properties': {'sha256': {'type': ['string', 'null'], 'pattern': '^[0-9a-f]{64}$'}, 'status': {'enum': ['present', 'absent'], 'type': 'string'}, 'sizeBytes': {'type': 'integer', 'minimum': 0}}}, 'block': {'type': 'object'}, 'nonce': {'type': 'integer', 'minimum': 0}, 'source': {'type': 'string', 'format': 'uri'}, 'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'network': {'type': 'string', 'const': 'eip155:8453'}, 'readOnly': {'type': 'boolean', 'const': True}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'disclaimer': {'type': 'string'}, 'ethBalance': {'type': 'object', 'required': ['wei', 'formatted'], 'properties': {'wei': {'type': 'string', 'pattern': '^[0-9]+$'}, 'formatted': {'type': 'string', 'pattern': '^[0-9]+(?:\\.[0-9]+)?$'}}}, 'usdcSource': {'type': 'string', 'format': 'uri'}, 'explorerUrl': {'type': 'string', 'format': 'uri'}, 'usdcBalance': {'type': 'object', 'required': ['atomic', 'formatted', 'decimals', 'contract'], 'properties': {'atomic': {'type': 'string', 'pattern': '^[0-9]+$'}, 'contract': {'type': 'string', 'const': '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'}, 'decimals': {'type': 'integer', 'const': 6}, 'formatted': {'type': 'string', 'pattern': '^[0-9]+(?:\\.[0-9]+)?$'}}, 'additionalProperties': False}, 'networkRequestsMade': {'type': 'integer', 'const': 2}, 'transactionBroadcast': {'type': 'boolean', 'const': False}}, 'description': 'Structured Base account status result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'crypto.base-account-status'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
crypto.base-block-inspect
Get and inspect one historical Base mainnet block by exact number or a latest, safe, or finalized tag, returning its header timestamp, transaction count, gas use, base and blob fees, state and receipt roots, confirmations, and head-distance evidence.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'BaseBlockInspectInput', 'properties': {'block_tag': {'enum': ['latest', 'safe', 'finalized'], 'type': 'string', 'title': 'Block Tag', 'default': 'safe', 'description': 'Base block tag used only when block_number is omitted'}, 'block_number': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, {'type': 'null'}], 'title': 'Block Number', 'default': None, 'examples': [34600000], 'description': 'Optional Base block number as a JSON-safe integer. When provided it takes precedence over block_tag.'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['request', 'network', 'observedAt', 'head', 'found', 'block', 'networkRequestsMade', 'rpcCallsMade', 'readOnly', 'transactionBroadcast', 'warnings', 'source', 'disclaimer'], 'properties': {'head': {'type': 'object', 'required': ['latestNumber', 'blockAtOrBeforeHead', 'confirmations'], 'properties': {'latestNumber': {'type': 'integer', 'minimum': 0}, 'confirmations': {'type': ['integer', 'null'], 'minimum': 1}, 'blockAtOrBeforeHead': {'type': ['boolean', 'null']}}, 'additionalProperties': False}, 'block': {'anyOf': [{'type': 'object', 'required': ['number', 'hash', 'parentHash', 'timestamp', 'ageSeconds', 'transactionCount', 'sizeBytes', 'gasLimit', 'gasUsed', 'gasUtilization', 'baseFeePerGasWei', 'blobGasUsed', 'excessBlobGas', 'miner', 'roots', 'explorerUrl'], 'properties': {'hash': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$'}, 'miner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'roots': {'type': 'object', 'required': ['transactions', 'state', 'receipts'], 'properties': {'state': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$'}, 'receipts': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$'}, 'transactions': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'number': {'type': 'integer', 'minimum': 0}, 'gasUsed': {'type': 'integer', 'minimum': 0}, 'gasLimit': {'type': 'integer', 'minimum': 1}, 'sizeBytes': {'type': 'integer', 'minimum': 0}, 'timestamp': {'type': 'string', 'format': 'date-time'}, 'ageSeconds': {'type': 'integer', 'minimum': 0}, 'parentHash': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$'}, 'blobGasUsed': {'type': ['integer', 'null'], 'minimum': 0}, 'explorerUrl': {'type': 'string', 'format': 'uri', 'pattern': '^https://basescan\\.org/block/[0-9]+$'}, 'excessBlobGas': {'type': ['integer', 'null'], 'minimum': 0}, 'gasUtilization': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'baseFeePerGasWei': {'type': 'string', 'pattern': '^[0-9]+$'}, 'transactionCount': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, {'type': 'null'}]}, 'found': {'type': 'boolean'}, 'source': {'type': 'string', 'const': 'https://docs.base.org/base-chain/api-reference/ethereum-json-rpc-api/eth_getBlockByNumber'}, 'network': {'type': 'object', 'required': ['name', 'caip2', 'chainId'], 'properties': {'name': {'type': 'string', 'const': 'Base Mainnet'}, 'caip2': {'type': 'string', 'const': 'eip155:8453'}, 'chainId': {'type': 'integer', 'const': 8453}}, 'additionalProperties': False}, 'request': {'type': 'object', 'required': ['mode', 'blockNumber', 'blockTag', 'rpcSelector', 'fullTransactions'], 'properties': {'mode': {'enum': ['number', 'tag'], 'type': 'string'}, 'blockTag': {'enum': ['latest', 'safe', 'finalized', None], 'type': ['string', 'null']}, 'blockNumber': {'type': ['integer', 'null'], 'maximum': 9007199254740991, 'minimum': 0}, 'rpcSelector': {'type': 'string', 'pattern': '^(?:0x[0-9a-f]+|latest|safe|finalized)$'}, 'fullTransactions': {'type': 'boolean', 'const': False}}, 'additionalProperties': False}, 'readOnly': {'type': 'boolean', 'const': True}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 2}, 'disclaimer': {'type': 'string', 'maxLength': 500}, 'observedAt': {'type': 'string', 'format': 'date-time'}, 'rpcCallsMade': {'type': 'integer', 'const': 3}, 'networkRequestsMade': {'type': 'integer', 'const': 1}, 'transactionBroadcast': {'type': 'boolean', 'const': False}}, 'description': 'Structured Base block inspection result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'crypto.base-block-inspect'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
crypto.base-contract-inspect
Inspect Base mainnet contract bytecode, common token metadata, and ERC-165, ERC-721, and ERC-1155 interface signals at one resolved block.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'BaseContractInspectInput', 'required': ['contract'], 'properties': {'contract': {'type': 'string', 'title': 'Contract', 'maxLength': 42, 'minLength': 42, 'description': 'The 20-byte Base mainnet contract address to inspect'}, 'block_tag': {'enum': ['latest', 'safe', 'finalized'], 'type': 'string', 'title': 'Block Tag', 'default': 'safe', 'description': 'Base block tag resolved once and reused for every inspection read'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'code': {'type': 'object', 'required': ['sizeBytes', 'sha256'], 'properties': {'sha256': {'type': ['string', 'null'], 'pattern': '^[0-9a-f]{64}$'}, 'sizeBytes': {'type': 'integer', 'minimum': 0}}}, 'block': {'type': 'object', 'required': ['requestedTag', 'number', 'hash', 'timestamp'], 'properties': {'hash': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$'}, 'number': {'type': 'integer', 'minimum': 0}, 'timestamp': {'type': 'string', 'format': 'date-time'}, 'requestedTag': {'enum': ['latest', 'safe', 'finalized'], 'type': 'string'}}}, 'found': {'type': 'boolean'}, 'source': {'type': 'string', 'format': 'uri'}, 'network': {'type': 'string', 'const': 'eip155:8453'}, 'contract': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'readOnly': {'type': 'boolean', 'const': True}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'disclaimer': {'type': 'string'}, 'interfaces': {'type': 'array', 'items': {'type': 'object', 'required': ['standard', 'interfaceId', 'supported'], 'properties': {'standard': {'enum': ['ERC-165', 'ERC-721', 'ERC-1155'], 'type': 'string'}, 'supported': {'type': ['boolean', 'null']}, 'interfaceId': {'type': 'string', 'pattern': '^0x[0-9a-f]{8}$'}}}, 'maxItems': 3, 'minItems': 3}, 'explorerUrl': {'type': 'string', 'format': 'uri'}, 'tokenMetadata': {'type': 'object', 'required': ['status', 'name', 'symbol', 'decimals', 'totalSupplyAtomic', 'totalSupplyFormatted'], 'properties': {'name': {'type': ['string', 'null'], 'maxLength': 64}, 'status': {'enum': ['complete', 'partial', 'unavailable'], 'type': 'string'}, 'symbol': {'type': ['string', 'null'], 'maxLength': 64}, 'decimals': {'type': ['integer', 'null'], 'maximum': 255, 'minimum': 0}, 'totalSupplyAtomic': {'type': ['string', 'null'], 'pattern': '^[0-9]+$'}, 'totalSupplyFormatted': {'type': ['string', 'null']}}}, 'standardSources': {'type': 'object', 'required': ['ERC-20', 'ERC-165', 'ERC-721', 'ERC-1155'], 'properties': {'ERC-20': {'type': 'string', 'format': 'uri'}, 'ERC-165': {'type': 'string', 'format': 'uri'}, 'ERC-721': {'type': 'string', 'format': 'uri'}, 'ERC-1155': {'type': 'string', 'format': 'uri'}}}, 'networkRequestsMade': {'type': 'integer', 'const': 2}, 'transactionBroadcast': {'type': 'boolean', 'const': False}}, 'description': 'Structured Base contract inspection result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'crypto.base-contract-inspect'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
crypto.base-contract-read
Execute one bounded read-only eth_call against a resolved Base mainnet block, retain call and block evidence, and optionally decode caller-specified ABI output types.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'BaseContractReadInput', 'required': ['contract', 'call_data'], 'properties': {'contract': {'type': 'string', 'title': 'Contract', 'maxLength': 42, 'minLength': 42, 'description': 'The 20-byte Base mainnet contract address to read'}, 'block_tag': {'enum': ['latest', 'safe', 'finalized'], 'type': 'string', 'title': 'Block Tag', 'default': 'safe', 'description': 'Base block tag resolved once before executing the read'}, 'call_data': {'type': 'string', 'title': 'Call Data', 'examples': ['0x313ce567'], 'maxLength': 16386, 'minLength': 2, 'description': 'ABI-encoded eth_call data, including the function selector'}, 'gas_limit': {'type': 'integer', 'title': 'Gas Limit', 'default': 2000000, 'maximum': 5000000, 'minimum': 21000, 'description': 'Bounded execution allowance for the read-only call'}, 'from_address': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'From Address', 'default': None, 'description': 'Optional msg.sender context; no private key or transaction is used'}, 'output_types': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Output Types', 'examples': [['uint8']], 'maxItems': 16, 'description': 'Optional primitive ABI output types used to decode a successful result; arrays and tuples are intentionally excluded'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'call': {'type': 'object', 'required': ['contract', 'from', 'selector', 'dataBytes', 'gasLimit', 'valueWei'], 'properties': {'from': {'type': ['string', 'null']}, 'contract': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'gasLimit': {'type': 'integer', 'maximum': 5000000, 'minimum': 21000}, 'selector': {'type': ['string', 'null'], 'pattern': '^0x[0-9a-f]{8}$'}, 'valueWei': {'type': 'string', 'const': '0'}, 'dataBytes': {'type': 'integer', 'maximum': 8192, 'minimum': 0}}}, 'block': {'type': 'object'}, 'result': {'type': ['object', 'null'], 'properties': {'hex': {'type': 'string', 'pattern': '^0x(?:[0-9a-f]{2})*$'}, 'bytes': {'type': 'integer', 'minimum': 0}, 'sha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'truncated': {'type': 'boolean'}, 'returnedBytes': {'type': 'integer', 'maximum': 65536, 'minimum': 0}}}, 'source': {'type': 'string'}, 'network': {'type': 'string'}, 'success': {'type': 'boolean'}, 'readOnly': {'type': 'boolean'}, 'rpcError': {'type': ['object', 'null'], 'properties': {'code': {'type': 'integer'}, 'message': {'type': 'string', 'maxLength': 300}, 'dataPreview': {'type': ['string', 'null'], 'maxLength': 4096}, 'dataTruncated': {'type': 'boolean'}}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'disclaimer': {'type': 'string'}, 'outputTypes': {'type': 'array', 'items': {'type': 'string', 'maxLength': 128}, 'maxItems': 16}, 'decodeStatus': {'enum': ['decoded', 'failed', 'not_attempted', 'not_requested', 'skipped_truncated'], 'type': 'string'}, 'decodedValues': {'type': ['array', 'null'], 'items': {}}, 'transactionBroadcast': {'type': 'boolean'}}, 'description': 'Structured Base contract read result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'crypto.base-contract-read'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
crypto.base-event-logs
Query validated eth_getLogs events from one Base mainnet contract using a required event signature and optional indexed topic filters across a bounded resolved block range.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'BaseEventLogsInput', 'required': ['contract', 'topics'], 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 50, 'maximum': 100, 'minimum': 1, 'description': 'Maximum newest-first validated logs returned'}, 'topics': {'type': 'array', 'items': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': 'Topics', 'examples': [['0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef'], ['0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef', None, '0x0000000000000000000000001111111111111111111111111111111111111111']], 'maxItems': 4, 'minItems': 1, 'description': 'One required event-signature topic followed by optional indexed topic values or null wildcards. Signature-only scans are limited to 100 resolved blocks; adding an indexed value permits up to 2,000.'}, 'contract': {'type': 'string', 'title': 'Contract', 'maxLength': 42, 'minLength': 42, 'description': 'The 20-byte Base mainnet contract whose event logs are queried'}, 'block_tag': {'enum': ['latest', 'safe', 'finalized'], 'type': 'string', 'title': 'Block Tag', 'default': 'safe', 'description': 'Base block tag resolved once as the inclusive upper bound'}, 'lookback_blocks': {'type': 'integer', 'title': 'Lookback Blocks', 'default': 100, 'maximum': 2000, 'minimum': 1, 'description': 'Inclusive resolved Base blocks to scan; defaults to the 100-block signature-only ceiling and may be raised to 2,000 with an indexed topic value'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['network', 'filter', 'blockRange', 'queriedLogCount', 'detected', 'returned', 'truncated', 'duplicatesRemoved', 'removedSkipped', 'logs', 'networkRequestsMade', 'rpcCallsMade', 'readOnly', 'transactionBroadcast', 'warnings', 'limitations', 'contractExplorerUrl', 'source', 'disclaimer'], 'properties': {'logs': {'type': 'array', 'items': {'type': 'object', 'required': ['contract', 'topics', 'data', 'blockNumber', 'blockHash', 'transactionHash', 'transactionIndex', 'logIndex', 'explorerUrl'], 'properties': {'data': {'type': 'object', 'required': ['hex', 'bytes', 'returnedBytes', 'truncated', 'sha256'], 'properties': {'hex': {'type': 'string', 'pattern': '^0x(?:[0-9a-f]{2})*$', 'maxLength': 8194}, 'bytes': {'type': 'integer', 'maximum': 1048576, 'minimum': 0}, 'sha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'truncated': {'type': 'boolean'}, 'returnedBytes': {'type': 'integer', 'maximum': 4096, 'minimum': 0}}, 'additionalProperties': False}, 'topics': {'type': 'array', 'items': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$'}, 'maxItems': 4, 'minItems': 1}, 'contract': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'logIndex': {'type': 'integer', 'minimum': 0}, 'blockHash': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$'}, 'blockNumber': {'type': 'integer', 'minimum': 0}, 'explorerUrl': {'type': 'string', 'format': 'uri'}, 'transactionHash': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$'}, 'transactionIndex': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 100}, 'filter': {'type': 'object', 'required': ['contract', 'topics'], 'properties': {'topics': {'type': 'array', 'items': {'type': ['string', 'null'], 'pattern': '^0x[0-9a-f]{64}$'}, 'maxItems': 4, 'minItems': 1}, 'contract': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}}, 'additionalProperties': False}, 'source': {'type': 'string', 'format': 'uri'}, 'network': {'type': 'string', 'const': 'eip155:8453'}, 'detected': {'type': 'integer', 'minimum': 0}, 'readOnly': {'type': 'boolean', 'const': True}, 'returned': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 4}, 'truncated': {'type': 'boolean'}, 'blockRange': {'type': 'object', 'required': ['requestedTag', 'fromBlock', 'toBlock', 'toBlockHash', 'toBlockTimestamp', 'requestedLookbackBlocks', 'scannedBlocks'], 'properties': {'toBlock': {'type': 'integer', 'minimum': 0}, 'fromBlock': {'type': 'integer', 'minimum': 0}, 'toBlockHash': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$'}, 'requestedTag': {'enum': ['latest', 'safe', 'finalized'], 'type': 'string'}, 'scannedBlocks': {'type': 'integer', 'maximum': 2000, 'minimum': 1}, 'toBlockTimestamp': {'type': 'string', 'format': 'date-time'}, 'requestedLookbackBlocks': {'type': 'integer', 'maximum': 2000, 'minimum': 1}}, 'additionalProperties': False}, 'disclaimer': {'type': 'string'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 3, 'minItems': 3}, 'rpcCallsMade': {'type': 'integer', 'maximum': 51, 'minimum': 2}, 'removedSkipped': {'type': 'integer', 'minimum': 0}, 'queriedLogCount': {'type': 'integer', 'minimum': 0}, 'duplicatesRemoved': {'type': 'integer', 'minimum': 0}, 'contractExplorerUrl': {'type': 'string', 'format': 'uri'}, 'networkRequestsMade': {'type': 'integer', 'maximum': 51, 'minimum': 2}, 'transactionBroadcast': {'type': 'boolean', 'const': False}}, 'description': 'Structured Base contract event logs result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'crypto.base-event-logs'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
crypto.base-gas-estimate
Estimate gas for one Base mainnet transaction context at a resolved block, add a bounded caller-selected buffer, and preserve RPC rejection evidence without signing or broadcasting.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'BaseGasEstimateInput', 'required': ['from_address', 'to'], 'properties': {'to': {'type': 'string', 'title': 'To', 'maxLength': 42, 'minLength': 42, 'description': 'The 20-byte Base mainnet transaction destination'}, 'block_tag': {'enum': ['latest', 'safe', 'finalized'], 'type': 'string', 'title': 'Block Tag', 'default': 'safe', 'description': 'Base block tag resolved once before estimation'}, 'call_data': {'type': 'string', 'title': 'Call Data', 'default': '0x', 'examples': ['0x313ce567'], 'maxLength': 32770, 'minLength': 2, 'description': 'Optional even-length hexadecimal transaction calldata'}, 'value_wei': {'type': 'string', 'title': 'Value Wei', 'default': '0', 'examples': ['0'], 'maxLength': 78, 'minLength': 1, 'description': 'Unsigned ETH value in wei as a canonical decimal string'}, 'from_address': {'type': 'string', 'title': 'From Address', 'maxLength': 42, 'minLength': 42, 'description': 'The 20-byte Base mainnet sender context; no private key is used'}, 'buffer_percent': {'type': 'integer', 'title': 'Buffer Percent', 'default': 20, 'maximum': 50, 'minimum': 0, 'description': 'Bounded percentage added to the RPC estimate for a suggested gas limit'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['network', 'status', 'estimationAccepted', 'transaction', 'block', 'estimate', 'rpcError', 'networkRequestsMade', 'rpcCallsMade', 'readOnly', 'transactionBroadcast', 'warnings', 'limitations', 'source', 'disclaimer'], 'properties': {'block': {'type': 'object', 'required': ['requestedTag', 'number', 'hash', 'timestamp', 'gasLimit', 'baseFeePerGasWei'], 'properties': {'hash': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$'}, 'number': {'type': 'integer', 'minimum': 0}, 'gasLimit': {'type': 'integer', 'minimum': 21000}, 'timestamp': {'type': 'string', 'format': 'date-time'}, 'requestedTag': {'enum': ['latest', 'safe', 'finalized'], 'type': 'string'}, 'baseFeePerGasWei': {'type': 'string', 'pattern': '^[0-9]+$'}}, 'additionalProperties': False}, 'source': {'type': 'string', 'format': 'uri'}, 'status': {'enum': ['estimated', 'rejected'], 'type': 'string'}, 'network': {'type': 'string', 'const': 'eip155:8453'}, 'estimate': {'type': ['object', 'null'], 'required': ['gas', 'gasHex', 'bufferPercent', 'suggestedGasLimit', 'suggestedGasLimitHex', 'bufferCapped', 'baseFeeComponentWei', 'suggestedBaseFeeComponentWei'], 'properties': {'gas': {'type': 'integer', 'minimum': 1}, 'gasHex': {'type': 'string', 'pattern': '^0x[0-9a-f]+$'}, 'bufferCapped': {'type': 'boolean'}, 'bufferPercent': {'type': 'integer', 'maximum': 50, 'minimum': 0}, 'suggestedGasLimit': {'type': 'integer', 'minimum': 1}, 'baseFeeComponentWei': {'type': 'string', 'pattern': '^[0-9]+$'}, 'suggestedGasLimitHex': {'type': 'string', 'pattern': '^0x[0-9a-f]+$'}, 'suggestedBaseFeeComponentWei': {'type': 'string', 'pattern': '^[0-9]+$'}}, 'additionalProperties': False}, 'readOnly': {'type': 'boolean', 'const': True}, 'rpcError': {'type': ['object', 'null'], 'required': ['code', 'message', 'dataPreview', 'dataTruncated'], 'properties': {'code': {'type': 'integer'}, 'message': {'type': 'string', 'maxLength': 300}, 'dataPreview': {'type': ['string', 'null'], 'maxLength': 4096}, 'dataTruncated': {'type': 'boolean'}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 3}, 'disclaimer': {'type': 'string'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 3, 'minItems': 3}, 'transaction': {'type': 'object', 'required': ['from', 'to', 'valueWei', 'dataBytes', 'dataSha256', 'selector'], 'properties': {'to': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'from': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'selector': {'type': ['string', 'null'], 'pattern': '^0x[0-9a-f]{8}$'}, 'valueWei': {'type': 'string', 'pattern': '^(?:0|[1-9][0-9]{0,77})$'}, 'dataBytes': {'type': 'integer', 'maximum': 16384, 'minimum': 0}, 'dataSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'rpcCallsMade': {'type': 'integer', 'const': 2}, 'estimationAccepted': {'type': 'boolean'}, 'networkRequestsMade': {'type': 'integer', 'const': 2}, 'transactionBroadcast': {'type': 'boolean', 'const': False}}, 'description': 'Structured Base transaction gas estimate result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'crypto.base-gas-estimate'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
crypto.base-network-status
Read the latest Base mainnet block and a bounded EIP-1559 fee history in one RPC batch, including gas utilization and priority-fee percentile samples.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'BaseNetworkStatusInput', 'properties': {'fee_history_blocks': {'type': 'integer', 'title': 'Fee History Blocks', 'default': 5, 'maximum': 20, 'minimum': 1, 'description': 'Number of recent Base blocks included in the EIP-1559 fee history'}, 'reward_percentiles': {'type': 'array', 'items': {'type': 'number'}, 'title': 'Reward Percentiles', 'maxItems': 5, 'minItems': 1, 'description': 'Strictly increasing gas-tip percentiles requested from eth_feeHistory'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'fees': {'type': 'object'}, 'source': {'type': 'string'}, 'network': {'type': 'object'}, 'readOnly': {'type': 'boolean'}, 'warnings': {'type': 'array', 'items': {}}, 'disclaimer': {'type': 'string'}, 'observedAt': {'type': 'string'}, 'latestBlock': {'type': 'object'}, 'networkRequestsMade': {'type': 'integer'}, 'transactionBroadcast': {'type': 'boolean'}}, 'description': 'Structured Base network and fee status result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'crypto.base-network-status'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
crypto.base-transaction-inspect
Inspect Base transaction status and receipt evidence in one call, including success, revert, or pending state, confirmations, actual gas fee, recognized calldata, bounded ERC-20-shaped transfers, and official Base USDC recognition for payment confirmation.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'BaseTransactionInspectInput', 'required': ['transaction_hash'], 'properties': {'transaction_hash': {'type': 'string', 'title': 'Transaction Hash', 'examples': ['0x1212121212121212121212121212121212121212121212121212121212121212'], 'description': 'A 32-byte Base mainnet transaction hash'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'block': {'type': ['object', 'null']}, 'found': {'type': 'boolean'}, 'mined': {'type': 'boolean'}, 'source': {'type': 'string', 'format': 'uri'}, 'network': {'type': 'string', 'const': 'eip155:8453'}, 'outcome': {'enum': ['success', 'reverted', 'pending', 'not_found'], 'type': 'string'}, 'receipt': {'type': ['object', 'null'], 'properties': {'status': {'enum': [0, 1], 'type': 'integer'}, 'gasUsed': {'type': 'integer', 'minimum': 0}, 'outcome': {'enum': ['success', 'reverted'], 'type': 'string'}, 'actualFee': {'type': 'object'}, 'logsCount': {'type': 'integer', 'minimum': 0}, 'tokenTransfers': {'type': 'object', 'required': ['eventSignature', 'topic0', 'detected', 'returned', 'truncated', 'officialBaseUsdcDetected', 'events', 'method', 'source', 'limitations'], 'properties': {'events': {'type': 'array', 'items': {'type': 'object', 'required': ['logIndex', 'contract', 'from', 'to', 'valueAtomic', 'officialBaseUsdc', 'valueFormatted'], 'properties': {'to': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'from': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'contract': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'logIndex': {'type': 'integer', 'minimum': 0}, 'valueAtomic': {'type': 'string', 'pattern': '^[0-9]+$'}, 'valueFormatted': {'type': ['string', 'null']}, 'officialBaseUsdc': {'type': 'boolean'}}}, 'maxItems': 100}, 'method': {'type': 'string'}, 'source': {'type': 'string', 'format': 'uri'}, 'topic0': {'type': 'string', 'const': '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef'}, 'detected': {'type': 'integer', 'minimum': 0}, 'returned': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'truncated': {'type': 'boolean'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'eventSignature': {'type': 'string', 'const': 'Transfer(address,address,uint256)'}, 'officialBaseUsdcDetected': {'type': 'integer', 'minimum': 0}}}, 'contractAddress': {'type': ['string', 'null'], 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'cumulativeGasUsed': {'type': 'integer', 'minimum': 0}, 'effectiveGasPriceWei': {'type': 'string', 'pattern': '^[0-9]+$'}}}, 'disclaimer': {'type': 'string'}, 'explorerUrl': {'type': 'string', 'format': 'uri'}, 'transaction': {'type': ['object', 'null']}, 'observedAtBlock': {'type': 'integer', 'minimum': 0}, 'transactionHash': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$'}}, 'description': 'Structured Base transaction inspection result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'crypto.base-transaction-inspect'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
crypto.base-usdc-transfers
Retrieve newest-first incoming and outgoing Circle USDC Transfer events for one address across a validated, bounded Base mainnet block range.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'BaseUsdcTransfersInput', 'required': ['address'], 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 50, 'maximum': 100, 'minimum': 1, 'description': 'Maximum newest-first transfers returned after validation and de-duplication'}, 'address': {'type': 'string', 'title': 'Address', 'maxLength': 42, 'minLength': 42, 'description': 'The 20-byte Base mainnet address whose official USDC transfers are read'}, 'block_tag': {'enum': ['latest', 'safe', 'finalized'], 'type': 'string', 'title': 'Block Tag', 'default': 'safe', 'description': 'Base block tag resolved once as the inclusive upper bound'}, 'direction': {'enum': ['any', 'incoming', 'outgoing'], 'type': 'string', 'title': 'Direction', 'default': 'any', 'description': 'Return transfers in either direction or restrict the indexed address topic'}, 'lookback_blocks': {'type': 'integer', 'title': 'Lookback Blocks', 'default': 2000, 'maximum': 2000, 'minimum': 1, 'description': 'Inclusive number of resolved Base blocks to scan, capped for RPC reliability'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'asset': {'type': 'object', 'required': ['name', 'symbol', 'contract', 'decimals'], 'properties': {'name': {'type': 'string', 'const': 'USD Coin'}, 'symbol': {'type': 'string', 'const': 'USDC'}, 'contract': {'type': 'string', 'const': '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'}, 'decimals': {'type': 'integer', 'const': 6}}, 'additionalProperties': False}, 'source': {'type': 'string', 'format': 'uri'}, 'topic0': {'type': 'string', 'const': '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef'}, 'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'network': {'type': 'string', 'const': 'eip155:8453'}, 'detected': {'type': 'integer', 'minimum': 0}, 'readOnly': {'type': 'boolean', 'const': True}, 'returned': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'direction': {'enum': ['any', 'incoming', 'outgoing'], 'type': 'string'}, 'transfers': {'type': 'array', 'items': {'type': 'object', 'required': ['blockNumber', 'blockHash', 'transactionHash', 'transactionIndex', 'logIndex', 'from', 'to', 'direction', 'amountAtomic', 'amountUsdc', 'explorerUrl'], 'properties': {'to': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'from': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'logIndex': {'type': 'integer', 'minimum': 0}, 'blockHash': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$'}, 'direction': {'enum': ['incoming', 'outgoing', 'self'], 'type': 'string'}, 'amountUsdc': {'type': 'string', 'pattern': '^[0-9]+(?:\\.[0-9]{1,6})?$'}, 'blockNumber': {'type': 'integer', 'minimum': 0}, 'explorerUrl': {'type': 'string', 'format': 'uri'}, 'amountAtomic': {'type': 'string', 'pattern': '^[0-9]+$'}, 'transactionHash': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$'}, 'transactionIndex': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 100}, 'truncated': {'type': 'boolean'}, 'blockRange': {'type': 'object', 'required': ['requestedTag', 'fromBlock', 'toBlock', 'toBlockHash', 'toBlockTimestamp', 'requestedLookbackBlocks', 'scannedBlocks'], 'properties': {'toBlock': {'type': 'integer', 'minimum': 0}, 'fromBlock': {'type': 'integer', 'minimum': 0}, 'toBlockHash': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$'}, 'requestedTag': {'enum': ['latest', 'safe', 'finalized'], 'type': 'string'}, 'scannedBlocks': {'type': 'integer', 'maximum': 2000, 'minimum': 1}, 'toBlockTimestamp': {'type': 'string', 'format': 'date-time'}, 'requestedLookbackBlocks': {'type': 'integer', 'maximum': 2000, 'minimum': 1}}, 'additionalProperties': False}, 'disclaimer': {'type': 'string'}, 'usdcSource': {'type': 'string', 'format': 'uri'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'tokenSource': {'type': 'string', 'format': 'uri'}, 'rpcCallsMade': {'enum': [2, 3], 'type': 'integer'}, 'eventSignature': {'type': 'string', 'const': 'Transfer(address,address,uint256)'}, 'removedSkipped': {'type': 'integer', 'minimum': 0}, 'queriedLogCount': {'type': 'integer', 'minimum': 0}, 'duplicatesRemoved': {'type': 'integer', 'minimum': 0}, 'addressExplorerUrl': {'type': 'string', 'format': 'uri'}, 'networkRequestsMade': {'type': 'integer', 'const': 2}, 'transactionBroadcast': {'type': 'boolean', 'const': False}}, 'description': 'Structured Base USDC transfer history result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'crypto.base-usdc-transfers'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
crypto.calldata-decode
Resolve 29 common ERC-20, ERC-165, ERC-721, ERC-1155, ERC-2612, and ERC-3009 selectors without a network lookup, or strictly decode arbitrary Ethereum or EVM calldata using a supplied Solidity signature.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'CalldataInput', 'required': ['calldata'], 'properties': {'calldata': {'type': 'string', 'title': 'Calldata', 'maxLength': 200000, 'minLength': 2, 'description': 'ABI argument bytes, optionally prefixed by the four-byte function selector'}, 'input_mode': {'enum': ['auto', 'selector_and_arguments', 'arguments_only'], 'type': 'string', 'title': 'Input Mode', 'default': 'auto', 'description': 'Whether calldata includes a selector. Auto consumes a matching supplied-signature selector, or resolves a built-in standard selector when function_signature is omitted.'}, 'function_signature': {'anyOf': [{'type': 'string', 'maxLength': 500, 'minLength': 3}, {'type': 'null'}], 'title': 'Function Signature', 'default': None, 'examples': ['transfer(address,uint256)'], 'description': 'Optional Solidity function signature, including argument types but no parameter names. When omitted, calldata must include a selector from the bounded built-in ERC-20, ERC-165, ERC-721, ERC-1155, ERC-2612, or ERC-3009 set.'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'types': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 64}, 'values': {'type': 'array', 'items': {}, 'maxItems': 64}, 'encoding': {'type': 'object', 'required': ['calldataBytes', 'argumentBytes', 'calldataSha256', 'argumentsSha256', 'canonical'], 'properties': {'canonical': {'type': 'boolean', 'const': True}, 'argumentBytes': {'type': 'integer', 'maximum': 100000, 'minimum': 0}, 'calldataBytes': {'type': 'integer', 'maximum': 100000, 'minimum': 0}, 'calldataSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'argumentsSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}}}, 'function': {'type': 'string'}, 'selector': {'type': 'string', 'pattern': '^0x[0-9a-f]{8}$'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'arguments': {'type': 'array', 'items': {'type': 'object', 'required': ['index', 'type', 'value'], 'properties': {'type': {'type': 'string'}, 'index': {'type': 'integer', 'maximum': 63, 'minimum': 0}, 'value': {}}}, 'maxItems': 64}, 'inputMode': {'enum': ['selector_and_arguments', 'arguments_only'], 'type': 'string'}, 'signature': {'type': 'string'}, 'resolution': {'type': 'object', 'required': ['method', 'signatureProvided', 'candidateCount', 'candidates', 'matchedStandards', 'standardReferences', 'builtInSignatureCount', 'registryComplete', 'networkRequestsMade', 'version'], 'properties': {'method': {'enum': ['caller_supplied', 'built_in_standard'], 'type': 'string'}, 'version': {'type': 'string', 'const': 'apiacre-standard-selectors/1'}, 'candidates': {'type': 'array', 'items': {'type': 'string'}}, 'candidateCount': {'type': 'integer', 'minimum': 1}, 'matchedStandards': {'type': 'array', 'items': {'type': 'string'}}, 'registryComplete': {'type': 'boolean', 'const': False}, 'signatureProvided': {'type': 'boolean'}, 'standardReferences': {'type': 'array', 'items': {'type': 'object', 'required': ['standard', 'url'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'standard': {'type': 'string'}}}}, 'networkRequestsMade': {'type': 'boolean', 'const': False}, 'builtInSignatureCount': {'type': 'integer', 'const': 29}}}, 'selectorPresent': {'type': 'boolean'}, 'signatureSource': {'enum': ['caller_supplied', 'built_in_standard'], 'type': 'string'}, 'canonicalSignature': {'type': 'string', 'pattern': '^[A-Za-z_][A-Za-z0-9_]*\\(.*\\)$'}}, 'description': 'Structured Calldata decoder result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'crypto.calldata-decode'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
crypto.typed-data-hash
Validate EIP-712 typed structured data and derive its domain separator, message hash, and signing digest.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'TypedDataInput', 'required': ['typed_data'], 'properties': {'typed_data': {'type': 'object', 'title': 'Typed Data', 'additionalProperties': True}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'valid': {'type': 'boolean'}, 'messageHash': {'type': 'string'}, 'primaryType': {'type': 'string'}, 'signingHash': {'type': 'string'}, 'domainSeparator': {'type': 'string'}}, 'description': 'Structured EIP-712 hash result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'crypto.typed-data-hash'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.clean
Clean CSV, TSV, JSON, JSON Lines, or YAML records with collision-safe header normalization, deterministic integrity hashes, and exact transformation counts.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'CleanInput', 'required': ['content', 'format'], 'properties': {'format': {'enum': ['csv', 'tsv', 'json', 'jsonl', 'yaml'], 'type': 'string', 'title': 'Format', 'description': 'Source format; use jsonl for JSON Lines or NDJSON'}, 'content': {'type': 'string', 'title': 'Content', 'maxLength': 2000000}, 'trim_strings': {'type': 'boolean', 'title': 'Trim Strings', 'default': True}, 'empty_to_null': {'type': 'boolean', 'title': 'Empty To Null', 'default': True}, 'normalize_headers': {'type': 'boolean', 'title': 'Normalize Headers', 'default': True}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['records', 'rows', 'inputSha256', 'outputSha256', 'cleaning', 'warnings'], 'properties': {'rows': {'type': 'integer', 'maximum': 100000, 'minimum': 0}, 'records': {'type': 'array', 'items': {'type': 'object'}, 'maxItems': 100000}, 'cleaning': {'type': 'object', 'required': ['version', 'sourceFormat', 'trimStrings', 'emptyStringsAsNull', 'normalizeHeaders', 'headerFieldsNormalized', 'stringsTrimmed', 'emptyStringsConvertedToNull', 'nodesProcessed', 'nonStringKeysNormalized', 'dateTimeScalarsNormalized', 'outputCanonicalization', 'deterministic', 'networkRequestsMade'], 'properties': {'version': {'type': 'string', 'const': 'apiacre-data-clean/2'}, 'trimStrings': {'type': 'boolean'}, 'sourceFormat': {'enum': ['csv', 'tsv', 'json', 'jsonl', 'yaml'], 'type': 'string'}, 'deterministic': {'type': 'boolean', 'const': True}, 'nodesProcessed': {'type': 'integer', 'maximum': 100000, 'minimum': 1}, 'stringsTrimmed': {'type': 'integer', 'minimum': 0}, 'normalizeHeaders': {'type': 'boolean'}, 'emptyStringsAsNull': {'type': 'boolean'}, 'networkRequestsMade': {'type': 'integer', 'const': 0}, 'headerFieldsNormalized': {'type': 'integer', 'minimum': 0}, 'outputCanonicalization': {'type': 'string', 'const': 'json-sort-keys-compact-utf8'}, 'nonStringKeysNormalized': {'type': 'integer', 'minimum': 0}, 'dateTimeScalarsNormalized': {'type': 'integer', 'minimum': 0}, 'emptyStringsConvertedToNull': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 120}, 'maxItems': 2}, 'inputSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'outputSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}}, 'description': 'Structured Dataset cleaning result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.clean'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.contract
Normalize caller-supplied CSV, TSV, JSON, JSON Lines, or YAML to deterministic JSON, infer a Draft 2020-12 schema from that normalized value, and validate one future JSON value in a single x402 call.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'DataContractInput', 'required': ['content', 'format', 'instance'], 'properties': {'format': {'enum': ['csv', 'tsv', 'json', 'jsonl', 'yaml'], 'type': 'string', 'title': 'Format', 'description': 'Source format; use jsonl for JSON Lines or NDJSON'}, 'content': {'type': 'string', 'title': 'Content', 'maxLength': 2000000}, 'instance': {'title': 'Instance', 'description': 'Future JSON-compatible value to validate against the schema inferred from content'}, 'root_mode': {'enum': ['records', 'preserve'], 'type': 'string', 'title': 'Root Mode', 'default': 'records', 'description': 'Keep the compatible array-of-records contract, or preserve the JSON/YAML root shape'}, 'max_errors': {'type': 'integer', 'title': 'Max Errors', 'default': 25, 'maximum': 100, 'minimum': 1}, 'check_formats': {'type': 'boolean', 'title': 'Check Formats', 'default': True, 'description': 'Assert supported JSON Schema formats during future-value validation'}}, 'description': 'Source records plus one future value to check against their observed contract.', 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['normalized', 'contract', 'validation', 'pipeline'], 'properties': {'contract': {'type': 'object', 'required': ['schema', 'input', 'inference'], 'properties': {'input': {'type': 'object', 'required': ['format', 'rootMode', 'records', 'characters', 'utf8Bytes', 'sha256'], 'properties': {'format': {'type': 'string', 'const': 'json'}, 'sha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'records': {'type': 'integer', 'maximum': 100000, 'minimum': 0}, 'rootMode': {'enum': ['records', 'preserve'], 'type': 'string'}, 'utf8Bytes': {'type': 'integer', 'maximum': 4000000, 'minimum': 0}, 'characters': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'schema': {'type': 'object', 'description': 'Inferred JSON Schema Draft 2020-12 document'}, 'inference': {'type': 'object', 'required': ['version', 'dialect', 'csvNumericStringsCoerced', 'csvEmptyStringsAsNull', 'tabularNumericStringsCoerced', 'tabularEmptyStringsAsNull', 'nodesProcessed', 'nonStringKeysNormalized', 'dateTimeScalarsNormalized', 'observedBoundsEnforced', 'maximumDepth', 'complete', 'warnings'], 'properties': {'dialect': {'type': 'string', 'const': 'https://json-schema.org/draft/2020-12/schema'}, 'version': {'type': 'string', 'const': 'apiacre-schema-inference/3'}, 'complete': {'type': 'boolean'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'maximumDepth': {'type': 'integer', 'const': 20}, 'nodesProcessed': {'type': 'integer', 'maximum': 100000, 'minimum': 1}, 'csvEmptyStringsAsNull': {'type': 'boolean', 'const': False}, 'observedBoundsEnforced': {'type': 'boolean', 'const': False}, 'nonStringKeysNormalized': {'type': 'integer', 'minimum': 0}, 'csvNumericStringsCoerced': {'type': 'boolean', 'const': False}, 'dateTimeScalarsNormalized': {'type': 'integer', 'minimum': 0}, 'tabularEmptyStringsAsNull': {'type': 'boolean', 'const': False}, 'tabularNumericStringsCoerced': {'type': 'boolean', 'const': False}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'pipeline': {'type': 'object', 'required': ['version', 'steps', 'singlePaymentAuthorization', 'deterministic', 'networkRequestsMade'], 'properties': {'steps': {'type': 'array', 'maxItems': 3, 'minItems': 3, 'prefixItems': [{'type': 'string', 'const': 'normalize-to-json'}, {'type': 'string', 'const': 'infer-draft-2020-12'}, {'type': 'string', 'const': 'validate-instance'}]}, 'version': {'type': 'string', 'const': 'apiacre-data-contract/1'}, 'deterministic': {'type': 'boolean', 'const': True}, 'networkRequestsMade': {'type': 'integer', 'const': 0}, 'singlePaymentAuthorization': {'type': 'boolean', 'const': True}}, 'additionalProperties': False}, 'normalized': {'type': 'object', 'required': ['sourceFormat', 'format', 'rootMode', 'content', 'records', 'inputSha256', 'outputSha256', 'normalization', 'warnings'], 'properties': {'format': {'type': 'string', 'const': 'json'}, 'content': {'type': 'string', 'maxLength': 4000000}, 'records': {'type': 'integer', 'maximum': 100000, 'minimum': 0}, 'rootMode': {'enum': ['records', 'preserve'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'inputSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'outputSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'sourceFormat': {'enum': ['csv', 'tsv', 'json', 'jsonl', 'yaml'], 'type': 'string'}, 'normalization': {'type': 'object', 'required': ['version', 'sourceRoot', 'nodesProcessed', 'nonStringKeysNormalized', 'dateTimeScalarsNormalized', 'outputEncoding', 'deterministic', 'networkRequestsMade'], 'properties': {'version': {'type': 'string', 'const': 'apiacre-data-contract-normalization/1'}, 'sourceRoot': {'enum': ['array', 'object', 'scalar'], 'type': 'string'}, 'deterministic': {'type': 'boolean', 'const': True}, 'nodesProcessed': {'type': 'integer', 'maximum': 100000, 'minimum': 1}, 'outputEncoding': {'type': 'string', 'const': 'json-indent-2-utf8'}, 'networkRequestsMade': {'type': 'integer', 'const': 0}, 'nonStringKeysNormalized': {'type': 'integer', 'minimum': 0}, 'dateTimeScalarsNormalized': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'validation': {'type': 'object', 'required': ['valid', 'schemaValid', 'instanceValid', 'errorCount', 'errorCountExact', 'errorsReturned', 'errorsTruncated', 'errors', 'schema', 'instance', 'validation'], 'properties': {'valid': {'type': 'boolean'}, 'errors': {'type': 'array', 'items': {'type': 'object', 'required': ['kind', 'instancePath', 'schemaPath', 'keyword', 'message'], 'properties': {'kind': {'enum': ['schema', 'instance'], 'type': 'string'}, 'keyword': {'type': ['string', 'null']}, 'message': {'type': 'string', 'maxLength': 500}, 'schemaPath': {'type': 'string'}, 'instancePath': {'type': ['string', 'null']}}}, 'maxItems': 100}, 'schema': {'type': 'object', 'required': ['dialect', 'declaredDialect', 'utf8Bytes', 'sha256', 'remoteReferencesAllowed'], 'properties': {'sha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'dialect': {'type': 'string', 'const': 'https://json-schema.org/draft/2020-12/schema'}, 'utf8Bytes': {'type': 'integer', 'maximum': 500000, 'minimum': 2}, 'declaredDialect': {'type': ['string', 'null']}, 'remoteReferencesAllowed': {'type': 'boolean', 'const': False}}}, 'instance': {'type': 'object', 'required': ['utf8Bytes', 'sha256'], 'properties': {'sha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'utf8Bytes': {'type': 'integer', 'maximum': 1000000, 'minimum': 1}}}, 'errorCount': {'type': 'integer', 'maximum': 101, 'minimum': 0}, 'validation': {'type': 'object', 'required': ['engine', 'engineVersion', 'draft', 'formatChecking', 'maxErrors', 'networkRequestsMade'], 'properties': {'draft': {'type': 'string', 'const': '2020-12'}, 'engine': {'type': 'string', 'const': 'python-jsonschema'}, 'maxErrors': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'engineVersion': {'type': 'string'}, 'formatChecking': {'type': 'boolean'}, 'networkRequestsMade': {'type': 'boolean', 'const': False}}}, 'schemaValid': {'type': 'boolean'}, 'instanceValid': {'type': ['boolean', 'null']}, 'errorsReturned': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'errorCountExact': {'type': 'boolean'}, 'errorsTruncated': {'type': 'boolean'}}, 'additionalProperties': False}}, 'description': 'Structured Structured data contract result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.contract'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.convert
Convert caller-supplied CSV, TSV, JSON, JSON Lines (NDJSON), or YAML with optional root preservation, deterministic integrity hashes, JSON-encoded nested tabular cells, and explicit rejection of ambiguous duplicate keys or non-finite numbers.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'ConvertInput', 'required': ['content', 'format', 'target_format'], 'properties': {'format': {'enum': ['csv', 'tsv', 'json', 'jsonl', 'yaml'], 'type': 'string', 'title': 'Format', 'description': 'Source format; use jsonl for JSON Lines or NDJSON'}, 'content': {'type': 'string', 'title': 'Content', 'maxLength': 2000000}, 'root_mode': {'enum': ['records', 'preserve'], 'type': 'string', 'title': 'Root Mode', 'default': 'records', 'description': 'Normalize the source into record rows, or preserve its parsed root when the target is JSON or YAML'}, 'target_format': {'enum': ['csv', 'tsv', 'json', 'jsonl', 'yaml'], 'type': 'string', 'title': 'Target Format', 'description': 'Target format; use jsonl for JSON Lines or NDJSON'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'rows': {'type': 'integer'}, 'format': {'type': 'string'}, 'content': {'type': 'string'}, 'warnings': {'type': 'array', 'items': {}}, 'conversion': {'type': 'object'}, 'inputSha256': {'type': 'string'}, 'outputSha256': {'type': 'string'}, 'sourceFormat': {'type': 'string'}}, 'description': 'Structured Data conversion result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.convert'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.current-weather
Get one current weather snapshot for a city/locality name or exact coordinates. Returns the nearest NOAA/NWS station observation where available; otherwise returns the latest MET Norway model point, always labeled explicitly as observation or model with bounded SI fields and source provenance.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'oneOf': [{'not': {'anyOf': [{'required': ['latitude']}, {'required': ['longitude']}]}, 'required': ['city']}, {'not': {'required': ['city']}, 'required': ['latitude', 'longitude']}], 'title': 'CurrentWeatherInput', 'properties': {'city': {'anyOf': [{'type': 'string', 'maxLength': 100, 'minLength': 2}, {'type': 'null'}], 'title': 'City', 'default': None, 'examples': ['London, GB'], 'description': 'City or locality name, optionally followed by country and first-level region qualifiers, for example London, GB or Paris, Texas, US. Provide either city or both latitude and longitude.'}, 'latitude': {'anyOf': [{'type': 'number', 'maximum': 90, 'minimum': -90}, {'type': 'null'}], 'title': 'Latitude', 'default': None, 'examples': [38.8977], 'description': 'Latitude in decimal degrees, rounded to four decimal places. Provide with longitude instead of city.'}, 'longitude': {'anyOf': [{'type': 'number', 'maximum': 180, 'minimum': -180}, {'type': 'null'}], 'title': 'Longitude', 'default': None, 'examples': [-77.0365], 'description': 'Longitude in decimal degrees, rounded to four decimal places. Provide with latitude instead of city.'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['location', 'current', 'source', 'retrievedAt', 'cacheTtlSeconds', 'limitations'], 'properties': {'source': {'type': 'object', 'required': ['provider', 'dataset', 'dataKind', 'stationId', 'stationName', 'sourceUrl', 'pointsUrl', 'documentationUrl', 'termsUrl', 'licenseUrl', 'modelRunUpdatedAt', 'fallbackReason', 'upstreamAccess', 'attribution', 'transformation'], 'properties': {'dataset': {'enum': ['NWS nearest-station latest observation', 'Locationforecast 2.0 latest model point'], 'type': 'string'}, 'dataKind': {'enum': ['observation', 'model'], 'type': 'string'}, 'provider': {'enum': ['NOAA/National Weather Service', 'MET Norway'], 'type': 'string'}, 'termsUrl': {'enum': ['https://www.weather.gov/disclaimer', 'https://docs.api.met.no/doc/TermsOfService.html'], 'type': 'string'}, 'pointsUrl': {'anyOf': [{'type': 'string', 'format': 'uri', 'pattern': '^https://api\\.weather\\.gov/points/'}, {'type': 'null'}]}, 'sourceUrl': {'type': 'string', 'format': 'uri', 'pattern': '^https://(?:api\\.weather\\.gov/stations/[A-Z0-9]{3,10}/observations/latest|api\\.met\\.no/weatherapi/locationforecast/2\\.0/compact)'}, 'stationId': {'type': ['string', 'null'], 'pattern': '^[A-Z0-9]{3,10}$'}, 'licenseUrl': {'enum': ['https://docs.api.met.no/doc/License.html', None], 'type': ['string', 'null']}, 'attribution': {'type': 'string', 'maxLength': 1000, 'minLength': 1}, 'stationName': {'type': ['string', 'null'], 'maxLength': 200}, 'fallbackReason': {'enum': ['nws_not_applicable_to_resolved_place', 'outside_nws_coverage', 'nws_temporarily_unavailable', 'nws_observation_unavailable', None], 'type': ['string', 'null']}, 'transformation': {'type': 'string', 'maxLength': 1000, 'minLength': 1}, 'upstreamAccess': {'enum': ['free open data', 'open data under NLOD 2.0 and CC BY 4.0'], 'type': 'string'}, 'documentationUrl': {'enum': ['https://www.weather.gov/documentation/services-web-api', 'https://api.met.no/weatherapi/locationforecast/2.0/documentation'], 'type': 'string'}, 'modelRunUpdatedAt': {'type': ['string', 'null'], 'format': 'date-time'}}, 'additionalProperties': False}, 'current': {'type': 'object', 'required': ['dataKind', 'effectiveAt', 'condition', 'conditionCode', 'temperatureC', 'dewpointC', 'relativeHumidityPercent', 'windSpeedMps', 'windGustMps', 'windFromDirectionDegrees', 'visibilityM', 'airPressureHpa', 'cloudAreaFractionPercent', 'precipitationAmountMm', 'precipitationPeriodHours'], 'properties': {'dataKind': {'enum': ['observation', 'model'], 'type': 'string'}, 'condition': {'type': ['string', 'null'], 'maxLength': 300}, 'dewpointC': {'type': ['number', 'null'], 'maximum': 70, 'minimum': -120}, 'effectiveAt': {'type': 'string', 'format': 'date-time'}, 'visibilityM': {'type': ['number', 'null'], 'maximum': 1000000, 'minimum': 0}, 'windGustMps': {'type': ['number', 'null'], 'maximum': 200, 'minimum': 0}, 'temperatureC': {'type': 'number', 'maximum': 70, 'minimum': -120}, 'windSpeedMps': {'type': ['number', 'null'], 'maximum': 200, 'minimum': 0}, 'conditionCode': {'type': ['string', 'null'], 'pattern': '^[a-z][a-z0-9_]{0,63}$'}, 'airPressureHpa': {'type': ['number', 'null'], 'maximum': 1200, 'minimum': 800}, 'precipitationAmountMm': {'type': ['number', 'null'], 'maximum': 2000, 'minimum': 0}, 'relativeHumidityPercent': {'type': ['number', 'null'], 'maximum': 100, 'minimum': 0}, 'cloudAreaFractionPercent': {'type': ['number', 'null'], 'maximum': 100, 'minimum': 0}, 'precipitationPeriodHours': {'enum': [1, 6, 12, None], 'type': ['integer', 'null']}, 'windFromDirectionDegrees': {'type': ['number', 'null'], 'maximum': 360, 'minimum': 0}}, 'additionalProperties': False}, 'location': {'type': 'object', 'required': ['latitude', 'longitude', 'city', 'state', 'timezone', 'grid', 'resolvedPlace'], 'properties': {'city': {'type': ['string', 'null'], 'maxLength': 200}, 'grid': {'type': 'null'}, 'state': {'type': ['string', 'null'], 'maxLength': 100}, 'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'timezone': {'type': ['string', 'null'], 'maxLength': 100}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180}, 'resolvedPlace': {'anyOf': [{'type': 'object', 'required': ['query', 'geonameId', 'name', 'countryCode', 'admin1Code', 'candidateCount', 'ambiguous', 'attribution', 'licenseUrl'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'query': {'type': 'string', 'maxLength': 100, 'minLength': 2}, 'ambiguous': {'type': 'boolean'}, 'geonameId': {'type': 'integer', 'minimum': 1}, 'admin1Code': {'type': ['string', 'null'], 'maxLength': 20}, 'licenseUrl': {'type': 'string', 'const': 'https://creativecommons.org/licenses/by/4.0/'}, 'attribution': {'type': 'string', 'const': 'GeoNames (CC BY 4.0; https://www.geonames.org/).'}, 'countryCode': {'type': 'string', 'pattern': '^[A-Z]{2}$'}, 'candidateCount': {'type': 'integer', 'maximum': 1000, 'minimum': 1}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'maxItems': 4, 'minItems': 4}, 'retrievedAt': {'type': 'string', 'format': 'date-time'}, 'cacheTtlSeconds': {'type': 'integer', 'const': 900}}, 'description': 'Structured Current weather snapshot result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.current-weather'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.deduplicate
Remove duplicate CSV, TSV, JSON, JSON Lines, or YAML records using selected identity fields and report the removed count.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'DedupeInput', 'required': ['content', 'format'], 'properties': {'keep': {'enum': ['first', 'last'], 'type': 'string', 'title': 'Keep', 'default': 'first'}, 'keys': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Keys', 'maxItems': 20}, 'format': {'enum': ['csv', 'tsv', 'json', 'jsonl', 'yaml'], 'type': 'string', 'title': 'Format', 'description': 'Source format; use jsonl for JSON Lines or NDJSON'}, 'content': {'type': 'string', 'title': 'Content', 'maxLength': 2000000}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'keys': {'type': 'array', 'items': {}}, 'records': {'type': 'array', 'items': {}}, 'removed': {'type': 'integer'}, 'inputRows': {'type': 'integer'}, 'outputRows': {'type': 'integer'}}, 'description': 'Structured Record deduplication result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.deduplicate'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.ecb-fx-reference
Convert an amount between two supported currencies using one validated ECB daily reference-rate observation. The underlying ECB statistics are available free from the ECB Data Portal; the fee covers bounded retrieval, validation, clearly labelled cross-rate calculation, and x402 delivery.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'EcbFxReferenceInput', 'required': ['base_currency', 'quote_currency'], 'properties': {'amount': {'type': 'string', 'title': 'Amount', 'default': '1', 'pattern': '^(?:0|[1-9][0-9]{0,14})(?:\\.[0-9]{1,8})?$', 'examples': ['100'], 'maxLength': 24, 'minLength': 1, 'description': 'Positive decimal amount with at most 15 integer and 8 fractional digits'}, 'on_or_before': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}], 'title': 'On Or Before', 'default': None, 'examples': ['2026-08-18'], 'description': 'Optional date whose latest available ECB reference observation is used; omit for the latest available common business day'}, 'base_currency': {'enum': ['AUD', 'BRL', 'CAD', 'CHF', 'CNY', 'CZK', 'DKK', 'EUR', 'GBP', 'HKD', 'HUF', 'IDR', 'ILS', 'INR', 'ISK', 'JPY', 'KRW', 'MXN', 'MYR', 'NOK', 'NZD', 'PHP', 'PLN', 'RON', 'SEK', 'SGD', 'THB', 'TRY', 'USD', 'ZAR'], 'type': 'string', 'title': 'Base Currency', 'examples': ['GBP'], 'maxLength': 3, 'minLength': 3, 'description': 'Three-letter currency converted from, for example GBP'}, 'quote_currency': {'enum': ['AUD', 'BRL', 'CAD', 'CHF', 'CNY', 'CZK', 'DKK', 'EUR', 'GBP', 'HKD', 'HUF', 'IDR', 'ILS', 'INR', 'ISK', 'JPY', 'KRW', 'MXN', 'MYR', 'NOK', 'NZD', 'PHP', 'PLN', 'RON', 'SEK', 'SGD', 'THB', 'TRY', 'USD', 'ZAR'], 'type': 'string', 'title': 'Quote Currency', 'examples': ['USD'], 'maxLength': 3, 'minLength': 3, 'description': 'Three-letter currency converted to, for example USD'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['baseCurrency', 'quoteCurrency', 'amount', 'rate', 'inverseRate', 'convertedAmount', 'referenceDate', 'requestedOnOrBefore', 'referenceLagDays', 'basis', 'source', 'retrievedAt', 'networkRequestsMade', 'warnings', 'limitations', 'disclaimer'], 'properties': {'rate': {'type': 'string', 'pattern': '^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$', 'maxLength': 40}, 'basis': {'type': 'object', 'required': ['denomination', 'basePerEur', 'quotePerEur', 'formula', 'crossRateDerivedByApiAcre', 'rounding'], 'properties': {'formula': {'type': 'string', 'const': 'quotePerEur / basePerEur'}, 'rounding': {'type': 'string', 'const': 'half-even; rate 12 decimal places, converted amount 8 decimal places'}, 'basePerEur': {'type': 'string', 'pattern': '^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$', 'maxLength': 40}, 'quotePerEur': {'type': 'string', 'pattern': '^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$', 'maxLength': 40}, 'denomination': {'type': 'string', 'const': 'EUR'}, 'crossRateDerivedByApiAcre': {'type': 'boolean'}}, 'additionalProperties': False}, 'amount': {'type': 'string', 'pattern': '^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$', 'maxLength': 24}, 'source': {'type': 'object', 'required': ['provider', 'dataset', 'seriesKeys', 'requestUrl', 'documentationUrl', 'reusePolicyUrl', 'disclaimerUrl', 'attribution', 'freeSourceNotice', 'statisticsModified', 'derivedValuesClearlyLabelled'], 'properties': {'dataset': {'type': 'string', 'const': 'EXR daily euro foreign exchange reference rates'}, 'provider': {'type': 'string', 'const': 'European Central Bank'}, 'requestUrl': {'type': 'string', 'format': 'uri', 'pattern': '^https://data-api\\.ecb\\.europa\\.eu/service/data/EXR/'}, 'seriesKeys': {'type': 'array', 'items': {'type': 'string', 'pattern': '^EXR\\.D\\.[A-Z]{3}\\.EUR\\.SP00\\.A$'}, 'maxItems': 2, 'minItems': 1, 'uniqueItems': True}, 'attribution': {'type': 'string', 'const': 'Source: ECB statistics.'}, 'disclaimerUrl': {'type': 'string', 'const': 'https://www.ecb.europa.eu/services/using-our-site/disclaimer/html/index.en.html'}, 'reusePolicyUrl': {'type': 'string', 'const': 'https://www.ecb.europa.eu/stats/ecb_statistics/governance_and_quality_framework/html/usage_policy.en.html'}, 'documentationUrl': {'type': 'string', 'const': 'https://data.ecb.europa.eu/help/api/data-examples'}, 'freeSourceNotice': {'type': 'string', 'maxLength': 500, 'minLength': 100}, 'statisticsModified': {'type': 'boolean', 'const': False}, 'derivedValuesClearlyLabelled': {'type': 'boolean', 'const': True}}, 'additionalProperties': False}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'maxItems': 2}, 'disclaimer': {'type': 'string', 'const': 'Reference data only, not financial advice or a guarantee of an available exchange rate. Source: ECB statistics.'}, 'inverseRate': {'type': 'string', 'pattern': '^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$', 'maxLength': 40}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'maxItems': 4, 'minItems': 4}, 'retrievedAt': {'type': 'string', 'format': 'date-time'}, 'baseCurrency': {'enum': ['AUD', 'BRL', 'CAD', 'CHF', 'CNY', 'CZK', 'DKK', 'EUR', 'GBP', 'HKD', 'HUF', 'IDR', 'ILS', 'INR', 'ISK', 'JPY', 'KRW', 'MXN', 'MYR', 'NOK', 'NZD', 'PHP', 'PLN', 'RON', 'SEK', 'SGD', 'THB', 'TRY', 'USD', 'ZAR'], 'type': 'string'}, 'quoteCurrency': {'enum': ['AUD', 'BRL', 'CAD', 'CHF', 'CNY', 'CZK', 'DKK', 'EUR', 'GBP', 'HKD', 'HUF', 'IDR', 'ILS', 'INR', 'ISK', 'JPY', 'KRW', 'MXN', 'MYR', 'NOK', 'NZD', 'PHP', 'PLN', 'RON', 'SEK', 'SGD', 'THB', 'TRY', 'USD', 'ZAR'], 'type': 'string'}, 'referenceDate': {'type': 'string', 'format': 'date'}, 'convertedAmount': {'type': 'string', 'pattern': '^(?:0|[1-9][0-9]*)(?:\\.[0-9]+)?$', 'maxLength': 40}, 'referenceLagDays': {'type': 'integer', 'minimum': 0}, 'networkRequestsMade': {'type': 'integer', 'const': 1}, 'requestedOnOrBefore': {'type': ['string', 'null'], 'format': 'date'}}, 'description': 'Structured ECB reference FX conversion result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.ecb-fx-reference'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.json-repair
Repair caller-supplied malformed JSON by safely removing an outer Markdown fence, comments, single-quoted strings, unquoted identifier keys, Python literals, and trailing commas, with transformation hashes and strict rejection of duplicate keys or non-finite numbers.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'JsonRepairInput', 'required': ['content'], 'properties': {'content': {'type': 'string', 'title': 'Content', 'maxLength': 1000000, 'minLength': 1}, 'repairs': {'type': 'array', 'items': {'enum': ['markdown_fence', 'comments', 'single_quoted_strings', 'unquoted_keys', 'python_literals', 'trailing_commas'], 'type': 'string'}, 'title': 'Repairs', 'maxItems': 6, 'minItems': 1, 'description': 'Safe repair classes to permit; service execution order is fixed and deterministic'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'error': {'type': ['string', 'null']}, 'valid': {'type': 'boolean'}, 'repair': {'type': 'object'}, 'content': {'type': 'string'}, 'repaired': {'type': 'boolean'}, 'warnings': {'type': 'array', 'items': {}}, 'validInput': {'type': 'boolean'}, 'inputSha256': {'type': 'string'}, 'outputSha256': {'type': 'string'}, 'attemptSha256': {'type': 'string'}, 'appliedRepairs': {'type': 'array', 'items': {}}}, 'description': 'Structured Deterministic JSON repair result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.json-repair'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.place-geocode
Resolve one global city or locality name into bounded, population-ranked GeoNames coordinates, country and first-level-region identity, population, timezone, feature code, and source freshness without a request-time network call.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'PlaceGeocodeInput', 'required': ['place'], 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 5, 'maximum': 10, 'minimum': 1, 'description': 'Maximum number of population-ranked exact-name candidates to return.'}, 'place': {'type': 'string', 'title': 'Place', 'examples': ['London, GB'], 'maxLength': 100, 'minLength': 2, 'description': "City or locality name with optional comma-separated country or first-level region qualifiers. Examples: 'London, GB' or 'Paris, Texas, US'. This is not a street-address, parcel, point-of-interest, or routing lookup."}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['version', 'query', 'candidateCount', 'candidateCountCapped', 'ambiguous', 'resultsTruncated', 'results', 'source', 'limitations'], 'properties': {'query': {'type': 'object', 'required': ['place', 'normalized', 'limit'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1}, 'place': {'type': 'string', 'maxLength': 100, 'minLength': 2}, 'normalized': {'type': 'string', 'maxLength': 100, 'minLength': 1}}, 'additionalProperties': False}, 'source': {'type': 'object', 'required': ['provider', 'dataset', 'snapshotBuiltOn', 'placeRecords', 'aliasRecords', 'homeUrl', 'downloadUrl', 'license', 'licenseUrl', 'attribution', 'transformation', 'networkRequestsMade'], 'properties': {'dataset': {'type': 'string', 'const': 'GeoNames cities500'}, 'homeUrl': {'type': 'string', 'const': 'https://www.geonames.org/'}, 'license': {'type': 'string', 'const': 'CC BY 4.0'}, 'provider': {'type': 'string', 'const': 'GeoNames'}, 'licenseUrl': {'type': 'string', 'const': 'https://creativecommons.org/licenses/by/4.0/'}, 'attribution': {'type': 'string', 'const': 'GeoNames (CC BY 4.0; https://www.geonames.org/).'}, 'downloadUrl': {'type': 'string', 'const': 'https://download.geonames.org/export/dump/'}, 'aliasRecords': {'type': 'integer', 'const': 766415}, 'placeRecords': {'type': 'integer', 'const': 235408}, 'transformation': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'snapshotBuiltOn': {'type': 'string', 'const': '2026-08-18'}, 'networkRequestsMade': {'type': 'integer', 'const': 0}}, 'additionalProperties': False}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['rank', 'geonameId', 'name', 'matchedNameType', 'country', 'admin1', 'coordinates', 'population', 'timezone', 'featureCode', 'modifiedOn'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'rank': {'type': 'integer', 'maximum': 10, 'minimum': 1}, 'admin1': {'anyOf': [{'type': 'object', 'required': ['code', 'name'], 'properties': {'code': {'type': 'string', 'maxLength': 20, 'minLength': 1}, 'name': {'type': ['string', 'null'], 'maxLength': 200}}, 'additionalProperties': False}, {'type': 'null'}]}, 'country': {'type': 'object', 'required': ['code', 'name', 'iso3', 'continentCode'], 'properties': {'code': {'type': 'string', 'pattern': '^[A-Z]{2}$'}, 'iso3': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'continentCode': {'type': 'string', 'pattern': '^[A-Z]{2}$'}}, 'additionalProperties': False}, 'timezone': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'geonameId': {'type': 'integer', 'minimum': 1}, 'modifiedOn': {'type': 'string', 'format': 'date'}, 'population': {'type': 'integer', 'minimum': 0}, 'coordinates': {'type': 'object', 'required': ['latitude', 'longitude'], 'properties': {'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180}}, 'additionalProperties': False}, 'featureCode': {'type': 'string', 'pattern': '^PPL[A-Z0-9]*$', 'maxLength': 10}, 'matchedNameType': {'enum': ['primary', 'ascii', 'alternate'], 'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 10, 'minItems': 1}, 'version': {'type': 'string', 'const': 'apiacre-place-geocode/1'}, 'ambiguous': {'type': 'boolean'}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'maxItems': 5, 'minItems': 5}, 'candidateCount': {'type': 'integer', 'maximum': 1000, 'minimum': 1}, 'resultsTruncated': {'type': 'boolean'}, 'candidateCountCapped': {'type': 'boolean'}}, 'description': 'Structured Global place geocode result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.place-geocode'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.profile
Profile CSV, TSV, JSON, JSON Lines, or YAML records for field types, nulls, uniqueness, and representative samples.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'DataInput', 'required': ['content', 'format'], 'properties': {'format': {'enum': ['csv', 'tsv', 'json', 'jsonl', 'yaml'], 'type': 'string', 'title': 'Format', 'description': 'Source format; use jsonl for JSON Lines or NDJSON'}, 'content': {'type': 'string', 'title': 'Content', 'maxLength': 2000000}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'rows': {'type': 'integer'}, 'columns': {'type': 'integer'}, 'profile': {'type': 'object'}}, 'description': 'Structured Dataset profile result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.profile'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.reverse-geocode
Resolve one latitude/longitude pair into bounded, great-circle-distance-ranked nearby GeoNames populated places with country, first-level region, population, timezone, feature code, and source freshness without a request-time network call.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'ReverseGeocodeInput', 'required': ['latitude', 'longitude'], 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 5, 'maximum': 10, 'minimum': 1, 'description': 'Maximum number of nearest populated places to return.'}, 'latitude': {'type': 'number', 'title': 'Latitude', 'maximum': 90, 'minimum': -90, 'examples': [51.5074], 'description': 'Latitude in decimal degrees.'}, 'longitude': {'type': 'number', 'title': 'Longitude', 'maximum': 180, 'minimum': -180, 'examples': [-0.1278], 'description': 'Longitude in decimal degrees.'}, 'radius_km': {'type': 'number', 'title': 'Radius Km', 'default': 100, 'maximum': 500, 'minimum': 1, 'description': 'Maximum great-circle distance in kilometres to search for populated places.'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['version', 'query', 'candidateCount', 'matched', 'resultsTruncated', 'results', 'source', 'limitations'], 'properties': {'query': {'type': 'object', 'required': ['latitude', 'longitude', 'radiusKm', 'limit'], 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1}, 'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'radiusKm': {'type': 'number', 'maximum': 500, 'minimum': 1}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180}}, 'additionalProperties': False}, 'source': {'type': 'object', 'required': ['provider', 'dataset', 'snapshotBuiltOn', 'placeRecords', 'aliasRecords', 'homeUrl', 'downloadUrl', 'license', 'licenseUrl', 'attribution', 'transformation', 'networkRequestsMade'], 'properties': {'dataset': {'type': 'string', 'const': 'GeoNames cities500'}, 'homeUrl': {'type': 'string', 'const': 'https://www.geonames.org/'}, 'license': {'type': 'string', 'const': 'CC BY 4.0'}, 'provider': {'type': 'string', 'const': 'GeoNames'}, 'licenseUrl': {'type': 'string', 'const': 'https://creativecommons.org/licenses/by/4.0/'}, 'attribution': {'type': 'string', 'const': 'GeoNames (CC BY 4.0; https://www.geonames.org/).'}, 'downloadUrl': {'type': 'string', 'const': 'https://download.geonames.org/export/dump/'}, 'aliasRecords': {'type': 'integer', 'const': 766415}, 'placeRecords': {'type': 'integer', 'const': 235408}, 'transformation': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'snapshotBuiltOn': {'type': 'string', 'const': '2026-08-18'}, 'networkRequestsMade': {'type': 'integer', 'const': 0}}, 'additionalProperties': False}, 'matched': {'type': 'boolean'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['rank', 'geonameId', 'name', 'country', 'admin1', 'coordinates', 'population', 'timezone', 'featureCode', 'modifiedOn', 'distanceKm'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'rank': {'type': 'integer', 'maximum': 10, 'minimum': 1}, 'admin1': {'anyOf': [{'type': 'object', 'required': ['code', 'name'], 'properties': {'code': {'type': 'string', 'maxLength': 20, 'minLength': 1}, 'name': {'type': ['string', 'null'], 'maxLength': 200}}, 'additionalProperties': False}, {'type': 'null'}]}, 'country': {'type': 'object', 'required': ['code', 'name', 'iso3', 'continentCode'], 'properties': {'code': {'type': 'string', 'pattern': '^[A-Z]{2}$'}, 'iso3': {'type': 'string', 'pattern': '^[A-Z]{3}$'}, 'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'continentCode': {'type': 'string', 'pattern': '^[A-Z]{2}$'}}, 'additionalProperties': False}, 'timezone': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'geonameId': {'type': 'integer', 'minimum': 1}, 'distanceKm': {'type': 'number', 'maximum': 500, 'minimum': 0}, 'modifiedOn': {'type': 'string', 'format': 'date'}, 'population': {'type': 'integer', 'minimum': 0}, 'coordinates': {'type': 'object', 'required': ['latitude', 'longitude'], 'properties': {'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180}}, 'additionalProperties': False}, 'featureCode': {'type': 'string', 'pattern': '^PPL[A-Z0-9]*$', 'maxLength': 10}}, 'additionalProperties': False}, 'maxItems': 10, 'minItems': 0}, 'version': {'type': 'string', 'const': 'apiacre-reverse-geocode/1'}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'maxItems': 5, 'minItems': 5}, 'candidateCount': {'type': 'integer', 'maximum': 235408, 'minimum': 0}, 'resultsTruncated': {'type': 'boolean'}}, 'description': 'Structured Global reverse geocode result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.reverse-geocode'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.schema
Create and generate a nested JSON Schema Draft 2020-12 contract by inferring field types and required fields from representative JSON, CSV, TSV, JSON Lines, or YAML records, with equivalent CSV/TSV numeric and null inference, input evidence, and non-enforcing observed bounds.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'SchemaInput', 'required': ['content', 'format'], 'properties': {'format': {'enum': ['csv', 'tsv', 'json', 'jsonl', 'yaml'], 'type': 'string', 'title': 'Format', 'description': 'Source format; use jsonl for JSON Lines or NDJSON'}, 'content': {'type': 'string', 'title': 'Content', 'maxLength': 2000000}, 'root_mode': {'enum': ['records', 'preserve'], 'type': 'string', 'title': 'Root Mode', 'default': 'records', 'description': 'Keep the compatible array-of-records contract, or preserve the JSON/YAML root shape'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'input': {'type': 'object'}, 'schema': {'type': 'object'}, 'inference': {'type': 'object'}}, 'description': 'Structured JSON Schema generator result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.schema'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.schemaorg-normalize
Normalize caller-supplied inline Schema.org JSON-LD into deterministic Organization, Product, Service, Article, and Event entities with privacy scrubbing and field-level evidence hashes.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'SchemaOrgNormalizeInput', 'required': ['html'], 'properties': {'html': {'type': 'string', 'title': 'Html', 'maxLength': 500000, 'minLength': 1, 'description': 'HTML containing Schema.org JSON-LD script blocks, or a raw JSON-LD object or array.'}, 'base_url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}], 'title': 'Base Url', 'default': None}, 'include_types': {'type': 'array', 'items': {'enum': ['Organization', 'Product', 'Service', 'Article', 'Event'], 'type': 'string'}, 'title': 'Include Types', 'maxItems': 5, 'minItems': 1}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'nodes': {'type': 'array', 'items': {}}, 'warnings': {'type': 'array', 'items': {}}, 'conflicts': {'type': 'array', 'items': {}}, 'nodesSeen': {'type': 'integer'}, 'typeCounts': {'type': 'object'}, 'vocabulary': {'type': 'object'}, 'scriptsSeen': {'type': 'integer'}, 'nodesReturned': {'type': 'integer'}, 'documentSha256': {'type': 'string'}}, 'description': 'Structured Schema.org JSON-LD normalization result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.schemaorg-normalize'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.schema-validate
Validate JSON data against a bounded JSON Schema Draft 2020-12 contract for nested objects, arrays, required properties, types, enums, formats, lengths, patterns, and numeric bounds; return deterministic instance and schema JSON Pointers, explicit error truncation, input hashes, and no remote reference resolution.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'SchemaValidateInput', 'required': ['schema', 'instance'], 'properties': {'schema': {'type': 'object', 'title': 'Schema', 'description': 'JSON Schema Draft 2020-12 document; only local fragment references are allowed', 'additionalProperties': True}, 'instance': {'title': 'Instance', 'description': 'JSON-compatible value to validate'}, 'max_errors': {'type': 'integer', 'title': 'Max Errors', 'default': 25, 'maximum': 100, 'minimum': 1}, 'check_formats': {'type': 'boolean', 'title': 'Check Formats', 'default': True, 'description': 'Assert supported JSON Schema formats as well as structural keywords'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'valid': {'type': 'boolean'}, 'errors': {'type': 'array', 'items': {'type': 'object', 'required': ['kind', 'instancePath', 'schemaPath', 'keyword', 'message'], 'properties': {'kind': {'enum': ['schema', 'instance'], 'type': 'string'}, 'keyword': {'type': ['string', 'null']}, 'message': {'type': 'string', 'maxLength': 500}, 'schemaPath': {'type': 'string'}, 'instancePath': {'type': ['string', 'null']}}}, 'maxItems': 100}, 'schema': {'type': 'object', 'required': ['dialect', 'declaredDialect', 'utf8Bytes', 'sha256', 'remoteReferencesAllowed'], 'properties': {'sha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'dialect': {'type': 'string', 'const': 'https://json-schema.org/draft/2020-12/schema'}, 'utf8Bytes': {'type': 'integer', 'maximum': 500000, 'minimum': 2}, 'declaredDialect': {'type': ['string', 'null']}, 'remoteReferencesAllowed': {'type': 'boolean', 'const': False}}}, 'instance': {'type': 'object', 'required': ['utf8Bytes', 'sha256'], 'properties': {'sha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'utf8Bytes': {'type': 'integer', 'maximum': 1000000, 'minimum': 1}}}, 'errorCount': {'type': 'integer', 'maximum': 101, 'minimum': 0}, 'validation': {'type': 'object', 'required': ['engine', 'engineVersion', 'draft', 'formatChecking', 'maxErrors', 'networkRequestsMade'], 'properties': {'draft': {'type': 'string', 'const': '2020-12'}, 'engine': {'type': 'string', 'const': 'python-jsonschema'}, 'maxErrors': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'engineVersion': {'type': 'string'}, 'formatChecking': {'type': 'boolean'}, 'networkRequestsMade': {'type': 'boolean', 'const': False}}}, 'schemaValid': {'type': 'boolean'}, 'instanceValid': {'type': ['boolean', 'null']}, 'errorsReturned': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'errorCountExact': {'type': 'boolean'}, 'errorsTruncated': {'type': 'boolean'}}, 'description': 'Structured JSON Schema validation result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.schema-validate'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.timezone-convert
Convert an offset-aware ISO 8601 instant or a local wall time between IANA time zones with explicit DST gap and repeated-hour handling, nearby transition evidence, and a pinned local time-zone database.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'TimezoneConvertInput', 'required': ['timestamp', 'target_timezone'], 'properties': {'timestamp': {'type': 'string', 'title': 'Timestamp', 'examples': ['2026-11-01T01:30:00'], 'maxLength': 40, 'minLength': 16, 'description': 'ISO 8601 timestamp. Include Z or an offset for an exact instant, or provide a naive local timestamp together with source_timezone.'}, 'ambiguous_time': {'enum': ['reject', 'earlier', 'later'], 'type': 'string', 'title': 'Ambiguous Time', 'default': 'reject', 'description': 'How to resolve a repeated local wall time during a backward DST transition; nonexistent spring-forward times are always rejected'}, 'source_timezone': {'anyOf': [{'type': 'string', 'maxLength': 100, 'minLength': 1}, {'type': 'null'}], 'title': 'Source Timezone', 'default': None, 'examples': ['America/New_York'], 'description': 'Required for a timestamp without an offset; optional source display zone for an offset-aware timestamp'}, 'target_timezone': {'type': 'string', 'title': 'Target Timezone', 'examples': ['Europe/London'], 'maxLength': 100, 'minLength': 1, 'description': 'Target IANA time-zone name, for example Europe/London'}, 'include_transitions': {'type': 'boolean', 'title': 'Include Transitions', 'default': True, 'description': 'Include previous and next offset transitions within 370 days'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['input', 'interpretation', 'instant', 'source', 'target', 'offsetDifferenceSeconds', 'transitions', 'database', 'limitations'], 'properties': {'input': {'type': 'object', 'required': ['timestamp', 'offsetAware', 'inputOffset', 'sourceTimezone', 'targetTimezone', 'ambiguousTime'], 'properties': {'timestamp': {'type': 'string', 'maxLength': 40, 'minLength': 16}, 'inputOffset': {'type': ['string', 'null'], 'pattern': '^[+-][0-9]{2}:[0-9]{2}(?::[0-9]{2})?$'}, 'offsetAware': {'type': 'boolean'}, 'ambiguousTime': {'enum': ['reject', 'earlier', 'later'], 'type': 'string'}, 'sourceTimezone': {'type': ['string', 'null'], 'maxLength': 100}, 'targetTimezone': {'type': 'string', 'maxLength': 100, 'minLength': 1}}, 'additionalProperties': False}, 'source': {'type': 'object', 'required': ['timezone', 'isIana', 'localTime', 'utcOffset', 'utcOffsetSeconds', 'abbreviation', 'isDst', 'dstOffsetSeconds', 'fold'], 'properties': {'fold': {'enum': [0, 1], 'type': 'integer'}, 'isDst': {'type': 'boolean'}, 'isIana': {'type': 'boolean'}, 'timezone': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'localTime': {'type': 'string', 'format': 'date-time', 'maxLength': 40}, 'utcOffset': {'type': 'string', 'pattern': '^[+-][0-9]{2}:[0-9]{2}(?::[0-9]{2})?$'}, 'abbreviation': {'type': ['string', 'null'], 'maxLength': 40}, 'dstOffsetSeconds': {'type': 'integer', 'maximum': 86399, 'minimum': -86399}, 'utcOffsetSeconds': {'type': 'integer', 'maximum': 86399, 'minimum': -86399}}, 'additionalProperties': False}, 'target': {'type': 'object', 'required': ['timezone', 'isIana', 'localTime', 'utcOffset', 'utcOffsetSeconds', 'abbreviation', 'isDst', 'dstOffsetSeconds', 'fold'], 'properties': {'fold': {'enum': [0, 1], 'type': 'integer'}, 'isDst': {'type': 'boolean'}, 'isIana': {'type': 'boolean'}, 'timezone': {'type': 'string', 'maxLength': 100, 'minLength': 1}, 'localTime': {'type': 'string', 'format': 'date-time', 'maxLength': 40}, 'utcOffset': {'type': 'string', 'pattern': '^[+-][0-9]{2}:[0-9]{2}(?::[0-9]{2})?$'}, 'abbreviation': {'type': ['string', 'null'], 'maxLength': 40}, 'dstOffsetSeconds': {'type': 'integer', 'maximum': 86399, 'minimum': -86399}, 'utcOffsetSeconds': {'type': 'integer', 'maximum': 86399, 'minimum': -86399}}, 'additionalProperties': False}, 'instant': {'type': 'object', 'required': ['utc', 'unixSeconds', 'unixMilliseconds'], 'properties': {'utc': {'type': 'string', 'format': 'date-time', 'maxLength': 40}, 'unixSeconds': {'type': 'integer'}, 'unixMilliseconds': {'type': 'integer'}}, 'additionalProperties': False}, 'database': {'type': 'object', 'required': ['provider', 'ianaRelease', 'tzdataPackageVersion', 'databaseUrl', 'databaseLicenseUrl', 'packageUrl', 'packageLicenseUrl', 'license', 'upstreamAccess'], 'properties': {'license': {'type': 'string', 'maxLength': 200}, 'provider': {'type': 'string', 'const': 'IANA Time Zone Database'}, 'packageUrl': {'type': 'string', 'const': 'https://github.com/python/tzdata'}, 'databaseUrl': {'type': 'string', 'const': 'https://www.iana.org/time-zones'}, 'ianaRelease': {'type': 'string', 'const': '2026c'}, 'upstreamAccess': {'type': 'string', 'const': 'none; conversion uses the bundled pinned tzdata package'}, 'packageLicenseUrl': {'type': 'string', 'const': 'https://github.com/python/tzdata/blob/master/LICENSE'}, 'databaseLicenseUrl': {'type': 'string', 'const': 'https://github.com/eggert/tz/blob/main/LICENSE'}, 'tzdataPackageVersion': {'type': 'string', 'const': '2026.3'}}, 'additionalProperties': False}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 300}, 'maxItems': 4, 'minItems': 4}, 'transitions': {'anyOf': [{'type': 'object', 'required': ['source', 'target'], 'properties': {'source': {'anyOf': [{'type': 'object', 'required': ['previous', 'next'], 'properties': {'next': {'anyOf': [{'type': 'object', 'required': ['atUtc', 'localBefore', 'localAfter', 'offsetBeforeSeconds', 'offsetAfterSeconds', 'changeSeconds'], 'properties': {'atUtc': {'type': 'string', 'format': 'date-time', 'maxLength': 40}, 'localAfter': {'type': 'string', 'format': 'date-time', 'maxLength': 40}, 'localBefore': {'type': 'string', 'format': 'date-time', 'maxLength': 40}, 'changeSeconds': {'type': 'integer', 'maximum': 86399, 'minimum': -86399}, 'offsetAfterSeconds': {'type': 'integer', 'maximum': 86399, 'minimum': -86399}, 'offsetBeforeSeconds': {'type': 'integer', 'maximum': 86399, 'minimum': -86399}}, 'additionalProperties': False}, {'type': 'null'}]}, 'previous': {'anyOf': [{'type': 'object', 'required': ['atUtc', 'localBefore', 'localAfter', 'offsetBeforeSeconds', 'offsetAfterSeconds', 'changeSeconds'], 'properties': {'atUtc': {'type': 'string', 'format': 'date-time', 'maxLength': 40}, 'localAfter': {'type': 'string', 'format': 'date-time', 'maxLength': 40}, 'localBefore': {'type': 'string', 'format': 'date-time', 'maxLength': 40}, 'changeSeconds': {'type': 'integer', 'maximum': 86399, 'minimum': -86399}, 'offsetAfterSeconds': {'type': 'integer', 'maximum': 86399, 'minimum': -86399}, 'offsetBeforeSeconds': {'type': 'integer', 'maximum': 86399, 'minimum': -86399}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'target': {'type': 'object', 'required': ['previous', 'next'], 'properties': {'next': {'anyOf': [{'type': 'object', 'required': ['atUtc', 'localBefore', 'localAfter', 'offsetBeforeSeconds', 'offsetAfterSeconds', 'changeSeconds'], 'properties': {'atUtc': {'type': 'string', 'format': 'date-time', 'maxLength': 40}, 'localAfter': {'type': 'string', 'format': 'date-time', 'maxLength': 40}, 'localBefore': {'type': 'string', 'format': 'date-time', 'maxLength': 40}, 'changeSeconds': {'type': 'integer', 'maximum': 86399, 'minimum': -86399}, 'offsetAfterSeconds': {'type': 'integer', 'maximum': 86399, 'minimum': -86399}, 'offsetBeforeSeconds': {'type': 'integer', 'maximum': 86399, 'minimum': -86399}}, 'additionalProperties': False}, {'type': 'null'}]}, 'previous': {'anyOf': [{'type': 'object', 'required': ['atUtc', 'localBefore', 'localAfter', 'offsetBeforeSeconds', 'offsetAfterSeconds', 'changeSeconds'], 'properties': {'atUtc': {'type': 'string', 'format': 'date-time', 'maxLength': 40}, 'localAfter': {'type': 'string', 'format': 'date-time', 'maxLength': 40}, 'localBefore': {'type': 'string', 'format': 'date-time', 'maxLength': 40}, 'changeSeconds': {'type': 'integer', 'maximum': 86399, 'minimum': -86399}, 'offsetAfterSeconds': {'type': 'integer', 'maximum': 86399, 'minimum': -86399}, 'offsetBeforeSeconds': {'type': 'integer', 'maximum': 86399, 'minimum': -86399}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}}, 'additionalProperties': False}, {'type': 'null'}]}, 'interpretation': {'type': 'object', 'required': ['status', 'disambiguationApplied'], 'properties': {'status': {'enum': ['offset_aware', 'exact_local', 'ambiguous_earlier', 'ambiguous_later'], 'type': 'string'}, 'disambiguationApplied': {'enum': [None, 'earlier', 'later'], 'type': ['string', 'null']}}, 'additionalProperties': False}, 'offsetDifferenceSeconds': {'type': 'integer', 'maximum': 172798, 'minimum': -172798}}, 'description': 'Structured IANA timezone conversion result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.timezone-convert'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.us-address-geocode
Geocode one structural address in the United States, Puerto Rico, or U.S. Island Areas with normalized U.S. Census MAF/TIGER coordinates, optional bounded state/county/tract/block/congressional geography, exact source attribution, and explicit range-interpolation limits.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'UsAddressGeocodeInput', 'required': ['address'], 'properties': {'address': {'type': 'string', 'title': 'Address', 'examples': ['4600 Silver Hill Rd, Washington, DC 20233'], 'maxLength': 300, 'minLength': 5, 'description': 'One-line structural address in the United States, Puerto Rico, or a U.S. Island Area. Include a building number and street name; city, state, and ZIP improve matching. The address is sent to the U.S. Census Geocoder for this lookup.'}, 'include_geographies': {'type': 'boolean', 'title': 'Include Geographies', 'default': True, 'description': 'Include bounded state, county, tract, block, and current congressional-district fields from the Census geographic lookup.'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['query', 'matched', 'matchCount', 'ambiguous', 'matchesTruncated', 'matches', 'benchmark', 'vintage', 'source', 'retrievedAt', 'limitations'], 'properties': {'query': {'type': 'object', 'required': ['address', 'includeGeographies'], 'properties': {'address': {'type': 'string', 'maxLength': 300, 'minLength': 5}, 'includeGeographies': {'type': 'boolean'}}, 'additionalProperties': False}, 'source': {'type': 'object', 'required': ['provider', 'dataset', 'endpointUrl', 'documentationUrl', 'termsUrl', 'attribution', 'transformation'], 'properties': {'dataset': {'type': 'string', 'const': 'Census Geocoding Services using MAF/TIGER address ranges'}, 'provider': {'type': 'string', 'const': 'U.S. Census Bureau'}, 'termsUrl': {'type': 'string', 'const': 'https://www.census.gov/data/developers/about/terms-of-service.html'}, 'attribution': {'type': 'string', 'const': 'This product uses the Census Bureau Data API but is not endorsed or certified by the Census Bureau.'}, 'endpointUrl': {'enum': ['https://geocoding.geo.census.gov/geocoder/locations/onelineaddress', 'https://geocoding.geo.census.gov/geocoder/geographies/onelineaddress'], 'type': 'string', 'format': 'uri'}, 'transformation': {'type': 'string', 'maxLength': 500}, 'documentationUrl': {'type': 'string', 'const': 'https://geocoding.geo.census.gov/geocoder/Geocoding_Services_API.html'}}, 'additionalProperties': False}, 'matched': {'type': 'boolean'}, 'matches': {'type': 'array', 'items': {'type': 'object', 'required': ['matchedAddress', 'coordinates', 'tigerLine', 'addressComponents', 'geographies'], 'properties': {'tigerLine': {'type': 'object', 'required': ['id', 'side'], 'properties': {'id': {'type': ['string', 'null'], 'maxLength': 40}, 'side': {'type': ['string', 'null'], 'maxLength': 5}}, 'additionalProperties': False}, 'coordinates': {'type': 'object', 'required': ['longitude', 'latitude'], 'properties': {'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180}}, 'additionalProperties': False}, 'geographies': {'type': 'object', 'required': ['requested', 'available', 'state', 'county', 'tract', 'block', 'congressionalDistrict'], 'properties': {'block': {'anyOf': [{'type': 'object', 'required': ['kind', 'name', 'geoid', 'code', 'abbreviation', 'session'], 'properties': {'code': {'type': ['string', 'null'], 'maxLength': 30}, 'kind': {'enum': ['state', 'county', 'census_tract', 'census_block', 'congressional_district'], 'type': 'string'}, 'name': {'type': ['string', 'null'], 'maxLength': 300}, 'geoid': {'type': ['string', 'null'], 'maxLength': 30}, 'session': {'type': ['string', 'null'], 'maxLength': 10}, 'abbreviation': {'type': ['string', 'null'], 'maxLength': 10}}, 'additionalProperties': False}, {'type': 'null'}]}, 'state': {'anyOf': [{'type': 'object', 'required': ['kind', 'name', 'geoid', 'code', 'abbreviation', 'session'], 'properties': {'code': {'type': ['string', 'null'], 'maxLength': 30}, 'kind': {'enum': ['state', 'county', 'census_tract', 'census_block', 'congressional_district'], 'type': 'string'}, 'name': {'type': ['string', 'null'], 'maxLength': 300}, 'geoid': {'type': ['string', 'null'], 'maxLength': 30}, 'session': {'type': ['string', 'null'], 'maxLength': 10}, 'abbreviation': {'type': ['string', 'null'], 'maxLength': 10}}, 'additionalProperties': False}, {'type': 'null'}]}, 'tract': {'anyOf': [{'type': 'object', 'required': ['kind', 'name', 'geoid', 'code', 'abbreviation', 'session'], 'properties': {'code': {'type': ['string', 'null'], 'maxLength': 30}, 'kind': {'enum': ['state', 'county', 'census_tract', 'census_block', 'congressional_district'], 'type': 'string'}, 'name': {'type': ['string', 'null'], 'maxLength': 300}, 'geoid': {'type': ['string', 'null'], 'maxLength': 30}, 'session': {'type': ['string', 'null'], 'maxLength': 10}, 'abbreviation': {'type': ['string', 'null'], 'maxLength': 10}}, 'additionalProperties': False}, {'type': 'null'}]}, 'county': {'anyOf': [{'type': 'object', 'required': ['kind', 'name', 'geoid', 'code', 'abbreviation', 'session'], 'properties': {'code': {'type': ['string', 'null'], 'maxLength': 30}, 'kind': {'enum': ['state', 'county', 'census_tract', 'census_block', 'congressional_district'], 'type': 'string'}, 'name': {'type': ['string', 'null'], 'maxLength': 300}, 'geoid': {'type': ['string', 'null'], 'maxLength': 30}, 'session': {'type': ['string', 'null'], 'maxLength': 10}, 'abbreviation': {'type': ['string', 'null'], 'maxLength': 10}}, 'additionalProperties': False}, {'type': 'null'}]}, 'available': {'type': 'boolean'}, 'requested': {'type': 'boolean'}, 'congressionalDistrict': {'anyOf': [{'type': 'object', 'required': ['kind', 'name', 'geoid', 'code', 'abbreviation', 'session'], 'properties': {'code': {'type': ['string', 'null'], 'maxLength': 30}, 'kind': {'enum': ['state', 'county', 'census_tract', 'census_block', 'congressional_district'], 'type': 'string'}, 'name': {'type': ['string', 'null'], 'maxLength': 300}, 'geoid': {'type': ['string', 'null'], 'maxLength': 30}, 'session': {'type': ['string', 'null'], 'maxLength': 10}, 'abbreviation': {'type': ['string', 'null'], 'maxLength': 10}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}, 'matchedAddress': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'addressComponents': {'type': 'object', 'required': ['fromAddress', 'toAddress', 'preQualifier', 'preDirection', 'preType', 'streetName', 'suffixType', 'suffixDirection', 'suffixQualifier', 'city', 'state', 'zip'], 'properties': {'zip': {'type': ['string', 'null'], 'maxLength': 20}, 'city': {'type': ['string', 'null'], 'maxLength': 200}, 'state': {'type': ['string', 'null'], 'maxLength': 20}, 'preType': {'type': ['string', 'null'], 'maxLength': 50}, 'toAddress': {'type': ['string', 'null'], 'maxLength': 30}, 'streetName': {'type': ['string', 'null'], 'maxLength': 200}, 'suffixType': {'type': ['string', 'null'], 'maxLength': 50}, 'fromAddress': {'type': ['string', 'null'], 'maxLength': 30}, 'preDirection': {'type': ['string', 'null'], 'maxLength': 20}, 'preQualifier': {'type': ['string', 'null'], 'maxLength': 50}, 'suffixDirection': {'type': ['string', 'null'], 'maxLength': 20}, 'suffixQualifier': {'type': ['string', 'null'], 'maxLength': 50}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'maxItems': 5, 'minItems': 0}, 'vintage': {'anyOf': [{'type': 'object', 'required': ['id', 'name', 'description', 'isDefault'], 'properties': {'id': {'type': ['string', 'null'], 'maxLength': 30}, 'name': {'type': ['string', 'null'], 'maxLength': 100}, 'isDefault': {'type': ['boolean', 'null']}, 'description': {'type': ['string', 'null'], 'maxLength': 300}}, 'additionalProperties': False}, {'type': 'null'}]}, 'ambiguous': {'type': 'boolean'}, 'benchmark': {'type': 'object', 'required': ['id', 'name', 'description', 'isDefault'], 'properties': {'id': {'type': ['string', 'null'], 'maxLength': 30}, 'name': {'type': ['string', 'null'], 'maxLength': 100}, 'isDefault': {'type': ['boolean', 'null']}, 'description': {'type': ['string', 'null'], 'maxLength': 300}}, 'additionalProperties': False}, 'matchCount': {'type': 'integer', 'minimum': 0}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 5, 'minItems': 5}, 'retrievedAt': {'type': 'string', 'format': 'date-time'}, 'matchesTruncated': {'type': 'boolean'}}, 'description': 'Structured US address geocode result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.us-address-geocode'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.us-weather-forecast
Get a global weather forecast for a city/locality name or exact coordinates. Returns normalized day/night or hourly periods worldwide: NOAA/NWS is preferred within supported U.S. coverage for optional station conditions and active alerts, while MET Norway provides an attributed open-data fallback globally.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'oneOf': [{'not': {'anyOf': [{'required': ['latitude']}, {'required': ['longitude']}]}, 'required': ['place']}, {'not': {'required': ['place']}, 'required': ['latitude', 'longitude']}], 'title': 'UsWeatherForecastInput', 'properties': {'place': {'anyOf': [{'type': 'string', 'maxLength': 100, 'minLength': 2}, {'type': 'null'}], 'title': 'Place', 'default': None, 'examples': ['London, GB'], 'description': 'City or locality name, optionally followed by country and first-level region qualifiers, for example London, GB or Paris, Texas, US. Provide either place or both latitude and longitude.'}, 'units': {'enum': ['us', 'si'], 'type': 'string', 'title': 'Units', 'default': 'us', 'description': 'US customary or SI units requested from the NWS API'}, 'periods': {'type': 'integer', 'title': 'Periods', 'default': 6, 'maximum': 48, 'minimum': 1, 'description': 'Maximum periods to return; day_night supports at most 14 and hourly at most 48'}, 'latitude': {'anyOf': [{'type': 'number', 'maximum': 90, 'minimum': -90}, {'type': 'null'}], 'title': 'Latitude', 'default': None, 'examples': [38.8977], 'description': 'Latitude in decimal degrees, rounded to four decimal places. Provide with longitude instead of place.'}, 'timezone': {'anyOf': [{'type': 'string', 'maxLength': 100, 'minLength': 1}, {'type': 'null'}], 'title': 'Timezone', 'default': None, 'examples': ['Europe/London'], 'description': 'Optional IANA time zone used to group MET Norway day/night periods. Place-name requests use the matched GeoNames zone; coordinate requests default to UTC; NWS returns its authoritative point time zone.'}, 'longitude': {'anyOf': [{'type': 'number', 'maximum': 180, 'minimum': -180}, {'type': 'null'}], 'title': 'Longitude', 'default': None, 'examples': [-77.0365], 'description': 'Longitude in decimal degrees, rounded to four decimal places. Provide with latitude instead of place.'}, 'forecast_type': {'enum': ['day_night', 'hourly'], 'type': 'string', 'title': 'Forecast Type', 'default': 'day_night', 'description': 'Day/night forecast periods or hourly forecast periods'}, 'source_preference': {'enum': ['auto', 'nws', 'met'], 'type': 'string', 'title': 'Source Preference', 'default': 'auto', 'description': 'Prefer NWS within its U.S. coverage and fall back to MET Norway globally, or explicitly select one source'}, 'include_active_alerts': {'type': 'boolean', 'title': 'Include Active Alerts', 'default': False, 'description': 'Include up to 10 currently active NWS alerts whose affected area contains the requested point'}, 'include_current_conditions': {'type': 'boolean', 'title': 'Include Current Conditions', 'default': False, 'description': 'Include the latest observation from the nearest available NWS station; kept opt-in to preserve baseline latency'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['location', 'forecastType', 'units', 'generatedAt', 'updatedAt', 'periodCount', 'periodsTruncated', 'periods', 'currentConditions', 'activeAlerts', 'source', 'retrievedAt', 'limitations'], 'properties': {'units': {'enum': ['us', 'si'], 'type': 'string'}, 'source': {'type': 'object', 'required': ['provider', 'dataset', 'pointsUrl', 'forecastUrl', 'documentationUrl', 'disclaimerUrl', 'upstreamAccess', 'attribution', 'transformation'], 'properties': {'dataset': {'enum': ['NWS API forecast with optional observations and active alerts', 'Locationforecast 2.0 compact point forecast'], 'type': 'string'}, 'provider': {'enum': ['NOAA/National Weather Service', 'MET Norway'], 'type': 'string'}, 'pointsUrl': {'anyOf': [{'type': 'string', 'format': 'uri', 'pattern': '^https://api\\.weather\\.gov/points/'}, {'type': 'null'}]}, 'attribution': {'type': 'string'}, 'forecastUrl': {'type': 'string', 'format': 'uri', 'pattern': '^https://(?:api\\.weather\\.gov/gridpoints/|api\\.met\\.no/weatherapi/locationforecast/2\\.0/compact)'}, 'disclaimerUrl': {'enum': ['https://www.weather.gov/disclaimer', 'https://docs.api.met.no/doc/TermsOfService.html'], 'type': 'string'}, 'transformation': {'type': 'string'}, 'upstreamAccess': {'enum': ['free open data', 'open data under NLOD 2.0 and CC BY 4.0'], 'type': 'string'}, 'documentationUrl': {'enum': ['https://www.weather.gov/documentation/services-web-api', 'https://api.met.no/weatherapi/locationforecast/2.0/documentation'], 'type': 'string'}}, 'additionalProperties': False}, 'periods': {'type': 'array', 'items': {'type': 'object', 'required': ['number', 'name', 'startTime', 'endTime', 'isDaytime', 'temperature', 'temperatureUnit', 'temperatureTrend', 'probabilityOfPrecipitationPercent', 'relativeHumidityPercent', 'dewpoint', 'windSpeed', 'windDirection', 'shortForecast', 'detailedForecast'], 'properties': {'name': {'type': ['string', 'null'], 'maxLength': 100}, 'number': {'type': ['integer', 'null'], 'minimum': 1}, 'endTime': {'type': ['string', 'null'], 'format': 'date-time'}, 'dewpoint': {'type': ['object', 'null'], 'required': ['value', 'unitCode'], 'properties': {'value': {'type': ['number', 'null']}, 'unitCode': {'type': ['string', 'null'], 'maxLength': 100}}, 'additionalProperties': False}, 'isDaytime': {'type': ['boolean', 'null']}, 'startTime': {'type': ['string', 'null'], 'format': 'date-time'}, 'windSpeed': {'type': ['string', 'null'], 'maxLength': 100}, 'temperature': {'type': ['number', 'null']}, 'shortForecast': {'type': ['string', 'null'], 'maxLength': 300}, 'windDirection': {'type': ['string', 'null'], 'maxLength': 20}, 'temperatureUnit': {'enum': ['F', 'C', None], 'type': ['string', 'null']}, 'detailedForecast': {'type': ['string', 'null'], 'maxLength': 2000}, 'temperatureTrend': {'type': ['string', 'null'], 'maxLength': 50}, 'relativeHumidityPercent': {'type': ['number', 'null'], 'maximum': 100, 'minimum': 0}, 'probabilityOfPrecipitationPercent': {'type': ['number', 'null'], 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}, 'maxItems': 48, 'minItems': 1}, 'location': {'type': 'object', 'required': ['latitude', 'longitude', 'city', 'state', 'timezone', 'grid', 'resolvedPlace'], 'properties': {'city': {'type': ['string', 'null'], 'maxLength': 200}, 'grid': {'type': ['object', 'null'], 'required': ['office', 'x', 'y'], 'properties': {'x': {'type': 'integer'}, 'y': {'type': 'integer'}, 'office': {'type': 'string', 'pattern': '^[A-Z]{3}$'}}, 'additionalProperties': False}, 'state': {'type': ['string', 'null'], 'maxLength': 100}, 'latitude': {'type': 'number', 'maximum': 90, 'minimum': -90}, 'timezone': {'type': ['string', 'null'], 'maxLength': 100}, 'longitude': {'type': 'number', 'maximum': 180, 'minimum': -180}, 'resolvedPlace': {'anyOf': [{'type': 'object', 'required': ['query', 'geonameId', 'name', 'countryCode', 'admin1Code', 'candidateCount', 'ambiguous', 'attribution', 'licenseUrl'], 'properties': {'name': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'query': {'type': 'string', 'maxLength': 100, 'minLength': 2}, 'ambiguous': {'type': 'boolean'}, 'geonameId': {'type': 'integer', 'minimum': 1}, 'admin1Code': {'type': ['string', 'null'], 'maxLength': 20}, 'licenseUrl': {'type': 'string', 'const': 'https://creativecommons.org/licenses/by/4.0/'}, 'attribution': {'type': 'string', 'const': 'GeoNames (CC BY 4.0; https://www.geonames.org/).'}, 'countryCode': {'type': 'string', 'pattern': '^[A-Z]{2}$'}, 'candidateCount': {'type': 'integer', 'maximum': 1000, 'minimum': 1}}, 'additionalProperties': False}, {'type': 'null'}]}}, 'additionalProperties': False}, 'updatedAt': {'type': ['string', 'null'], 'format': 'date-time'}, 'generatedAt': {'type': ['string', 'null'], 'format': 'date-time'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 4, 'minItems': 4}, 'periodCount': {'type': 'integer', 'maximum': 48, 'minimum': 1}, 'retrievedAt': {'type': 'string', 'format': 'date-time'}, 'activeAlerts': {'type': 'object', 'required': ['requested', 'available', 'updatedAt', 'alertCount', 'alertsTruncated', 'alerts', 'sourceUrl', 'warning'], 'properties': {'alerts': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'event', 'headline', 'severity', 'certainty', 'urgency', 'effective', 'onset', 'expires', 'ends', 'sourceUrl'], 'properties': {'id': {'type': ['string', 'null'], 'maxLength': 300}, 'ends': {'type': ['string', 'null'], 'format': 'date-time'}, 'event': {'type': ['string', 'null'], 'maxLength': 200}, 'onset': {'type': ['string', 'null'], 'format': 'date-time'}, 'expires': {'type': ['string', 'null'], 'format': 'date-time'}, 'urgency': {'type': ['string', 'null'], 'maxLength': 50}, 'headline': {'type': ['string', 'null'], 'maxLength': 500}, 'severity': {'type': ['string', 'null'], 'maxLength': 50}, 'certainty': {'type': ['string', 'null'], 'maxLength': 50}, 'effective': {'type': ['string', 'null'], 'format': 'date-time'}, 'sourceUrl': {'type': ['string', 'null'], 'format': 'uri', 'maxLength': 500}}, 'additionalProperties': False}, 'maxItems': 10}, 'warning': {'type': ['string', 'null'], 'maxLength': 500}, 'available': {'type': 'boolean'}, 'requested': {'type': 'boolean'}, 'sourceUrl': {'type': ['string', 'null'], 'format': 'uri', 'maxLength': 500}, 'updatedAt': {'type': ['string', 'null'], 'format': 'date-time'}, 'alertCount': {'type': 'integer', 'maximum': 10, 'minimum': 0}, 'alertsTruncated': {'type': 'boolean'}}, 'additionalProperties': False}, 'forecastType': {'enum': ['day_night', 'hourly'], 'type': 'string'}, 'periodsTruncated': {'type': 'boolean'}, 'currentConditions': {'type': 'object', 'required': ['requested', 'available', 'stationId', 'stationName', 'observedAt', 'description', 'temperature', 'dewpoint', 'relativeHumidityPercent', 'heatIndex', 'windChill', 'windDirection', 'windSpeed', 'windGust', 'visibility', 'sourceUrl', 'warning'], 'properties': {'warning': {'type': ['string', 'null'], 'maxLength': 500}, 'dewpoint': {'type': ['object', 'null'], 'required': ['value', 'unitCode'], 'properties': {'value': {'type': ['number', 'null']}, 'unitCode': {'type': ['string', 'null'], 'maxLength': 100}}, 'additionalProperties': False}, 'windGust': {'type': ['object', 'null'], 'required': ['value', 'unitCode'], 'properties': {'value': {'type': ['number', 'null']}, 'unitCode': {'type': ['string', 'null'], 'maxLength': 100}}, 'additionalProperties': False}, 'available': {'type': 'boolean'}, 'heatIndex': {'type': ['object', 'null'], 'required': ['value', 'unitCode'], 'properties': {'value': {'type': ['number', 'null']}, 'unitCode': {'type': ['string', 'null'], 'maxLength': 100}}, 'additionalProperties': False}, 'requested': {'type': 'boolean'}, 'sourceUrl': {'type': ['string', 'null'], 'format': 'uri', 'maxLength': 500}, 'stationId': {'type': ['string', 'null'], 'pattern': '^[A-Z0-9]{3,10}$'}, 'windChill': {'type': ['object', 'null'], 'required': ['value', 'unitCode'], 'properties': {'value': {'type': ['number', 'null']}, 'unitCode': {'type': ['string', 'null'], 'maxLength': 100}}, 'additionalProperties': False}, 'windSpeed': {'type': ['object', 'null'], 'required': ['value', 'unitCode'], 'properties': {'value': {'type': ['number', 'null']}, 'unitCode': {'type': ['string', 'null'], 'maxLength': 100}}, 'additionalProperties': False}, 'observedAt': {'type': ['string', 'null'], 'format': 'date-time'}, 'visibility': {'type': ['object', 'null'], 'required': ['value', 'unitCode'], 'properties': {'value': {'type': ['number', 'null']}, 'unitCode': {'type': ['string', 'null'], 'maxLength': 100}}, 'additionalProperties': False}, 'description': {'type': ['string', 'null'], 'maxLength': 300}, 'stationName': {'type': ['string', 'null'], 'maxLength': 200}, 'temperature': {'type': ['object', 'null'], 'required': ['value', 'unitCode'], 'properties': {'value': {'type': ['number', 'null']}, 'unitCode': {'type': ['string', 'null'], 'maxLength': 100}}, 'additionalProperties': False}, 'windDirection': {'type': ['object', 'null'], 'required': ['value', 'unitCode'], 'properties': {'value': {'type': ['number', 'null']}, 'unitCode': {'type': ['string', 'null'], 'maxLength': 100}}, 'additionalProperties': False}, 'relativeHumidityPercent': {'type': ['number', 'null'], 'maximum': 100, 'minimum': 0}}, 'additionalProperties': False}}, 'description': 'Structured Global weather forecast result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.us-weather-forecast'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.vin-decode
Decode a full 17-character VIN into normalized NHTSA vPIC make, model, year, body, engine, transmission, plant, fuel, and occupancy fields with official source evidence and explicit missing-data semantics.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'VinDecodeInput', 'required': ['vin'], 'properties': {'vin': {'type': 'string', 'title': 'Vin', 'pattern': '^[A-HJ-NPR-Z0-9]{17}$', 'examples': ['1HGCM82633A004352'], 'maxLength': 17, 'minLength': 17, 'description': 'Full 17-character vehicle identification number; letters I, O, and Q are invalid'}, 'model_year': {'anyOf': [{'type': 'integer', 'maximum': 2100, 'minimum': 1980}, {'type': 'null'}], 'title': 'Model Year', 'default': None, 'description': 'Optional model-year hint used by NHTSA when VIN encoding is ambiguous'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['vin', 'modelYearHint', 'decode', 'decodedFieldCount', 'missingFields', 'vehicle', 'source', 'retrievedAt', 'limitations'], 'properties': {'vin': {'type': 'string', 'pattern': '^[A-HJ-NPR-Z0-9]{17}$', 'maxLength': 17, 'minLength': 17}, 'decode': {'type': 'object', 'required': ['status', 'clean', 'errorCodes', 'errorText', 'apiMessage'], 'properties': {'clean': {'type': 'boolean'}, 'status': {'enum': ['clean', 'partial', 'unresolved'], 'type': 'string'}, 'errorText': {'type': ['string', 'null']}, 'apiMessage': {'type': ['string', 'null']}, 'errorCodes': {'type': 'array', 'items': {'type': 'integer', 'minimum': 0}, 'maxItems': 20, 'uniqueItems': True}}, 'additionalProperties': False}, 'source': {'type': 'object', 'required': ['provider', 'dataset', 'endpointUrl', 'documentationUrl', 'attribution', 'rateControlNotice'], 'properties': {'dataset': {'type': 'string', 'const': 'vPIC'}, 'provider': {'type': 'string', 'const': 'National Highway Traffic Safety Administration'}, 'attribution': {'type': 'string'}, 'endpointUrl': {'type': 'string', 'format': 'uri'}, 'documentationUrl': {'type': 'string', 'const': 'https://vpic.nhtsa.dot.gov/api/'}, 'rateControlNotice': {'type': 'string'}}, 'additionalProperties': False}, 'vehicle': {'type': 'object', 'required': ['make', 'model', 'modelYear', 'manufacturer', 'manufacturerId', 'vehicleType', 'bodyClass', 'series', 'trim', 'doors', 'driveType', 'fuelTypePrimary', 'fuelTypeSecondary', 'electrificationLevel', 'engine', 'transmission', 'plant', 'occupancy'], 'properties': {'make': {'type': ['string', 'null']}, 'trim': {'type': ['string', 'null']}, 'doors': {'type': ['number', 'null'], 'minimum': 0}, 'model': {'type': ['string', 'null']}, 'plant': {'type': 'object', 'required': ['city', 'state', 'country', 'companyName'], 'properties': {'city': {'type': ['string', 'null']}, 'state': {'type': ['string', 'null']}, 'country': {'type': ['string', 'null']}, 'companyName': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'engine': {'type': 'object', 'required': ['cylinders', 'displacementLiters', 'horsepower', 'model', 'manufacturer'], 'properties': {'model': {'type': ['string', 'null']}, 'cylinders': {'type': ['number', 'null'], 'minimum': 0}, 'horsepower': {'type': ['number', 'null'], 'minimum': 0}, 'manufacturer': {'type': ['string', 'null']}, 'displacementLiters': {'type': ['number', 'null'], 'minimum': 0}}, 'additionalProperties': False}, 'series': {'type': ['string', 'null']}, 'bodyClass': {'type': ['string', 'null']}, 'driveType': {'type': ['string', 'null']}, 'modelYear': {'type': ['integer', 'null'], 'maximum': 2100, 'minimum': 1900}, 'occupancy': {'type': 'object', 'required': ['seats', 'seatRows', 'grossVehicleWeightRating'], 'properties': {'seats': {'type': ['number', 'null'], 'minimum': 0}, 'seatRows': {'type': ['number', 'null'], 'minimum': 0}, 'grossVehicleWeightRating': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'vehicleType': {'type': ['string', 'null']}, 'manufacturer': {'type': ['string', 'null']}, 'transmission': {'type': 'object', 'required': ['style', 'speeds'], 'properties': {'style': {'type': ['string', 'null']}, 'speeds': {'type': ['number', 'null'], 'minimum': 0}}, 'additionalProperties': False}, 'manufacturerId': {'type': ['integer', 'null'], 'minimum': 0}, 'fuelTypePrimary': {'type': ['string', 'null']}, 'fuelTypeSecondary': {'type': ['string', 'null']}, 'electrificationLevel': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 3, 'minItems': 3}, 'retrievedAt': {'type': 'string', 'format': 'date-time'}, 'missingFields': {'type': 'array', 'items': {'enum': ['make', 'model', 'modelYear', 'manufacturer', 'manufacturerId', 'vehicleType', 'bodyClass', 'series', 'trim', 'doors', 'driveType', 'fuelTypePrimary', 'fuelTypeSecondary', 'electrificationLevel', 'engine.cylinders', 'engine.displacementLiters', 'engine.horsepower', 'engine.model', 'engine.manufacturer', 'transmission.style', 'transmission.speeds', 'plant.city', 'plant.state', 'plant.country', 'plant.companyName', 'occupancy.seats', 'occupancy.seatRows', 'occupancy.grossVehicleWeightRating'], 'type': 'string'}, 'maxItems': 28, 'uniqueItems': True}, 'modelYearHint': {'type': ['integer', 'null'], 'maximum': 2100, 'minimum': 1980}, 'decodedFieldCount': {'type': 'integer', 'maximum': 28, 'minimum': 0}}, 'description': 'Structured NHTSA vehicle VIN decoder result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.vin-decode'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
data.worldbank-snapshot
Bundle six official World Development Indicators into one normalized country snapshot with latest and previous GDP, growth, population, inflation, unemployment, and life-expectancy observations plus source and license evidence.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'WorldBankSnapshotInput', 'required': ['country_code'], 'properties': {'country_code': {'type': 'string', 'title': 'Country Code', 'pattern': '^[A-Za-z]{2,3}$', 'examples': ['GBR', 'US'], 'maxLength': 3, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 or alpha-3 country code'}, 'lookback_years': {'type': 'integer', 'title': 'Lookback Years', 'default': 10, 'maximum': 20, 'minimum': 3, 'description': 'Calendar-year window to request for every fixed indicator'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['country', 'window', 'availableMetricCount', 'metrics', 'missingMetrics', 'warnings', 'source', 'license', 'retrievedAt', 'limitations'], 'properties': {'source': {'type': 'object', 'required': ['provider', 'dataset', 'apiBaseUrl', 'countryUrl'], 'properties': {'dataset': {'type': 'string', 'const': 'World Development Indicators'}, 'provider': {'type': 'string', 'const': 'World Bank'}, 'apiBaseUrl': {'type': 'string', 'const': 'https://api.worldbank.org/v2'}, 'countryUrl': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': False}, 'window': {'type': 'object', 'required': ['startYear', 'endYear', 'lookbackYears'], 'properties': {'endYear': {'type': 'integer', 'maximum': 2100, 'minimum': 1900}, 'startYear': {'type': 'integer', 'maximum': 2100, 'minimum': 1900}, 'lookbackYears': {'type': 'integer', 'maximum': 20, 'minimum': 3}}, 'additionalProperties': False}, 'country': {'type': 'object', 'required': ['iso3Code', 'iso2Code', 'name', 'region', 'incomeLevel', 'lendingType', 'capitalCity'], 'properties': {'name': {'type': ['string', 'null']}, 'region': {'type': ['string', 'null']}, 'iso2Code': {'type': ['string', 'null'], 'pattern': '^[A-Z]{2}$'}, 'iso3Code': {'type': ['string', 'null'], 'pattern': '^[A-Z]{3}$'}, 'capitalCity': {'type': ['string', 'null']}, 'incomeLevel': {'type': ['string', 'null']}, 'lendingType': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'license': {'type': 'object', 'required': ['id', 'url', 'termsUrl', 'attribution', 'notice'], 'properties': {'id': {'type': 'string', 'const': 'CC-BY-4.0'}, 'url': {'type': 'string', 'const': 'https://creativecommons.org/licenses/by/4.0/'}, 'notice': {'type': 'string'}, 'termsUrl': {'type': 'string', 'const': 'https://data.worldbank.org/summary-terms-of-use'}, 'attribution': {'type': 'string', 'const': 'World Bank, World Development Indicators.'}}, 'additionalProperties': False}, 'metrics': {'type': 'object', 'maxProperties': 6, 'minProperties': 1, 'propertyNames': {'enum': ['gdpCurrentUsd', 'gdpGrowthAnnualPct', 'population', 'inflationAnnualPct', 'unemploymentPct', 'lifeExpectancyYears']}, 'additionalProperties': {'type': 'object', 'required': ['key', 'indicatorCode', 'name', 'unit', 'latest', 'previous', 'latestDelta', 'availableObservationCount', 'observations', 'sourceLastUpdated', 'sourceUrl'], 'properties': {'key': {'enum': ['gdpCurrentUsd', 'gdpGrowthAnnualPct', 'population', 'inflationAnnualPct', 'unemploymentPct', 'lifeExpectancyYears'], 'type': 'string'}, 'name': {'type': ['string', 'null']}, 'unit': {'enum': ['current USD', 'percent', 'people', 'percent of total labor force', 'years'], 'type': 'string'}, 'latest': {'anyOf': [{'type': 'object', 'required': ['year', 'value', 'status'], 'properties': {'year': {'type': 'integer', 'maximum': 2100, 'minimum': 1900}, 'value': {'type': ['number', 'null']}, 'status': {'type': ['string', 'null']}}, 'additionalProperties': False}, {'type': 'null'}]}, 'previous': {'anyOf': [{'type': 'object', 'required': ['year', 'value', 'status'], 'properties': {'year': {'type': 'integer', 'maximum': 2100, 'minimum': 1900}, 'value': {'type': ['number', 'null']}, 'status': {'type': ['string', 'null']}}, 'additionalProperties': False}, {'type': 'null'}]}, 'sourceUrl': {'type': 'string', 'format': 'uri'}, 'latestDelta': {'type': ['number', 'null']}, 'observations': {'type': 'array', 'items': {'type': 'object', 'required': ['year', 'value', 'status'], 'properties': {'year': {'type': 'integer', 'maximum': 2100, 'minimum': 1900}, 'value': {'type': ['number', 'null']}, 'status': {'type': ['string', 'null']}}, 'additionalProperties': False}, 'maxItems': 20}, 'indicatorCode': {'enum': ['NY.GDP.MKTP.CD', 'NY.GDP.MKTP.KD.ZG', 'SP.POP.TOTL', 'FP.CPI.TOTL.ZG', 'SL.UEM.TOTL.ZS', 'SP.DYN.LE00.IN'], 'type': 'string'}, 'sourceLastUpdated': {'type': ['string', 'null'], 'format': 'date'}, 'availableObservationCount': {'type': 'integer', 'maximum': 20, 'minimum': 0}}, 'additionalProperties': False}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 6}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 3, 'minItems': 3}, 'retrievedAt': {'type': 'string', 'format': 'date-time'}, 'missingMetrics': {'type': 'array', 'items': {'enum': ['gdpCurrentUsd', 'gdpGrowthAnnualPct', 'population', 'inflationAnnualPct', 'unemploymentPct', 'lifeExpectancyYears'], 'type': 'string'}, 'maxItems': 6, 'uniqueItems': True}, 'availableMetricCount': {'type': 'integer', 'maximum': 6, 'minimum': 1}}, 'description': 'Structured World Bank country indicator snapshot result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'data.worldbank-snapshot'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
developer.code-change-review
Compare caller-supplied before and after source snapshots without execution or network access, returning source fingerprints, syntax regressions, structural deltas, function-level changes, and bounded review findings.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'CodeChangeReviewInput', 'required': ['before', 'after'], 'properties': {'after': {'type': 'string', 'title': 'After', 'maxLength': 1000000}, 'before': {'type': 'string', 'title': 'Before', 'maxLength': 1000000}, 'filename': {'anyOf': [{'type': 'string', 'maxLength': 260}, {'type': 'null'}], 'title': 'Filename', 'default': None}, 'language': {'type': 'string', 'title': 'Language', 'default': 'python', 'maxLength': 40}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['changed', 'filename', 'language', 'before', 'after', 'summary', 'functionChanges', 'reviewDecision', 'attentionScore', 'attentionLevel', 'findings', 'execution', 'analysis'], 'properties': {'after': {'type': 'object', 'required': ['source', 'lines', 'functions', 'classes', 'branchPoints', 'estimatedCyclomaticComplexity', 'maximumFunctionComplexity', 'maintainabilitySignal', 'syntax'], 'properties': {'lines': {'type': 'object', 'required': ['total', 'code', 'comments', 'blank'], 'properties': {'code': {'type': 'integer', 'minimum': 0}, 'blank': {'type': 'integer', 'minimum': 0}, 'total': {'type': 'integer', 'minimum': 0}, 'comments': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'source': {'type': 'object', 'required': ['sha256', 'characters', 'utf8Bytes'], 'properties': {'sha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'utf8Bytes': {'type': 'integer', 'maximum': 2000000, 'minimum': 0}, 'characters': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}}, 'additionalProperties': False}, 'syntax': {'type': 'object', 'required': ['engine', 'valid', 'error'], 'properties': {'error': {'anyOf': [{'type': 'null'}, {'type': 'object', 'required': ['line', 'offset', 'message'], 'properties': {'line': {'type': ['integer', 'null'], 'minimum': 1}, 'offset': {'type': ['integer', 'null'], 'minimum': 0}, 'message': {'type': 'string', 'maxLength': 200}}, 'additionalProperties': False}]}, 'valid': {'type': ['boolean', 'null']}, 'engine': {'enum': ['python-ast', 'lexical-heuristics'], 'type': 'string'}}, 'additionalProperties': False}, 'classes': {'type': 'integer', 'minimum': 0}, 'functions': {'type': 'integer', 'minimum': 0}, 'branchPoints': {'type': 'integer', 'minimum': 0}, 'maintainabilitySignal': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'maximumFunctionComplexity': {'type': 'integer', 'minimum': 1}, 'estimatedCyclomaticComplexity': {'type': 'integer', 'minimum': 1}}, 'additionalProperties': False}, 'before': {'type': 'object', 'required': ['source', 'lines', 'functions', 'classes', 'branchPoints', 'estimatedCyclomaticComplexity', 'maximumFunctionComplexity', 'maintainabilitySignal', 'syntax'], 'properties': {'lines': {'type': 'object', 'required': ['total', 'code', 'comments', 'blank'], 'properties': {'code': {'type': 'integer', 'minimum': 0}, 'blank': {'type': 'integer', 'minimum': 0}, 'total': {'type': 'integer', 'minimum': 0}, 'comments': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'source': {'type': 'object', 'required': ['sha256', 'characters', 'utf8Bytes'], 'properties': {'sha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'utf8Bytes': {'type': 'integer', 'maximum': 2000000, 'minimum': 0}, 'characters': {'type': 'integer', 'maximum': 1000000, 'minimum': 0}}, 'additionalProperties': False}, 'syntax': {'type': 'object', 'required': ['engine', 'valid', 'error'], 'properties': {'error': {'anyOf': [{'type': 'null'}, {'type': 'object', 'required': ['line', 'offset', 'message'], 'properties': {'line': {'type': ['integer', 'null'], 'minimum': 1}, 'offset': {'type': ['integer', 'null'], 'minimum': 0}, 'message': {'type': 'string', 'maxLength': 200}}, 'additionalProperties': False}]}, 'valid': {'type': ['boolean', 'null']}, 'engine': {'enum': ['python-ast', 'lexical-heuristics'], 'type': 'string'}}, 'additionalProperties': False}, 'classes': {'type': 'integer', 'minimum': 0}, 'functions': {'type': 'integer', 'minimum': 0}, 'branchPoints': {'type': 'integer', 'minimum': 0}, 'maintainabilitySignal': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'maximumFunctionComplexity': {'type': 'integer', 'minimum': 1}, 'estimatedCyclomaticComplexity': {'type': 'integer', 'minimum': 1}}, 'additionalProperties': False}, 'changed': {'type': 'boolean'}, 'summary': {'type': 'object', 'required': ['lineDelta', 'codeLineDelta', 'functionDelta', 'classDelta', 'branchPointDelta', 'complexityDelta', 'maximumFunctionComplexityDelta', 'maintainabilityDelta', 'longLineDelta', 'workMarkerDelta'], 'properties': {'lineDelta': {'type': 'integer'}, 'classDelta': {'type': 'integer'}, 'codeLineDelta': {'type': 'integer'}, 'functionDelta': {'type': 'integer'}, 'longLineDelta': {'type': 'integer'}, 'complexityDelta': {'type': 'integer'}, 'workMarkerDelta': {'type': 'integer'}, 'branchPointDelta': {'type': 'integer'}, 'maintainabilityDelta': {'type': 'integer'}, 'maximumFunctionComplexityDelta': {'type': 'integer'}}, 'additionalProperties': False}, 'analysis': {'type': 'object', 'required': ['version', 'method', 'limitations'], 'properties': {'method': {'type': 'string', 'const': 'two deterministic code-metrics snapshots plus Python function-level deltas'}, 'version': {'type': 'string', 'const': 'apiacre-code-change-review/1'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 3, 'minItems': 3}}, 'additionalProperties': False}, 'filename': {'type': ['string', 'null'], 'maxLength': 260}, 'findings': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'severity', 'message', 'evidence'], 'properties': {'id': {'enum': ['syntax-regression', 'invalid-after-snapshot', 'complexity-growth', 'function-complexity-growth', 'maintainability-drop', 'new-work-markers', 'new-long-lines'], 'type': 'string'}, 'message': {'type': 'string'}, 'evidence': {'type': 'object'}, 'severity': {'enum': ['low', 'medium', 'high'], 'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 7}, 'language': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'execution': {'type': 'object', 'required': ['codeExecuted', 'networkAccessed'], 'properties': {'codeExecuted': {'type': 'boolean', 'const': False}, 'networkAccessed': {'type': 'boolean', 'const': False}}, 'additionalProperties': False}, 'attentionLevel': {'enum': ['clear', 'medium', 'high'], 'type': 'string'}, 'attentionScore': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'reviewDecision': {'enum': ['clear', 'review', 'high-attention'], 'type': 'string'}, 'functionChanges': {'type': 'object', 'required': ['addedCount', 'removedCount', 'changedCount', 'added', 'removed', 'changed', 'truncated'], 'properties': {'added': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200}, 'changed': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'sourceChanged', 'sourceSha256Before', 'sourceSha256After', 'complexityBefore', 'complexityAfter', 'complexityDelta', 'linesBefore', 'linesAfter', 'lineDelta', 'parametersBefore', 'parametersAfter', 'parameterDelta'], 'properties': {'name': {'type': 'string', 'minLength': 1}, 'lineDelta': {'type': 'integer'}, 'linesAfter': {'type': 'integer', 'minimum': 1}, 'linesBefore': {'type': 'integer', 'minimum': 1}, 'sourceChanged': {'type': 'boolean'}, 'parameterDelta': {'type': 'integer'}, 'complexityAfter': {'type': 'integer', 'minimum': 1}, 'complexityDelta': {'type': 'integer'}, 'parametersAfter': {'type': 'integer', 'minimum': 0}, 'complexityBefore': {'type': 'integer', 'minimum': 1}, 'parametersBefore': {'type': 'integer', 'minimum': 0}, 'sourceSha256After': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'sourceSha256Before': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'maxItems': 200}, 'removed': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 200}, 'truncated': {'type': 'boolean'}, 'addedCount': {'type': 'integer', 'minimum': 0}, 'changedCount': {'type': 'integer', 'minimum': 0}, 'removedCount': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'description': 'Structured Code change review result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'developer.code-change-review'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
developer.code-metrics
Measure caller-supplied source code with Python AST analysis or a deterministic lexical fallback, including per-function complexity, a SHA-256 fingerprint, density ratios, syntax status, and actionable maintainability signals without retaining or forwarding the code. One bounded no-wallet trial is available through the separate HTTP endpoint https://apiacre.com/trials/developer.code-metrics; this MCP tools/call operation remains paid.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'CodeMetricsInput', 'required': ['code'], 'properties': {'code': {'type': 'string', 'title': 'Code', 'maxLength': 2000000, 'minLength': 1}, 'language': {'type': 'string', 'title': 'Language', 'default': 'text', 'maxLength': 40, 'minLength': 1}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['language', 'source', 'lines', 'classes', 'functions', 'branchPoints', 'estimatedCyclomaticComplexity', 'complexityPerFunction', 'maximumFunctionComplexity', 'functionMetrics', 'functionsTruncated', 'syntax', 'maximumLineLength', 'averageLineLength', 'commentDensity', 'blankLineDensity', 'longLineCount', 'workMarkerCount', 'maintainabilitySignal', 'reviewSignals', 'analysis'], 'properties': {'lines': {'type': 'object', 'required': ['total', 'code', 'comments', 'blank'], 'properties': {'code': {'type': 'integer', 'minimum': 0}, 'blank': {'type': 'integer', 'minimum': 0}, 'total': {'type': 'integer', 'minimum': 0}, 'comments': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'source': {'type': 'object', 'required': ['sha256', 'characters', 'utf8Bytes'], 'properties': {'sha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'utf8Bytes': {'type': 'integer', 'maximum': 2000000, 'minimum': 1}, 'characters': {'type': 'integer', 'maximum': 2000000, 'minimum': 1}}, 'additionalProperties': False}, 'syntax': {'type': 'object', 'required': ['engine', 'valid', 'error'], 'properties': {'error': {'anyOf': [{'type': 'null'}, {'type': 'object', 'required': ['line', 'offset', 'message'], 'properties': {'line': {'type': ['integer', 'null'], 'minimum': 1}, 'offset': {'type': ['integer', 'null'], 'minimum': 0}, 'message': {'type': 'string', 'maxLength': 200}}, 'additionalProperties': False}]}, 'valid': {'type': ['boolean', 'null']}, 'engine': {'enum': ['python-ast', 'lexical-heuristics'], 'type': 'string'}}, 'additionalProperties': False}, 'classes': {'type': 'integer', 'minimum': 0}, 'analysis': {'type': 'object', 'required': ['version', 'method', 'limitations'], 'properties': {'method': {'enum': ['Python AST with deterministic lexical metrics', 'deterministic lexical heuristics'], 'type': 'string'}, 'version': {'type': 'string', 'const': 'apiacre-code-metrics/3'}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 2, 'minItems': 2}}, 'additionalProperties': False}, 'language': {'type': 'string', 'maxLength': 40, 'minLength': 1}, 'functions': {'type': 'integer', 'minimum': 0}, 'branchPoints': {'type': 'integer', 'minimum': 0}, 'longLineCount': {'type': 'integer', 'minimum': 0}, 'reviewSignals': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'severity', 'message'], 'properties': {'code': {'enum': ['syntax-error', 'high-complexity-density', 'long-lines', 'work-markers', 'low-comment-density', 'large-source-unit'], 'type': 'string'}, 'message': {'type': 'string', 'maxLength': 500}, 'severity': {'enum': ['low', 'medium', 'high'], 'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 6}, 'commentDensity': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'functionMetrics': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'kind', 'line', 'endLine', 'lines', 'parameters', 'branchPoints', 'estimatedCyclomaticComplexity'], 'properties': {'kind': {'enum': ['function', 'async-function'], 'type': 'string'}, 'line': {'type': 'integer', 'maximum': 2000000, 'minimum': 1}, 'name': {'type': 'string', 'maxLength': 2000000, 'minLength': 1}, 'lines': {'type': 'integer', 'maximum': 2000000, 'minimum': 1}, 'endLine': {'type': 'integer', 'maximum': 2000000, 'minimum': 1}, 'parameters': {'type': 'integer', 'maximum': 2000000, 'minimum': 0}, 'branchPoints': {'type': 'integer', 'maximum': 2000000, 'minimum': 0}, 'estimatedCyclomaticComplexity': {'type': 'integer', 'maximum': 2000001, 'minimum': 1}}, 'additionalProperties': False}, 'maxItems': 500}, 'workMarkerCount': {'type': 'integer', 'minimum': 0}, 'blankLineDensity': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'averageLineLength': {'type': 'number', 'maximum': 2000000, 'minimum': 0}, 'maximumLineLength': {'type': 'integer', 'maximum': 2000000, 'minimum': 0}, 'functionsTruncated': {'type': 'boolean'}, 'complexityPerFunction': {'type': 'number', 'minimum': 1}, 'maintainabilitySignal': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'maximumFunctionComplexity': {'type': 'integer', 'minimum': 1}, 'estimatedCyclomaticComplexity': {'type': 'integer', 'minimum': 1}}, 'description': 'Structured Code metrics result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'developer.code-metrics'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
developer.dependency-audit
Audit exact Python/PyPI, npm, Go, Maven, NuGet, crates.io, or RubyGems dependencies against OSV and return affected packages and vulnerabilities.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$defs': {'Dependency': {'type': 'object', 'title': 'Dependency', 'required': ['name', 'version'], 'properties': {'name': {'type': 'string', 'title': 'Name', 'maxLength': 240, 'minLength': 1}, 'version': {'type': 'string', 'title': 'Version', 'maxLength': 120, 'minLength': 1}}}}, 'title': 'DependencyAuditInput', 'required': ['ecosystem', 'dependencies'], 'properties': {'ecosystem': {'enum': ['PyPI', 'npm', 'Go', 'Maven', 'NuGet', 'crates.io', 'RubyGems'], 'type': 'string', 'title': 'Ecosystem'}, 'dependencies': {'type': 'array', 'items': {'$ref': '#/$defs/Dependency'}, 'title': 'Dependencies', 'maxItems': 100, 'minItems': 1}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'clean': {'type': 'boolean'}, 'source': {'type': 'string'}, 'findings': {'type': 'array', 'items': {}}, 'ecosystem': {'type': 'string'}, 'dependencies': {'type': 'integer'}, 'vulnerabilityCount': {'type': 'integer'}}, 'description': 'Structured Audit Python and npm dependencies for vulnerabilities result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'developer.dependency-audit'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
developer.license-audit
Classify software dependency licenses and flag packages that need commercial or legal review.
Read only
Idempotent
Input schema
{'type': 'object', '$defs': {'LicensedDependency': {'type': 'object', 'title': 'LicensedDependency', 'required': ['name', 'license'], 'properties': {'name': {'type': 'string', 'title': 'Name', 'maxLength': 240, 'minLength': 1}, 'license': {'type': 'string', 'title': 'License', 'maxLength': 120, 'minLength': 1}}}}, 'title': 'LicenseAuditInput', 'required': ['dependencies'], 'properties': {'policy': {'enum': ['permissive', 'commercial'], 'type': 'string', 'title': 'Policy', 'default': 'commercial'}, 'dependencies': {'type': 'array', 'items': {'$ref': '#/$defs/LicensedDependency'}, 'title': 'Dependencies', 'maxItems': 500, 'minItems': 1}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'counts': {'type': 'object'}, 'policy': {'type': 'string'}, 'findings': {'type': 'array', 'items': {}}, 'disclaimer': {'type': 'string'}, 'requiresReview': {'type': 'boolean'}}, 'description': 'Structured License compatibility audit result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'developer.license-audit'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
developer.openapi-audit
Validate and audit an OpenAPI document for missing operation IDs, descriptions, responses, and consistency problems.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'StructuredDocumentInput', 'required': ['document'], 'properties': {'format': {'enum': ['json', 'yaml'], 'type': 'string', 'title': 'Format', 'default': 'yaml'}, 'document': {'type': 'string', 'title': 'Document', 'maxLength': 2000000}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'score': {'type': 'integer'}, 'valid': {'type': 'boolean'}, 'issues': {'type': 'array', 'items': {}}, 'operations': {'type': 'integer'}}, 'description': 'Structured OpenAPI audit result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'developer.openapi-audit'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
developer.openapi-test-generate
Generate deterministic, syntax-validated pytest and requests smoke tests from a caller-supplied OpenAPI 3 document, with mutating operations disabled by default.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'OpenApiTestGenerateInput', 'required': ['document'], 'properties': {'format': {'enum': ['json', 'yaml'], 'type': 'string', 'title': 'Format', 'default': 'yaml'}, 'base_url': {'anyOf': [{'type': 'string', 'maxLength': 2048}, {'type': 'null'}], 'title': 'Base Url', 'default': None}, 'document': {'type': 'string', 'title': 'Document', 'maxLength': 524288, 'minLength': 1}, 'api_key_env': {'type': 'string', 'title': 'Api Key Env', 'default': 'API_KEY', 'maxLength': 64, 'minLength': 2}, 'max_operations': {'type': 'integer', 'title': 'Max Operations', 'default': 50, 'maximum': 100, 'minimum': 1}, 'timeout_seconds': {'type': 'integer', 'title': 'Timeout Seconds', 'default': 20, 'maximum': 120, 'minimum': 1}, 'bearer_token_env': {'type': 'string', 'title': 'Bearer Token Env', 'default': 'API_BEARER_TOKEN', 'maxLength': 64, 'minLength': 2}, 'include_optional': {'type': 'boolean', 'title': 'Include Optional', 'default': False}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['documentSha256', 'openapiVersion', 'apiTitle', 'baseUrlDefault', 'operationCount', 'generatedTestCount', 'guardedMutationCount', 'truncated', 'sourceFileName', 'sourceSha256', 'source', 'operations', 'requirements', 'environment', 'warnings', 'execution'], 'properties': {'source': {'type': 'string', 'maxLength': 262144, 'minLength': 1}, 'apiTitle': {'type': ['string', 'null'], 'maxLength': 200}, 'warnings': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 50, 'uniqueItems': True}, 'execution': {'type': 'object', 'required': ['sourceSyntaxValidated', 'generatedTestsExecuted', 'networkRequestsMade'], 'properties': {'networkRequestsMade': {'type': 'boolean', 'const': False}, 'sourceSyntaxValidated': {'type': 'boolean', 'const': True}, 'generatedTestsExecuted': {'type': 'boolean', 'const': False}}, 'additionalProperties': False}, 'truncated': {'type': 'boolean'}, 'operations': {'type': 'array', 'items': {'type': 'object', 'required': ['operationId', 'testName', 'method', 'path', 'mutatingGuard', 'documentedResponses'], 'properties': {'path': {'type': 'string', 'maxLength': 262144}, 'method': {'enum': ['GET', 'HEAD', 'OPTIONS', 'POST', 'PUT', 'PATCH', 'DELETE', 'TRACE'], 'type': 'string'}, 'testName': {'type': 'string', 'pattern': '^test_[a-z0-9_]+$', 'maxLength': 100}, 'operationId': {'type': ['string', 'null'], 'maxLength': 200}, 'mutatingGuard': {'type': 'boolean'}, 'documentedResponses': {'type': 'array', 'items': {'type': 'string', 'maxLength': 32}, 'maxItems': 50000, 'uniqueItems': True}}, 'additionalProperties': False}, 'maxItems': 100, 'minItems': 1}, 'environment': {'type': 'object', 'required': ['baseUrl', 'bearerToken', 'apiKey', 'allowMutatingTests'], 'properties': {'apiKey': {'type': 'string', 'pattern': '^[A-Z][A-Z0-9_]{1,63}$'}, 'baseUrl': {'type': 'string', 'const': 'API_BASE_URL'}, 'bearerToken': {'type': 'string', 'pattern': '^[A-Z][A-Z0-9_]{1,63}$'}, 'allowMutatingTests': {'type': 'string', 'const': 'API_ALLOW_MUTATING_TESTS'}}, 'additionalProperties': False}, 'requirements': {'type': 'array', 'const': ['pytest>=8', 'requests>=2.31']}, 'sourceSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'baseUrlDefault': {'type': ['string', 'null'], 'pattern': '^https?://', 'maxLength': 2048}, 'documentSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'openapiVersion': {'type': 'string', 'pattern': '^3\\.[01]\\.', 'maxLength': 32}, 'operationCount': {'type': 'integer', 'maximum': 1000, 'minimum': 1}, 'sourceFileName': {'type': 'string', 'const': 'test_openapi_generated.py'}, 'generatedTestCount': {'type': 'integer', 'maximum': 100, 'minimum': 1}, 'guardedMutationCount': {'type': 'integer', 'maximum': 100, 'minimum': 0}}, 'description': 'Structured OpenAPI pytest generator result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'developer.openapi-test-generate'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
developer.secret-scan
Detect likely leaked API keys, tokens, private-key headers, JWTs, and credential assignments in caller-supplied source or configuration text. Return type, line, fingerprint, and a fully redacted preview with no network access or code execution.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'SecretScanInput', 'required': ['content'], 'properties': {'content': {'type': 'string', 'title': 'Content', 'maxLength': 2000000}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['clean', 'findingCount', 'findings'], 'properties': {'clean': {'type': 'boolean'}, 'findings': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'line', 'fingerprint', 'preview'], 'properties': {'line': {'type': 'integer', 'minimum': 1}, 'type': {'enum': ['aws_access_key', 'github_token', 'private_key', 'jwt', 'generic_assignment'], 'type': 'string'}, 'preview': {'type': 'string', 'const': '[REDACTED]'}, 'fingerprint': {'type': 'string', 'pattern': '^[0-9a-f]{16}$'}}, 'additionalProperties': False}, 'maxItems': 500}, 'findingCount': {'type': 'integer', 'minimum': 0}}, 'description': 'Structured Redacted credential leak scan result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'developer.secret-scan'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
developer.sql-change-review
Statically parse caller-supplied SQL without a database connection or execution, inventory statements and tables, and flag destructive DDL, unfiltered writes, and migration atomicity concerns.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'SqlChangeReviewInput', 'required': ['sql'], 'properties': {'sql': {'type': 'string', 'title': 'Sql', 'maxLength': 65536, 'minLength': 1}, 'dialect': {'enum': ['postgres', 'mysql', 'sqlite', 'tsql', 'bigquery', 'snowflake', 'duckdb', 'spark', 'oracle', 'redshift'], 'type': 'string', 'title': 'Dialect', 'default': 'postgres'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'valid': {'type': 'boolean'}, 'parser': {'type': 'object'}, 'dialect': {'type': 'string'}, 'summary': {'type': 'object'}, 'findings': {'type': 'array', 'items': {}}, 'execution': {'type': 'object'}, 'statements': {'type': 'array', 'items': {}}, 'limitations': {'type': 'array', 'items': {}}, 'attentionLevel': {'type': 'string'}, 'attentionScore': {'type': 'integer'}, 'documentSha256': {'type': 'string'}, 'reviewDecision': {'type': 'string'}, 'statementCount': {'type': 'integer'}}, 'description': 'Structured SQL change review result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'developer.sql-change-review'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
developer.structured-diff
Compare JSON or YAML deterministically and return source hashes plus machine-readable additions, removals, and replacements by path with explicit truncation evidence.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'StructuredDiffInput', 'required': ['before', 'after'], 'properties': {'after': {'type': 'string', 'title': 'After', 'maxLength': 1000000}, 'before': {'type': 'string', 'title': 'Before', 'maxLength': 1000000}, 'format': {'enum': ['json', 'yaml'], 'type': 'string', 'title': 'Format', 'default': 'json'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'format': {'type': 'string'}, 'changed': {'type': 'boolean'}, 'changes': {'type': 'array', 'items': {'type': 'object', 'required': ['op', 'path'], 'properties': {'op': {'enum': ['add', 'remove', 'replace'], 'type': 'string'}, 'path': {'type': 'string', 'pattern': '^\\$'}, 'after': {}, 'before': {}}}, 'maxItems': 5000, 'description': 'Deterministically ordered structural changes; inspect changesTruncated before treating the list as complete.'}, 'afterSha256': {'type': 'string'}, 'changeCount': {'type': 'integer'}, 'beforeSha256': {'type': 'string'}, 'changesReturned': {'type': 'integer'}, 'changesTruncated': {'type': 'boolean'}}, 'description': 'Structured Structured diff result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'developer.structured-diff'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
developer.x402-preflight
Probe a public endpoint without paying, grade its x402 v2 challenge, check exact-host x402-list presence and traction, and optionally rank licensed market matches with buyer-concentration caveats.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'X402PreflightInput', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'format': 'uri', 'maxLength': 2083, 'minLength': 1}, 'body': {'anyOf': [{'type': 'object', 'additionalProperties': True}, {'type': 'null'}], 'title': 'Body', 'default': None}, 'method': {'enum': ['GET', 'POST'], 'type': 'string', 'title': 'Method', 'default': 'POST'}, 'market_limit': {'type': 'integer', 'title': 'Market Limit', 'default': 5, 'maximum': 10, 'minimum': 1}, 'market_query': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 3}, {'type': 'null'}], 'title': 'Market Query', 'default': None}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'grade': {'type': 'string'}, 'score': {'type': 'integer'}, 'checks': {'type': 'array', 'items': {}}, 'method': {'type': 'string'}, 'payment': {'type': 'object'}, 'finalUrl': {'type': 'string'}, 'checkedAt': {'type': 'string'}, 'compliant': {'type': 'boolean'}, 'elapsedMs': {'type': 'integer'}, 'statusCode': {'type': 'integer'}, 'limitations': {'type': 'string'}, 'remediation': {'type': 'array', 'items': {}}, 'gradeVersion': {'type': 'string'}, 'directoryEvidence': {'type': 'object'}}, 'description': 'Structured x402 endpoint preflight result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'developer.x402-preflight'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
document.diff
Compare two texts and return structured line additions, removals, and a unified diff.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'DiffInput', 'required': ['before', 'after'], 'properties': {'after': {'type': 'string', 'title': 'After', 'maxLength': 500000}, 'before': {'type': 'string', 'title': 'Before', 'maxLength': 500000}, 'context_lines': {'type': 'integer', 'title': 'Context Lines', 'default': 3, 'maximum': 20, 'minimum': 0}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'diff': {'type': 'string'}, 'added': {'type': 'integer'}, 'changed': {'type': 'boolean'}, 'removed': {'type': 'integer'}}, 'description': 'Structured Document diff result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'document.diff'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
document.extract
Extract clean text and metadata from supplied PDF, DOCX, HTML, Markdown, CSV, JSON, YAML, or plain-text documents.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'DocumentInput', 'required': ['filename', 'content_base64'], 'properties': {'filename': {'type': 'string', 'title': 'Filename', 'maxLength': 240}, 'content_base64': {'type': 'string', 'title': 'Content Base64', 'maxLength': 7100000}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'text': {'type': 'string'}, 'words': {'type': 'integer'}, 'metadata': {'type': 'object'}, 'characters': {'type': 'integer'}}, 'description': 'Structured Document extraction result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'document.extract'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
document.redact
Deterministically detect and redact PII and personal data in supplied text with overlap-safe matching for emails, phone numbers, validated IPv4 and IPv6 addresses, Luhn-valid payment cards, valid-checksum IBANs, and structurally valid US Social Security numbers.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'RedactInput', 'required': ['text'], 'properties': {'text': {'type': 'string', 'title': 'Text', 'maxLength': 500000}, 'types': {'type': 'array', 'items': {'enum': ['email', 'phone', 'ipv4', 'ipv6', 'credit_card', 'ssn', 'iban'], 'type': 'string'}, 'title': 'Types', 'maxItems': 7, 'minItems': 1}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['text', 'counts', 'total', 'selectedTypes', 'findingsReturned', 'findingsTruncated', 'findings', 'redactedCharacters', 'inputSha256', 'outputSha256', 'detector', 'limitations'], 'properties': {'text': {'type': 'string', 'maxLength': 3000000}, 'total': {'type': 'integer', 'maximum': 500000, 'minimum': 0}, 'counts': {'type': 'object', 'required': ['email', 'phone', 'ipv4', 'ipv6', 'credit_card', 'ssn', 'iban'], 'properties': {'ssn': {'type': 'integer', 'maximum': 500000, 'minimum': 0}, 'iban': {'type': 'integer', 'maximum': 500000, 'minimum': 0}, 'ipv4': {'type': 'integer', 'maximum': 500000, 'minimum': 0}, 'ipv6': {'type': 'integer', 'maximum': 500000, 'minimum': 0}, 'email': {'type': 'integer', 'maximum': 500000, 'minimum': 0}, 'phone': {'type': 'integer', 'maximum': 500000, 'minimum': 0}, 'credit_card': {'type': 'integer', 'maximum': 500000, 'minimum': 0}}, 'additionalProperties': False}, 'detector': {'type': 'object', 'required': ['version', 'deterministic', 'overlapSafe', 'validatedTypes', 'networkRequestsMade'], 'properties': {'version': {'type': 'string', 'const': 'apiacre-pii-redaction/2'}, 'overlapSafe': {'type': 'boolean', 'const': True}, 'deterministic': {'type': 'boolean', 'const': True}, 'validatedTypes': {'type': 'array', 'const': ['credit_card', 'iban', 'ipv4', 'ipv6', 'ssn']}, 'networkRequestsMade': {'type': 'integer', 'const': 0}}, 'additionalProperties': False}, 'findings': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'start', 'end', 'characters', 'placeholder'], 'properties': {'end': {'type': 'integer', 'maximum': 500000, 'minimum': 1}, 'type': {'enum': ['email', 'phone', 'ipv4', 'ipv6', 'credit_card', 'ssn', 'iban'], 'type': 'string'}, 'start': {'type': 'integer', 'maximum': 500000, 'minimum': 0}, 'characters': {'type': 'integer', 'maximum': 500000, 'minimum': 1}, 'placeholder': {'enum': ['[REDACTED_EMAIL]', '[REDACTED_PHONE]', '[REDACTED_IPV4]', '[REDACTED_IPV6]', '[REDACTED_CREDIT_CARD]', '[REDACTED_SSN]', '[REDACTED_IBAN]'], 'type': 'string'}}, 'additionalProperties': False}, 'maxItems': 1000}, 'inputSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 2, 'minItems': 2}, 'outputSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'selectedTypes': {'type': 'array', 'items': {'enum': ['email', 'phone', 'ipv4', 'ipv6', 'credit_card', 'ssn', 'iban'], 'type': 'string'}, 'maxItems': 7, 'minItems': 1, 'uniqueItems': True}, 'findingsReturned': {'type': 'integer', 'maximum': 1000, 'minimum': 0}, 'findingsTruncated': {'type': 'boolean'}, 'redactedCharacters': {'type': 'integer', 'maximum': 500000, 'minimum': 0}}, 'description': 'Structured PII and personal-data redaction result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'document.redact'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
document.tables
Extract structured table rows and columns from supplied HTML, DOCX, or CSV documents.
Read only
Idempotent
Input schema
{'type': 'object', 'title': 'DocumentInput', 'required': ['filename', 'content_base64'], 'properties': {'filename': {'type': 'string', 'title': 'Filename', 'maxLength': 240}, 'content_base64': {'type': 'string', 'title': 'Content Base64', 'maxLength': 7100000}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'rows': {'type': 'array', 'items': {}}, 'warning': {'type': ['string', 'null']}, 'metadata': {'type': 'object'}, 'rowCount': {'type': 'integer'}}, 'description': 'Structured Table extraction result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'document.tables'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
research.crossref-doi-metadata
Resolve one DOI into normalized open Crossref bibliographic, author, container, citation-count, license, identifier, and correction or retraction-link metadata without abstracts or full text.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'CrossrefDoiMetadataInput', 'required': ['doi'], 'properties': {'doi': {'type': 'string', 'title': 'Doi', 'maxLength': 255, 'minLength': 6}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'doi': {'type': 'string'}, 'work': {'type': 'object'}, 'source': {'type': 'string'}, 'status': {'type': 'string'}, 'limitations': {'type': 'array', 'items': {}}, 'retrievedAt': {'type': 'string'}, 'documentation': {'type': 'string'}, 'metadataLicense': {'type': 'object'}}, 'description': 'Structured Crossref DOI metadata enrichment result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'research.crossref-doi-metadata'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
research.crossref-work-search
Search open Crossref bibliographic metadata by title, author, DOI fragment, or citation and return bounded normalized publication, author, citation, license, and update metadata without abstracts or full text.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'CrossrefWorkSearchInput', 'required': ['query'], 'properties': {'query': {'type': 'string', 'title': 'Query', 'maxLength': 300, 'minLength': 2, 'description': 'Title, author, DOI fragment, or bibliographic citation to search'}, 'sort_by': {'enum': ['relevance', 'newest', 'most_cited'], 'type': 'string', 'title': 'Sort By', 'default': 'relevance'}, 'work_type': {'anyOf': [{'enum': ['book', 'book-chapter', 'dataset', 'dissertation', 'journal-article', 'monograph', 'posted-content', 'proceedings-article', 'report', 'standard'], 'type': 'string'}, {'type': 'null'}], 'title': 'Work Type', 'default': None}, 'max_results': {'type': 'integer', 'title': 'Max Results', 'default': 10, 'maximum': 20, 'minimum': 1}, 'published_from': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}], 'title': 'Published From', 'default': None}, 'published_until': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}], 'title': 'Published Until', 'default': None}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'query': {'type': 'object'}, 'source': {'type': 'string'}, 'results': {'type': 'array', 'items': {}}, 'limitations': {'type': 'array', 'items': {}}, 'retrievedAt': {'type': 'string'}, 'totalResults': {'type': 'integer'}, 'documentation': {'type': 'string'}, 'metadataLicense': {'type': 'object'}, 'resultsReturned': {'type': 'integer'}}, 'description': 'Structured Crossref scholarly work search result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'research.crossref-work-search'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
research.federal-register-search
Search newest U.S. Federal Register document metadata by topic, agency, type, and publication date, returning bounded regulatory notices, rules, proposed rules, presidential documents, and links to FederalRegister.gov and official govinfo.gov PDFs.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'FederalRegisterSearchInput', 'properties': {'query': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 2}, {'type': 'null'}], 'title': 'Query', 'default': None, 'examples': ['artificial intelligence'], 'description': 'Optional full-text Federal Register search term'}, 'max_results': {'type': 'integer', 'title': 'Max Results', 'default': 10, 'maximum': 25, 'minimum': 1, 'description': 'Maximum newest-first documents returned'}, 'agency_slugs': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Agency Slugs', 'examples': [['commerce-department']], 'maxItems': 5, 'description': 'Optional exact FederalRegister.gov agency slugs, such as commerce-department'}, 'published_to': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}], 'title': 'Published To', 'default': None, 'examples': ['2026-12-31'], 'description': 'Optional inclusive publication-date upper bound'}, 'document_types': {'type': 'array', 'items': {'enum': ['RULE', 'PRORULE', 'NOTICE', 'PRESDOCU'], 'type': 'string'}, 'title': 'Document Types', 'maxItems': 4, 'description': 'Optional document types: RULE, PRORULE, NOTICE, or PRESDOCU'}, 'published_from': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}], 'title': 'Published From', 'default': None, 'examples': ['2026-01-01'], 'description': 'Optional inclusive publication-date lower bound'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'query': {'type': 'object'}, 'source': {'type': 'string'}, 'documents': {'type': 'array', 'items': {}}, 'disclaimer': {'type': 'string'}, 'description': {'type': ['string', 'null']}, 'limitations': {'type': 'array', 'items': {}}, 'retrievedAt': {'type': 'string'}, 'totalMatches': {'type': 'integer'}, 'documentation': {'type': 'string'}, 'documentsReturned': {'type': 'integer'}, 'documentsTruncated': {'type': 'boolean'}}, 'description': 'Structured Federal Register document search result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'research.federal-register-search'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
research.feed-normalize
Fetch and normalize public RSS or Atom feeds into stable structured JSON entries for agents and research workflows.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'FeedInput', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'format': 'uri', 'maxLength': 2083, 'minLength': 1}, 'limit': {'type': 'integer', 'title': 'Limit', 'default': 20, 'maximum': 100, 'minimum': 1}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'title': {'type': ['string', 'null']}, 'entries': {'type': 'array', 'items': {}}, 'entryCount': {'type': 'integer'}}, 'description': 'Structured Feed normalization result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'research.feed-normalize'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
research.lei-entity-search
Search the official GLEIF Global LEI Index by exact LEI or legal name and return ranked legal-entity identity, registration, mapped-identifier, and relationship-availability evidence.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'LegalEntitySearchInput', 'properties': {'lei': {'anyOf': [{'type': 'string', 'maxLength': 20, 'minLength': 20}, {'type': 'null'}], 'title': 'Lei', 'default': None, 'examples': ['HWUPKR0MPOU8FGXBT394'], 'description': 'Exact 20-character Legal Entity Identifier (LEI)'}, 'legal_name': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 2}, {'type': 'null'}], 'title': 'Legal Name', 'default': None, 'examples': ['Apple Inc.'], 'description': 'Registered or commonly used legal entity name'}, 'max_results': {'type': 'integer', 'title': 'Max Results', 'default': 3, 'maximum': 5, 'minimum': 1, 'description': 'Maximum candidates returned for a name search'}, 'country_code': {'anyOf': [{'type': 'string', 'pattern': '^[A-Za-z]{2}$'}, {'type': 'null'}], 'title': 'Country Code', 'default': None, 'examples': ['US'], 'description': 'Optional ISO 3166-1 alpha-2 legal-address country filter'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'query': {'type': 'object'}, 'source': {'type': 'string'}, 'status': {'type': 'string'}, 'license': {'type': 'object'}, 'matches': {'type': 'array', 'items': {}}, 'disclaimer': {'type': 'string'}, 'matchCount': {'type': 'integer'}, 'limitations': {'type': 'array', 'items': {}}, 'retrievedAt': {'type': 'string'}, 'totalCandidates': {'type': 'integer'}, 'goldenCopyPublishedAt': {'type': 'string'}}, 'description': 'Structured GLEIF legal entity search result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'research.lei-entity-search'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
research.news-aggregate
Merge two to eight public RSS or Atom feeds into a filtered, deduplicated, time-ordered news stream with bounded partial-failure reporting.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'NewsAggregateInput', 'required': ['feeds'], 'properties': {'feeds': {'type': 'array', 'items': {'type': 'string', 'format': 'uri', 'maxLength': 2083, 'minLength': 1}, 'title': 'Feeds', 'maxItems': 8, 'minItems': 2}, 'limit': {'type': 'integer', 'title': 'Limit', 'default': 50, 'maximum': 100, 'minimum': 1}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Keywords', 'maxItems': 20}, 'since_hours': {'anyOf': [{'type': 'integer', 'maximum': 720, 'minimum': 1}, {'type': 'null'}], 'title': 'Since Hours', 'default': None}, 'deduplicate_by': {'enum': ['url', 'title', 'url_or_title'], 'type': 'string', 'title': 'Deduplicate By', 'default': 'url_or_title'}, 'per_feed_limit': {'type': 'integer', 'title': 'Per Feed Limit', 'default': 25, 'maximum': 50, 'minimum': 1}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'feeds': {'type': 'array', 'items': {}}, 'entries': {'type': 'array', 'items': {}}, 'feedCount': {'type': 'integer'}, 'entryCount': {'type': 'integer'}, 'filteredOut': {'type': 'integer'}, 'retrievedAt': {'type': 'string'}, 'failedFeedCount': {'type': 'integer'}, 'duplicatesRemoved': {'type': 'integer'}, 'successfulFeedCount': {'type': 'integer'}}, 'description': 'Structured Multi-feed news aggregation result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'research.news-aggregate'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
research.ofac-entity-search
Compare a business or organization name with separately named Entity records and aliases in the official OFAC SDN and Consolidated Non-SDN files, returning deterministic candidate scores, program tags, source hashes, and freshness evidence without issuing an allow or block verdict.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'OfacEntitySearchInput', 'required': ['entity_name'], 'properties': {'entity_name': {'type': 'string', 'title': 'Entity Name', 'examples': ['AEROCARIBBEAN AIRLINES'], 'maxLength': 200, 'minLength': 3, 'description': 'Organization or business name to compare with separately named OFAC Entity records'}, 'max_results': {'type': 'integer', 'title': 'Max Results', 'default': 5, 'maximum': 10, 'minimum': 1, 'description': 'Maximum candidate records to return after deterministic ranking'}, 'minimum_score': {'type': 'integer', 'title': 'Minimum Score', 'default': 85, 'maximum': 100, 'minimum': 70, 'description': "Minimum API Acre similarity score to return; this is not OFAC's interactive-search score"}, 'include_weak_aliases': {'type': 'boolean', 'title': 'Include Weak Aliases', 'default': False, 'description': 'Include aliases that OFAC labels weak and warns may create false positives'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['status', 'query', 'candidateCount', 'candidatesReturned', 'candidatesTruncated', 'candidates', 'dataset', 'source', 'retrievedAt', 'limitations', 'guidance', 'disclaimer'], 'properties': {'query': {'type': 'object', 'required': ['entityName', 'normalizedName', 'entityType', 'minimumScore', 'maxResults', 'includeWeakAliases'], 'properties': {'entityName': {'type': 'string', 'maxLength': 200, 'minLength': 3}, 'entityType': {'type': 'string', 'const': 'Entity'}, 'maxResults': {'type': 'integer', 'maximum': 10, 'minimum': 1}, 'minimumScore': {'type': 'integer', 'maximum': 100, 'minimum': 70}, 'normalizedName': {'type': 'string', 'maxLength': 200, 'minLength': 3}, 'includeWeakAliases': {'type': 'boolean'}}, 'additionalProperties': False}, 'source': {'type': 'string', 'const': 'https://ofac.treasury.gov/sanctions-list-service'}, 'status': {'enum': ['candidates_found', 'no_candidates_above_threshold'], 'type': 'string'}, 'dataset': {'type': 'object', 'required': ['snapshotFetchedAt', 'cacheMaxAgeSeconds', 'files'], 'properties': {'files': {'type': 'array', 'items': {'type': 'object', 'required': ['listKind', 'listLabel', 'filename', 'publishDate', 'recordCount', 'entityRecordCount', 'sha256', 'sourceUrl'], 'properties': {'sha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'filename': {'enum': ['sdn.xml', 'consolidated.xml'], 'type': 'string'}, 'listKind': {'enum': ['sdn', 'consolidated-non-sdn'], 'type': 'string'}, 'listLabel': {'enum': ['SDN', 'Consolidated Non-SDN'], 'type': 'string'}, 'sourceUrl': {'type': 'string', 'format': 'uri'}, 'publishDate': {'type': 'string', 'format': 'date'}, 'recordCount': {'type': 'integer', 'minimum': 1}, 'entityRecordCount': {'type': 'integer', 'minimum': 1}}, 'additionalProperties': False}, 'maxItems': 2, 'minItems': 2}, 'snapshotFetchedAt': {'type': 'string', 'format': 'date-time'}, 'cacheMaxAgeSeconds': {'type': 'integer', 'const': 3600}}, 'additionalProperties': False}, 'guidance': {'type': 'object', 'required': ['automation', 'fiftyPercentRule'], 'properties': {'automation': {'type': 'string', 'const': 'https://ofac.treasury.gov/faqs/287'}, 'fiftyPercentRule': {'type': 'string', 'const': 'https://ofac.treasury.gov/faqs/10'}}, 'additionalProperties': False}, 'candidates': {'type': 'array', 'items': {'type': 'object', 'required': ['uid', 'primaryName', 'entityType', 'listKind', 'listLabel', 'programs', 'countries', 'match', 'sourceFileUrl'], 'properties': {'uid': {'type': 'string', 'pattern': '^[0-9]+$'}, 'match': {'type': 'object', 'required': ['matchedName', 'matchedField', 'aliasQuality', 'score', 'method', 'scoreAuthority'], 'properties': {'score': {'type': 'number', 'maximum': 100, 'minimum': 0}, 'method': {'enum': ['exact', 'deterministic_name_similarity'], 'type': 'string'}, 'matchedName': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'aliasQuality': {'enum': ['strong', 'weak', None], 'type': ['string', 'null']}, 'matchedField': {'enum': ['primary', 'alias'], 'type': 'string'}, 'scoreAuthority': {'type': 'string'}}, 'additionalProperties': False}, 'listKind': {'enum': ['sdn', 'consolidated-non-sdn'], 'type': 'string'}, 'programs': {'type': 'array', 'items': {'type': 'string', 'maxLength': 120}, 'maxItems': 100, 'uniqueItems': True}, 'countries': {'type': 'array', 'items': {'type': 'string', 'maxLength': 120}, 'maxItems': 10, 'uniqueItems': True}, 'listLabel': {'enum': ['SDN', 'Consolidated Non-SDN'], 'type': 'string'}, 'entityType': {'type': 'string', 'const': 'Entity'}, 'primaryName': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'sourceFileUrl': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': False}, 'maxItems': 10}, 'disclaimer': {'type': 'string'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 4, 'minItems': 4}, 'retrievedAt': {'type': 'string', 'format': 'date-time'}, 'candidateCount': {'type': 'integer', 'minimum': 0}, 'candidatesReturned': {'type': 'integer', 'maximum': 10, 'minimum': 0}, 'candidatesTruncated': {'type': 'boolean'}}, 'description': 'Structured OFAC entity candidate evidence result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'research.ofac-entity-search'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
research.organization-evidence
Retrieve a current supplier and organization evidence report from official GLEIF legal-entity, USAspending prime-contract, SEC filing-activity, and OFAC Entity records, with bounded source-specific coverage for procurement research and no identity, linkage, risk, or compliance verdict.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'OrganizationEvidenceInput', 'required': ['legal_name'], 'properties': {'legal_name': {'type': 'string', 'title': 'Legal Name', 'examples': ['Palantir Technologies Inc.'], 'maxLength': 200, 'minLength': 2, 'description': 'Organization legal or trading name used independently across official GLEIF, USAspending, SEC, and OFAC organization records'}, 'country_code': {'anyOf': [{'type': 'string', 'pattern': '^[A-Za-z]{2}$'}, {'type': 'null'}], 'title': 'Country Code', 'default': None, 'examples': ['US'], 'description': 'Optional ISO 3166-1 alpha-2 filter applied only to GLEIF candidates'}, 'sec_identifier': {'anyOf': [{'type': 'string', 'maxLength': 20, 'minLength': 1}, {'type': 'null'}], 'title': 'Sec Identifier', 'default': None, 'examples': ['PLTR'], 'description': 'Optional SEC ticker or CIK; when absent, the exact organization name is resolved against the SEC company directory'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'query': {'type': 'object'}, 'counts': {'type': 'object'}, 'sources': {'type': 'array', 'items': {}}, 'coverage': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {}}, 'disclaimer': {'type': 'string'}, 'legalEntity': {'type': 'object'}, 'limitations': {'type': 'array', 'items': {}}, 'retrievedAt': {'type': 'string'}, 'federalContracts': {'type': 'object'}, 'secFilingActivity': {'type': 'object'}, 'crossSourceLinkage': {'type': 'string'}, 'ofacEntityCandidates': {'type': 'object'}}, 'description': 'Structured Official supplier evidence report result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'research.organization-evidence'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
research.sec-company-evidence
Resolve an exact SEC company name, ticker, or CIK, then bundle recent filing signals, normalized issuer-reported XBRL facts, and Form 4 insider transactions into one bounded public-company evidence report with explicit section coverage and official-source provenance.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'SecCompanyEvidenceInput', 'required': ['identifier'], 'properties': {'forms': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Forms', 'maxItems': 30, 'description': 'Optional exact SEC form filters for the filing-activity section'}, 'identifier': {'type': 'string', 'title': 'Identifier', 'examples': ['Apple Inc.', 'AAPL', '0000320193'], 'maxLength': 160, 'minLength': 1, 'description': 'Exact SEC company name, SEC CIK, or U.S.-listed ticker symbol'}, 'max_filings': {'type': 'integer', 'title': 'Max Filings', 'default': 50, 'maximum': 100, 'minimum': 1}, 'financial_metrics': {'type': 'array', 'items': {'enum': ['revenue', 'net_income', 'operating_income', 'total_assets', 'total_liabilities', 'stockholders_equity', 'cash_and_equivalents', 'operating_cash_flow', 'capital_expenditure', 'diluted_eps'], 'type': 'string'}, 'title': 'Financial Metrics', 'maxItems': 10, 'minItems': 1, 'description': 'Normalized issuer-reported financial metrics to include'}, 'financial_periods': {'type': 'integer', 'title': 'Financial Periods', 'default': 4, 'maximum': 12, 'minimum': 1}, 'include_derivatives': {'type': 'boolean', 'title': 'Include Derivatives', 'default': True, 'description': 'Include derivative securities in the Form 4 section'}, 'max_insider_filings': {'type': 'integer', 'title': 'Max Insider Filings', 'default': 10, 'maximum': 25, 'minimum': 1}, 'filing_lookback_days': {'type': 'integer', 'title': 'Filing Lookback Days', 'default': 365, 'maximum': 3650, 'minimum': 30}, 'financial_period_type': {'enum': ['annual', 'quarterly', 'both'], 'type': 'string', 'title': 'Financial Period Type', 'default': 'both'}, 'insider_lookback_days': {'type': 'integer', 'title': 'Insider Lookback Days', 'default': 90, 'maximum': 730, 'minimum': 1}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'company': {'type': 'object'}, 'sources': {'type': 'array', 'items': {}}, 'coverage': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {}}, 'disclaimer': {'type': 'string'}, 'parameters': {'type': 'object'}, 'resolution': {'type': 'object'}, 'limitations': {'type': 'array', 'items': {}}, 'retrievedAt': {'type': 'string'}, 'filingActivity': {'type': 'object'}, 'financialFacts': {'type': 'object'}, 'insiderTransactions': {'type': 'object'}}, 'description': 'Structured SEC public company evidence bundle result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'research.sec-company-evidence'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
research.sec-filing-signals
Look up a public company by ticker or CIK, normalize recent SEC filings, and flag deterministic events such as late filings, amendments, auditor changes, non-reliance, control changes, or bankruptcy disclosures.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'SecFilingSignalsInput', 'required': ['identifier'], 'properties': {'forms': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Forms', 'maxItems': 30, 'description': 'Optional exact SEC form filters, such as 10-K, 10-Q, or 8-K'}, 'identifier': {'type': 'string', 'title': 'Identifier', 'examples': ['AAPL', '0000320193'], 'maxLength': 20, 'minLength': 1, 'description': 'SEC CIK or U.S.-listed ticker symbol'}, 'max_filings': {'type': 'integer', 'title': 'Max Filings', 'default': 50, 'maximum': 200, 'minimum': 1}, 'lookback_days': {'type': 'integer', 'title': 'Lookback Days', 'default': 365, 'maximum': 3650, 'minimum': 30}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'cik': {'type': 'string'}, 'sic': {'type': 'string'}, 'name': {'type': 'string'}, 'source': {'type': 'string'}, 'filings': {'type': 'array', 'items': {}}, 'signals': {'type': 'array', 'items': {}}, 'tickers': {'type': 'array', 'items': {}}, 'exchanges': {'type': 'array', 'items': {}}, 'disclaimer': {'type': 'string'}, 'filingCount': {'type': 'integer'}, 'retrievedAt': {'type': 'string'}, 'lookbackDays': {'type': 'integer'}, 'fiscalYearEnd': {'type': 'string'}, 'attentionLevel': {'type': 'string'}, 'attentionScore': {'type': 'integer'}, 'sicDescription': {'type': 'string'}}, 'description': 'Structured SEC filing activity signals result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'research.sec-filing-signals'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
research.sec-financial-facts
Retrieve normalized, recent issuer-reported revenue, earnings, balance-sheet, cash-flow, and diluted-EPS facts from official SEC XBRL data.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'SecFinancialFactsInput', 'required': ['identifier'], 'properties': {'metrics': {'type': 'array', 'items': {'enum': ['revenue', 'net_income', 'operating_income', 'total_assets', 'total_liabilities', 'stockholders_equity', 'cash_and_equivalents', 'operating_cash_flow', 'capital_expenditure', 'diluted_eps'], 'type': 'string'}, 'title': 'Metrics', 'maxItems': 10, 'minItems': 1, 'description': 'Normalized financial metrics to return'}, 'periods': {'type': 'integer', 'title': 'Periods', 'default': 4, 'maximum': 12, 'minimum': 1, 'description': 'Observations per metric'}, 'identifier': {'type': 'string', 'title': 'Identifier', 'examples': ['AAPL', '0000320193'], 'maxLength': 20, 'minLength': 1, 'description': 'SEC CIK or U.S.-listed ticker symbol'}, 'period_type': {'enum': ['annual', 'quarterly', 'both'], 'type': 'string', 'title': 'Period Type', 'default': 'both'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'cik': {'type': 'string'}, 'source': {'type': 'string'}, 'metrics': {'type': 'object'}, 'taxonomy': {'type': 'string'}, 'disclaimer': {'type': 'string'}, 'entityName': {'type': 'string'}, 'periodType': {'type': 'string'}, 'retrievedAt': {'type': 'string'}, 'missingMetrics': {'type': 'array', 'items': {}}, 'periodsPerMetric': {'type': 'integer'}}, 'description': 'Structured SEC normalized financial facts result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'research.sec-financial-facts'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
research.sec-insider-transactions
Retrieve recent SEC Form 4 officer, director, and 10% beneficial-owner trades for a ticker or CIK, including purchases, sales, awards, exercises, tax withholding, prices, holdings, 10b5-1 context, derivatives, and filing footnotes.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'SecInsiderTransactionsInput', 'required': ['identifier'], 'properties': {'identifier': {'type': 'string', 'title': 'Identifier', 'examples': ['AAPL', '0000320193'], 'maxLength': 20, 'minLength': 1, 'description': 'SEC CIK or U.S.-listed ticker symbol'}, 'max_filings': {'type': 'integer', 'title': 'Max Filings', 'default': 10, 'maximum': 25, 'minimum': 1}, 'lookback_days': {'type': 'integer', 'title': 'Lookback Days', 'default': 90, 'maximum': 730, 'minimum': 1}, 'include_derivatives': {'type': 'boolean', 'title': 'Include Derivatives', 'default': True, 'description': 'Include option, restricted-stock-unit, and other derivative transactions'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'cik': {'type': 'string'}, 'name': {'type': 'string'}, 'source': {'type': 'string'}, 'filings': {'type': 'array', 'items': {}}, 'summary': {'type': 'object'}, 'tickers': {'type': 'array', 'items': {}}, 'warnings': {'type': 'array', 'items': {}}, 'exchanges': {'type': 'array', 'items': {}}, 'disclaimer': {'type': 'string'}, 'retrievedAt': {'type': 'string'}, 'lookbackDays': {'type': 'integer'}, 'includeDerivatives': {'type': 'boolean'}}, 'description': 'Structured SEC Form 4 insider transactions result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'research.sec-insider-transactions'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
research.us-contract-search
Search public USAspending prime federal procurement awards by recipient company or organization name, UEI, or legacy DUNS, returning bounded contract values, agencies, performance dates, descriptions, official award links, and explicit interpretation limits.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'UsContractSearchInput', 'required': ['recipient_query'], 'properties': {'end_date': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}], 'title': 'End Date', 'default': None, 'examples': ['2026-08-13'], 'description': 'Optional inclusive award-action upper bound; defaults to today'}, 'start_date': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}], 'title': 'Start Date', 'default': None, 'examples': ['2024-01-01'], 'description': 'Optional inclusive award-action lower bound; defaults to five years before end_date'}, 'max_results': {'type': 'integer', 'title': 'Max Results', 'default': 10, 'maximum': 25, 'minimum': 1, 'description': 'Maximum highest-award-amount prime contracts returned'}, 'recipient_query': {'type': 'string', 'title': 'Recipient Query', 'examples': ['Palantir USG'], 'maxLength': 120, 'minLength': 2, 'description': 'Recipient organization name, UEI, or legacy DUNS to search across public USAspending prime-contract records'}, 'maximum_award_amount': {'anyOf': [{'type': 'integer', 'maximum': 1000000000000, 'minimum': 0}, {'type': 'null'}], 'title': 'Maximum Award Amount', 'default': None, 'description': 'Optional maximum current aggregate contract-award amount in whole USD'}, 'minimum_award_amount': {'anyOf': [{'type': 'integer', 'maximum': 1000000000000, 'minimum': 0}, {'type': 'null'}], 'title': 'Minimum Award Amount', 'default': None, 'examples': [1000000], 'description': 'Optional minimum current aggregate contract-award amount in whole USD'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['query', 'resultsReceived', 'awardsReturned', 'awardsSkipped', 'hasMore', 'awards', 'sourceMessages', 'source', 'documentation', 'retrievedAt', 'limitations', 'disclaimer'], 'properties': {'query': {'type': 'object', 'required': ['recipientQuery', 'recipientFieldsSearched', 'startDate', 'endDate', 'minimumAwardAmountUsd', 'maximumAwardAmountUsd', 'awardTypeCodes', 'awardScope', 'sort', 'maxResults'], 'properties': {'sort': {'type': 'string', 'const': 'award amount descending'}, 'endDate': {'type': 'string', 'format': 'date'}, 'startDate': {'type': 'string', 'format': 'date'}, 'awardScope': {'type': 'string', 'const': 'prime contracts'}, 'maxResults': {'type': 'integer', 'maximum': 25, 'minimum': 1}, 'awardTypeCodes': {'type': 'array', 'const': ['A', 'B', 'C', 'D']}, 'recipientQuery': {'type': 'string', 'maxLength': 120, 'minLength': 2}, 'maximumAwardAmountUsd': {'type': ['integer', 'null'], 'maximum': 1000000000000, 'minimum': 0}, 'minimumAwardAmountUsd': {'type': ['integer', 'null'], 'maximum': 1000000000000, 'minimum': 0}, 'recipientFieldsSearched': {'type': 'array', 'const': ['name', 'UEI', 'legacy DUNS']}}, 'additionalProperties': False}, 'awards': {'type': 'array', 'items': {'type': 'object', 'required': ['internalId', 'awardId', 'recipientName', 'recipientUei', 'awardAmountUsd', 'awardType', 'description', 'startDate', 'endDate', 'lastModifiedAtSource', 'awardingAgency', 'awardingSubAgency', 'fundingAgency', 'fundingSubAgency', 'generatedInternalId', 'officialAwardUrl'], 'properties': {'awardId': {'type': 'string', 'maxLength': 240, 'minLength': 1}, 'endDate': {'type': ['string', 'null'], 'format': 'date'}, 'awardType': {'type': ['string', 'null'], 'maxLength': 160}, 'startDate': {'type': ['string', 'null'], 'format': 'date'}, 'internalId': {'type': 'integer', 'minimum': 1}, 'description': {'type': ['string', 'null'], 'maxLength': 5000}, 'recipientUei': {'type': ['string', 'null'], 'pattern': '^[A-Z0-9]{12}$'}, 'fundingAgency': {'type': ['string', 'null'], 'maxLength': 300}, 'recipientName': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'awardAmountUsd': {'type': 'number'}, 'awardingAgency': {'type': ['string', 'null'], 'maxLength': 300}, 'fundingSubAgency': {'type': ['string', 'null'], 'maxLength': 300}, 'officialAwardUrl': {'type': 'string', 'format': 'uri', 'pattern': '^https://www\\.usaspending\\.gov/award/'}, 'awardingSubAgency': {'type': ['string', 'null'], 'maxLength': 300}, 'generatedInternalId': {'type': 'string', 'maxLength': 500, 'minLength': 1}, 'lastModifiedAtSource': {'type': ['string', 'null'], 'maxLength': 32}}, 'additionalProperties': False}, 'maxItems': 25}, 'source': {'type': 'string', 'const': 'https://api.usaspending.gov/api/v2/search/spending_by_award/'}, 'hasMore': {'type': 'boolean'}, 'disclaimer': {'type': 'string', 'maxLength': 500}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 3, 'minItems': 3}, 'retrievedAt': {'type': 'string', 'format': 'date-time'}, 'awardsSkipped': {'type': 'integer', 'maximum': 25, 'minimum': 0}, 'documentation': {'type': 'string', 'format': 'uri'}, 'awardsReturned': {'type': 'integer', 'maximum': 25, 'minimum': 0}, 'sourceMessages': {'type': 'array', 'items': {'type': 'string', 'maxLength': 1000}, 'maxItems': 10}, 'resultsReceived': {'type': 'integer', 'maximum': 25, 'minimum': 0}}, 'description': 'Structured U.S. federal contract search result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'research.us-contract-search'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
research.wikidata-organization-search
Search CC0 Wikidata organization candidates and normalize public websites, inception dates, company identifiers, entity types, countries, industries, headquarters, parent, founder, owner, subsidiary, and product links with explicit non-verification caveats.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'WikidataOrganizationSearchInput', 'required': ['organization_name'], 'properties': {'language': {'type': 'string', 'title': 'Language', 'default': 'en', 'maxLength': 12, 'minLength': 2}, 'max_results': {'type': 'integer', 'title': 'Max Results', 'default': 5, 'maximum': 10, 'minimum': 1}, 'organization_name': {'type': 'string', 'title': 'Organization Name', 'maxLength': 200, 'minLength': 2}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'query': {'type': 'object'}, 'source': {'type': 'string'}, 'license': {'type': 'object'}, 'candidates': {'type': 'array', 'items': {}}, 'disclaimer': {'type': 'string'}, 'limitations': {'type': 'array', 'items': {}}, 'retrievedAt': {'type': 'string'}, 'documentation': {'type': 'string'}, 'candidateCount': {'type': 'integer'}}, 'description': 'Structured Wikidata organization candidate search result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'research.wikidata-organization-search'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
web.accessibility-audit
Check a public page for deterministic HTML accessibility problems and return actionable WCAG-oriented findings.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'UrlInput', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'format': 'uri', 'maxLength': 2083, 'minLength': 1}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'score': {'type': 'integer'}, 'issues': {'type': 'array', 'items': {}}, 'issueCount': {'type': 'integer'}}, 'description': 'Structured Accessibility audit result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'web.accessibility-audit'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
web.business-due-diligence
Assess one public business website and domain using site quality, SEO, security, accessibility, performance, DNS, TLS, RDAP, and optional public GLEIF candidates; return technical evidence and explicit identity, ownership, compliance, and vendor-approval limitations.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'BusinessDueDiligenceInput', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'format': 'uri', 'maxLength': 2083, 'minLength': 1}, 'legal_name': {'anyOf': [{'type': 'string', 'maxLength': 200, 'minLength': 2}, {'type': 'null'}], 'title': 'Legal Name', 'default': None, 'examples': ['Apple Inc.'], 'description': 'Optional registered company name to match against public GLEIF LEI records. A match does not prove that the company owns the supplied domain.'}, 'country_code': {'anyOf': [{'type': 'string', 'pattern': '^[A-Za-z]{2}$'}, {'type': 'null'}], 'title': 'Country Code', 'default': None, 'examples': ['US'], 'description': 'Optional ISO 3166-1 alpha-2 legal-address country filter'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'flags': {'type': 'array', 'items': {}}, 'domain': {'type': 'string'}, 'riskLevel': {'type': 'string'}, 'riskScore': {'type': 'integer'}, 'siteAudit': {'type': 'object'}, 'disclaimer': {'type': 'string'}, 'scoreScope': {'type': 'string'}, 'legalEntity': {'type': 'object'}, 'domainIntelligence': {'type': 'object'}}, 'description': 'Structured Website and domain technical due diligence result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'web.business-due-diligence'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
web.domain-intelligence
Investigate a domain using parallel DNS, TLS certificate, RDAP (the standards-based successor to WHOIS), DNSSEC, SPF, and DMARC signals with factual findings and source provenance.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'UrlInput', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'format': 'uri', 'maxLength': 2083, 'minLength': 1}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'dns': {'type': 'object'}, 'tls': {'type': 'object'}, 'rdap': {'type': 'object'}, 'domain': {'type': 'string'}, 'signals': {'type': 'object'}, 'findings': {'type': 'array', 'items': {}}, 'checkedAt': {'type': 'string'}, 'provenance': {'type': 'object'}, 'collectionMs': {'type': 'integer'}, 'requestedUrl': {'type': 'string'}, 'emailAuthentication': {'type': 'object'}}, 'description': 'Structured Domain intelligence result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'web.domain-intelligence'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
web.email-auth
Check a public domain's email authentication and anti-spoofing posture using MX, SPF, DMARC, caller-selected DKIM, MTA-STS, TLS-RPT, and BIMI DNS evidence.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'EmailAuthInput', 'required': ['domain'], 'properties': {'domain': {'type': 'string', 'title': 'Domain', 'examples': ['apiacre.com'], 'maxLength': 253, 'minLength': 3, 'description': 'Public DNS domain to inspect without a URL scheme or path'}, 'dkim_selectors': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Dkim Selectors', 'examples': [['protonmail']], 'maxItems': 5, 'description': 'Optional known DKIM selectors to query; selectors cannot be discovered reliably from DNS alone'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'required': ['domain', 'mailRouting', 'spf', 'dmarc', 'dkim', 'optionalPolicies', 'posture', 'findings', 'provenance', 'limitations', 'checkedAt', 'collectionMs'], 'properties': {'spf': {'type': 'object', 'required': ['configured', 'recordCount', 'records', 'multipleRecords', 'allQualifier', 'directDnsMechanismCount'], 'properties': {'records': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2000}, 'maxItems': 30}, 'configured': {'type': 'boolean'}, 'recordCount': {'type': 'integer', 'maximum': 30, 'minimum': 0}, 'allQualifier': {'enum': ['fail', 'softfail', 'neutral', 'pass', None], 'type': ['string', 'null']}, 'multipleRecords': {'type': 'boolean'}, 'directDnsMechanismCount': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'dkim': {'type': 'object', 'required': ['checked', 'checkedSelectors', 'selectors', 'reason'], 'properties': {'reason': {'type': ['string', 'null'], 'maxLength': 300}, 'checked': {'type': 'boolean'}, 'selectors': {'type': 'array', 'items': {'type': 'object', 'required': ['selector', 'configured', 'recordCount', 'multipleRecords', 'revoked', 'keyType', 'publicKeySha256'], 'properties': {'keyType': {'type': ['string', 'null'], 'maxLength': 30}, 'revoked': {'type': 'boolean'}, 'selector': {'type': 'string', 'maxLength': 100}, 'configured': {'type': 'boolean'}, 'recordCount': {'type': 'integer', 'maximum': 30, 'minimum': 0}, 'multipleRecords': {'type': 'boolean'}, 'publicKeySha256': {'type': ['string', 'null'], 'pattern': '^[0-9a-f]{64}$'}}, 'additionalProperties': False}, 'maxItems': 5}, 'checkedSelectors': {'type': 'array', 'items': {'type': 'string', 'maxLength': 100}, 'maxItems': 5, 'uniqueItems': True}}, 'additionalProperties': False}, 'dmarc': {'type': 'object', 'required': ['configured', 'recordCount', 'records', 'multipleRecords', 'policy', 'subdomainPolicy', 'percentage', 'aggregateReportingConfigured', 'forensicReportingConfigured', 'dkimAlignment', 'spfAlignment'], 'properties': {'policy': {'type': ['string', 'null'], 'maxLength': 30}, 'records': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2000}, 'maxItems': 30}, 'configured': {'type': 'boolean'}, 'percentage': {'type': ['integer', 'null'], 'maximum': 100, 'minimum': 0}, 'recordCount': {'type': 'integer', 'maximum': 30, 'minimum': 0}, 'spfAlignment': {'type': ['string', 'null'], 'maxLength': 20}, 'dkimAlignment': {'type': ['string', 'null'], 'maxLength': 20}, 'multipleRecords': {'type': 'boolean'}, 'subdomainPolicy': {'type': ['string', 'null'], 'maxLength': 30}, 'forensicReportingConfigured': {'type': 'boolean'}, 'aggregateReportingConfigured': {'type': 'boolean'}}, 'additionalProperties': False}, 'domain': {'type': 'string', 'format': 'hostname', 'maxLength': 253}, 'posture': {'type': 'object', 'required': ['status', 'basis'], 'properties': {'basis': {'type': 'string', 'const': 'published DNS records only'}, 'status': {'enum': ['enforcing', 'monitoring', 'incomplete', 'no_mail_declared'], 'type': 'string'}}, 'additionalProperties': False}, 'findings': {'type': 'array', 'items': {'type': 'object', 'required': ['level', 'code', 'message'], 'properties': {'code': {'type': 'string', 'pattern': '^[a-z0-9_]+$'}, 'level': {'enum': ['info', 'warning'], 'type': 'string'}, 'message': {'type': 'string', 'maxLength': 500}}, 'additionalProperties': False}, 'maxItems': 20}, 'checkedAt': {'type': 'string', 'format': 'date-time'}, 'provenance': {'type': 'object', 'required': ['source', 'queries', 'queryCount'], 'properties': {'source': {'type': 'string', 'const': 'recursive DNS'}, 'queries': {'type': 'array', 'items': {'type': 'string', 'maxLength': 400}, 'maxItems': 13, 'minItems': 8}, 'queryCount': {'type': 'integer', 'maximum': 13, 'minimum': 8}}, 'additionalProperties': False}, 'limitations': {'type': 'array', 'items': {'type': 'string', 'maxLength': 500}, 'maxItems': 3, 'minItems': 3}, 'mailRouting': {'type': 'object', 'required': ['mode', 'mxRecords', 'nullMx', 'addressFallbackObserved'], 'properties': {'mode': {'enum': ['null_mx', 'explicit_mx', 'implicit_address_fallback', 'not_observed'], 'type': 'string'}, 'nullMx': {'type': 'boolean'}, 'mxRecords': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2000}, 'maxItems': 30}, 'addressFallbackObserved': {'type': 'boolean'}}, 'additionalProperties': False}, 'collectionMs': {'type': 'integer', 'minimum': 0}, 'optionalPolicies': {'type': 'object', 'required': ['mtaSts', 'tlsReporting', 'bimi'], 'properties': {'bimi': {'type': 'object', 'required': ['configured', 'recordCount', 'records'], 'properties': {'records': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2000}, 'maxItems': 30}, 'configured': {'type': 'boolean'}, 'recordCount': {'type': 'integer', 'maximum': 30, 'minimum': 0}}, 'additionalProperties': False}, 'mtaSts': {'type': 'object', 'required': ['configured', 'recordCount', 'records'], 'properties': {'records': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2000}, 'maxItems': 30}, 'configured': {'type': 'boolean'}, 'recordCount': {'type': 'integer', 'maximum': 30, 'minimum': 0}}, 'additionalProperties': False}, 'tlsReporting': {'type': 'object', 'required': ['configured', 'recordCount', 'records'], 'properties': {'records': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2000}, 'maxItems': 30}, 'configured': {'type': 'boolean'}, 'recordCount': {'type': 'integer', 'maximum': 30, 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'description': 'Structured Email authentication posture result', 'additionalProperties': False}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'web.email-auth'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
web.extract
Convert and extract a public website URL into clean Markdown or readable text plus bounded structured links, canonical and heading signals, Schema.org types, redirect evidence, content hashes, and response provenance for RAG, research, or agent context.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'ExtractInput', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'format': 'uri', 'maxLength': 2083, 'minLength': 1}, 'output': {'type': 'string', 'title': 'Output', 'default': 'markdown', 'pattern': '^(markdown|text)$'}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'links': {'type': 'object', 'required': ['detected', 'returned', 'internal', 'external', 'truncated', 'scanLimit', 'returnLimit', 'items'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['url', 'text', 'external'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'text': {'type': 'string', 'maxLength': 200}, 'external': {'type': 'boolean'}}, 'additionalProperties': False}, 'maxItems': 100}, 'detected': {'type': 'integer', 'maximum': 500, 'minimum': 0}, 'external': {'type': 'integer', 'maximum': 500, 'minimum': 0}, 'internal': {'type': 'integer', 'maximum': 500, 'minimum': 0}, 'returned': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'scanLimit': {'type': 'integer', 'const': 500}, 'truncated': {'type': 'boolean'}, 'returnLimit': {'type': 'integer', 'const': 100}}, 'additionalProperties': False}, 'title': {'type': ['string', 'null']}, 'words': {'type': 'integer'}, 'format': {'type': 'string'}, 'sha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'content': {'type': 'string'}, 'language': {'type': ['string', 'null']}, 'response': {'type': 'object', 'required': ['statusCode', 'contentType', 'elapsedMs', 'bytes', 'bodySha256'], 'properties': {'bytes': {'type': 'integer', 'minimum': 0}, 'elapsedMs': {'type': 'integer', 'minimum': 0}, 'bodySha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'statusCode': {'type': 'integer', 'maximum': 599, 'minimum': 100}, 'contentType': {'type': ['string', 'null']}}}, 'characters': {'type': 'integer'}, 'extraction': {'type': 'object', 'required': ['version', 'method', 'javascriptRendered', 'linksPreserved', 'limitations'], 'properties': {'method': {'type': 'string', 'const': 'bounded HTML DOM extraction'}, 'version': {'type': 'string', 'const': 'apiacre-content-extract/3'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'linksPreserved': {'type': 'boolean'}, 'javascriptRendered': {'type': 'boolean', 'const': False}}}, 'redirected': {'type': 'boolean'}, 'description': {'type': ['string', 'null']}, 'pageSignals': {'type': 'object', 'required': ['canonicalUrl', 'headings', 'structuredData', 'feedCount', 'alternateLanguageCount'], 'properties': {'headings': {'type': 'object', 'required': ['h1', 'h2Count', 'h3Count'], 'properties': {'h1': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 10}, 'h2Count': {'type': 'integer', 'minimum': 0}, 'h3Count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'feedCount': {'type': 'integer', 'maximum': 20, 'minimum': 0}, 'canonicalUrl': {'type': ['string', 'null'], 'format': 'uri'}, 'structuredData': {'type': 'object', 'required': ['blocks', 'validBlocks', 'invalidBlocks', 'types', 'truncated'], 'properties': {'types': {'type': 'array', 'items': {'type': 'string'}}, 'blocks': {'type': 'integer', 'minimum': 0}, 'truncated': {'type': 'boolean'}, 'validBlocks': {'type': 'integer', 'minimum': 0}, 'invalidBlocks': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}, 'alternateLanguageCount': {'type': 'integer', 'maximum': 50, 'minimum': 0}}, 'additionalProperties': False}, 'requestedUrl': {'type': 'string', 'format': 'uri'}, 'contentSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}}, 'description': 'Structured Web content extraction result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'web.extract'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
web.full-audit
Run a comprehensive website audit combining SEO, security, accessibility, and performance scores with prioritized fixes.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'UrlInput', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'format': 'uri', 'maxLength': 2083, 'minLength': 1}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'seo': {'type': 'object'}, 'url': {'type': 'string'}, 'security': {'type': 'object'}, 'performance': {'type': 'object'}, 'overallScore': {'type': 'integer'}, 'accessibility': {'type': 'object'}}, 'description': 'Structured Full site audit result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'web.full-audit'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
web.links
Extract and classify links from one public page or safely crawl up to 10 same-origin pages into an agent-ready site map with page provenance, depth limits, and robots.txt enforcement.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'LinksInput', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'format': 'uri', 'maxLength': 2083, 'minLength': 1}, 'max_depth': {'type': 'integer', 'title': 'Max Depth', 'default': 1, 'maximum': 3, 'minimum': 0}, 'max_pages': {'type': 'integer', 'title': 'Max Pages', 'default': 1, 'maximum': 10, 'minimum': 1}, 'respect_robots': {'type': 'boolean', 'title': 'Respect Robots', 'default': True}, 'include_external': {'type': 'boolean', 'title': 'Include External', 'default': True}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'count': {'type': 'integer'}, 'crawl': {'type': 'object'}, 'links': {'type': 'array', 'items': {}}, 'pages': {'type': 'array', 'items': {}}, 'errors': {'type': 'array', 'items': {}}, 'origin': {'type': 'string'}, 'skipped': {'type': 'array', 'items': {}}, 'external': {'type': 'integer'}, 'internal': {'type': 'integer'}}, 'description': 'Structured Link and site-map analysis result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'web.links'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
web.metadata
Extract webpage metadata from one public URL: page title, meta description, canonical URL, headings, hreflang, icons, feeds, Open Graph, Twitter Cards, and JSON-LD Schema.org types, with redirect and response provenance plus privacy-safe, publisher-asserted Organization facts with field evidence.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'UrlInput', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'format': 'uri', 'maxLength': 2083, 'minLength': 1}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'feeds': {'type': 'array', 'items': {}}, 'icons': {'type': 'array', 'items': {}}, 'title': {'type': ['string', 'null']}, 'twitter': {'type': 'object'}, 'document': {'type': 'object'}, 'headings': {'type': 'object'}, 'language': {'type': ['string', 'null']}, 'response': {'type': 'object'}, 'canonical': {'type': ['string', 'null']}, 'openGraph': {'type': 'object'}, 'alternates': {'type': 'array', 'items': {}}, 'redirected': {'type': 'boolean'}, 'description': {'type': ['string', 'null']}, 'requestedUrl': {'type': 'string'}, 'structuredData': {'type': 'object', 'required': ['blocks', 'validBlocks', 'invalidBlocks', 'types', 'truncated', 'organizationFacts'], 'properties': {'types': {'type': 'array', 'items': {'type': 'string'}, 'uniqueItems': True}, 'blocks': {'type': 'integer', 'minimum': 0}, 'truncated': {'type': 'boolean'}, 'validBlocks': {'type': 'integer', 'minimum': 0}, 'invalidBlocks': {'type': 'integer', 'minimum': 0}, 'organizationFacts': {'type': 'object', 'required': ['status', 'method', 'scope', 'publisherAsserted', 'identityVerified', 'domainOwnershipVerified', 'legalStatusVerified', 'additionalNetworkRequestsMade', 'sourceScriptsSha256', 'vocabulary', 'scriptsSeen', 'scriptsProcessed', 'nodesSeen', 'organizationsReturned', 'organizations', 'conflicts', 'warnings', 'limits'], 'properties': {'scope': {'type': 'string'}, 'limits': {'type': 'object', 'required': ['maxScriptsProcessed', 'maxInputCharacters', 'maxObjectNodes', 'maxDepth', 'processingBudgetMs'], 'properties': {'maxDepth': {'type': 'integer', 'const': 20}, 'maxObjectNodes': {'type': 'integer', 'const': 500}, 'maxInputCharacters': {'type': 'integer', 'const': 500000}, 'processingBudgetMs': {'type': 'integer', 'const': 1000}, 'maxScriptsProcessed': {'type': 'integer', 'const': 100}}, 'additionalProperties': False}, 'method': {'type': 'string', 'const': 'apiacre-schemaorg-organization-facts/1'}, 'status': {'enum': ['none', 'complete', 'truncated', 'skipped_oversize', 'skipped_invalid_or_complex'], 'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'conflicts': {'type': 'array', 'items': {'type': 'object', 'required': ['entity', 'field', 'keptValueSha256', 'discardedValueSha256'], 'properties': {'field': {'type': 'string'}, 'entity': {'type': 'string'}, 'keptValueSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'discardedValueSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}}, 'additionalProperties': False}}, 'nodesSeen': {'type': 'integer', 'minimum': 0}, 'vocabulary': {'type': 'object', 'required': ['name', 'url', 'license', 'licenseUrl'], 'properties': {'url': {'type': 'string', 'format': 'uri'}, 'name': {'type': 'string', 'const': 'Schema.org'}, 'license': {'type': 'string', 'const': 'CC BY-SA 3.0'}, 'licenseUrl': {'type': 'string', 'format': 'uri'}}, 'additionalProperties': False}, 'scriptsSeen': {'type': 'integer', 'minimum': 0}, 'organizations': {'type': 'array', 'items': {'type': 'object', 'required': ['type', 'id', 'fields', 'evidence'], 'properties': {'id': {'type': ['string', 'null']}, 'type': {'type': 'string', 'const': 'Organization'}, 'fields': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'logo': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}, 'name': {'type': ['string', 'number', 'boolean']}, 'image': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}]}, 'sameAs': {'type': 'array', 'items': {'type': 'string'}, 'uniqueItems': True}, 'legalName': {'type': ['string', 'number', 'boolean']}, 'description': {'type': ['string', 'number', 'boolean']}}, 'additionalProperties': False}, 'evidence': {'type': 'array', 'items': {'type': 'object', 'required': ['field', 'blockIndex', 'jsonPointer', 'valueSha256'], 'properties': {'field': {'enum': ['name', 'url', 'image', 'description', 'legalName', 'logo', 'sameAs'], 'type': 'string'}, 'blockIndex': {'type': 'integer', 'minimum': 0}, 'jsonPointer': {'type': 'string'}, 'valueSha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}}, 'additionalProperties': False}}}, 'additionalProperties': False}}, 'identityVerified': {'type': 'boolean', 'const': False}, 'scriptsProcessed': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'publisherAsserted': {'type': 'boolean', 'const': True}, 'legalStatusVerified': {'type': 'boolean', 'const': False}, 'sourceScriptsSha256': {'type': ['string', 'null'], 'pattern': '^[0-9a-f]{64}$'}, 'organizationsReturned': {'type': 'integer', 'minimum': 0}, 'domainOwnershipVerified': {'type': 'boolean', 'const': False}, 'additionalNetworkRequestsMade': {'type': 'integer', 'const': 0}}, 'additionalProperties': False}}, 'description': 'Bounded JSON-LD inventory plus privacy-safe, publisher-asserted Organization facts. These facts do not verify identity, domain ownership, or legal status.', 'additionalProperties': False}}, 'description': 'Structured Webpage metadata extraction result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'web.metadata'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
web.performance-profile
Measure website response latency, payload size, compression, caching, and performance signals for a public URL.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'UrlInput', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'format': 'uri', 'maxLength': 2083, 'minLength': 1}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'bytes': {'type': 'integer'}, 'status': {'type': 'integer'}, 'elapsedMs': {'type': 'integer'}, 'compression': {'type': 'string'}, 'cacheControl': {'type': ['string', 'null']}, 'serverTiming': {'type': ['string', 'null']}}, 'description': 'Structured Performance profile result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'web.performance-profile'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
web.robots-sitemap
Inspect a domain's robots.txt crawl rules and XML sitemap health, availability, and URL count.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'UrlInput', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'format': 'uri', 'maxLength': 2083, 'minLength': 1}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'origin': {'type': 'string'}, 'robots': {'type': 'object'}, 'sitemap': {'type': 'object'}}, 'description': 'Structured Robots and sitemap audit result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'web.robots-sitemap'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
web.security-audit
Scan a public website for TLS and browser security header weaknesses and return a security score with fixes.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'UrlInput', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'format': 'uri', 'maxLength': 2083, 'minLength': 1}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'score': {'type': 'integer'}, 'missing': {'type': 'array', 'items': {}}, 'present': {'type': 'object'}, 'cookieFlags': {'type': 'object'}}, 'description': 'Structured Web security audit result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'web.security-audit'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
web.seo-audit
Audit one public URL for title, meta description, H1 count, image alt text, canonical, robots, language, Open Graph, Twitter cards, headings, hreflang, feeds, and Schema.org data; return a deterministic score and prioritized issue codes.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'UrlInput', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'format': 'uri', 'maxLength': 2083, 'minLength': 1}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'score': {'type': 'integer'}, 'issues': {'type': 'array', 'items': {}}, 'headings': {'type': 'object'}, 'metadata': {'type': 'object'}, 'wordCount': {'type': 'integer'}, 'imageCount': {'type': 'integer'}, 'imagesMissingAlt': {'type': 'integer'}}, 'description': 'Structured Technical SEO audit result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'web.seo-audit'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
web.tech-fingerprint
Identify frameworks, analytics, CDNs, servers, and other website technologies from public response signals.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'title': 'UrlInput', 'required': ['url'], 'properties': {'url': {'type': 'string', 'title': 'Url', 'format': 'uri', 'maxLength': 2083, 'minLength': 1}}}
Output schema
{'type': 'object', 'required': ['request_id', 'service', 'version', 'data', 'meta'], 'properties': {'data': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'server': {'type': 'string'}, 'poweredBy': {'type': ['string', 'null']}, 'scriptHosts': {'type': 'array', 'items': {}}, 'technologies': {'type': 'array', 'items': {}}}, 'description': 'Structured Technology fingerprint result'}, 'meta': {'type': 'object', 'required': ['duration_ms', 'cached', 'sources', 'warnings', 'next_actions'], 'properties': {'cached': {'type': 'boolean'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'duration_ms': {'type': 'integer', 'minimum': 0}, 'next_actions': {'type': 'array', 'items': {'type': 'object', 'required': ['service', 'title', 'reason', 'method', 'path', 'price', 'input_template', 'use_output', 'handoff_path', 'checkout_path', 'sample_path', 'maximum_atomic_usdc', 'handoff_payment_required', 'executes_automatically', 'authorization_required'], 'properties': {'path': {'type': 'string', 'pattern': '^/v1/'}, 'price': {'type': 'string', 'pattern': '^\\$[0-9]+'}, 'title': {'type': 'string'}, 'method': {'type': 'string', 'const': 'POST'}, 'reason': {'type': 'string'}, 'service': {'type': 'string'}, 'use_output': {'type': 'string'}, 'sample_path': {'type': ['string', 'null'], 'pattern': '^/samples/'}, 'handoff_path': {'type': 'string', 'pattern': '^/catalog/', 'description': 'Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.'}, 'checkout_path': {'type': 'string', 'pattern': '^/try/'}, 'input_template': {'type': 'object', 'description': 'Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.'}, 'maximum_atomic_usdc': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'authorization_required': {'type': 'boolean', 'const': True}, 'executes_automatically': {'type': 'boolean', 'const': False}, 'handoff_payment_required': {'type': 'boolean', 'const': False}}}, 'description': 'Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.'}}}, 'service': {'type': 'string', 'const': 'web.tech-fingerprint'}, 'version': {'type': 'string', 'const': '1'}, 'request_id': {'type': 'string', 'description': 'Unique request identifier'}}}
History
Recent tool changes
Added
crypto.typed-data-hash
Sept. 17, 2026, 12:33 p.m.
Added
crypto.calldata-decode
Sept. 17, 2026, 12:33 p.m.
Added
crypto.base-transaction-inspect
Sept. 17, 2026, 12:33 p.m.
Added
crypto.base-contract-read
Sept. 17, 2026, 12:33 p.m.
Added
crypto.base-contract-inspect
Sept. 17, 2026, 12:33 p.m.
Added
crypto.base-block-inspect
Sept. 17, 2026, 12:33 p.m.
Added
crypto.base-network-status
Sept. 17, 2026, 12:33 p.m.
Added
crypto.base-gas-estimate
Sept. 17, 2026, 12:33 p.m.
Added
crypto.base-event-logs
Sept. 17, 2026, 12:33 p.m.
Added
crypto.base-usdc-transfers
Sept. 17, 2026, 12:33 p.m.
Added
crypto.base-account-status
Sept. 17, 2026, 12:33 p.m.
Added
crypto.base-account-snapshot
Sept. 17, 2026, 12:33 p.m.
Added
crypto.address-inspect
Sept. 17, 2026, 12:33 p.m.
Added
data.timezone-convert
Sept. 17, 2026, 12:33 p.m.
Added
data.us-weather-forecast
Sept. 17, 2026, 12:33 p.m.
Added
data.current-weather
Sept. 17, 2026, 12:33 p.m.
Added
data.us-address-geocode
Sept. 17, 2026, 12:33 p.m.
Added
data.reverse-geocode
Sept. 17, 2026, 12:33 p.m.
Added
data.place-geocode
Sept. 17, 2026, 12:33 p.m.
Added
data.ecb-fx-reference
Sept. 17, 2026, 12:33 p.m.
Added
research.wikidata-organization-search
Sept. 17, 2026, 12:33 p.m.
Added
research.crossref-doi-metadata
Sept. 17, 2026, 12:33 p.m.
Added
research.crossref-work-search
Sept. 17, 2026, 12:33 p.m.
Added
research.sec-company-evidence
Sept. 17, 2026, 12:33 p.m.
Added
research.sec-financial-facts
Sept. 17, 2026, 12:33 p.m.
Added
research.sec-insider-transactions
Sept. 17, 2026, 12:33 p.m.
Added
research.sec-filing-signals
Sept. 17, 2026, 12:33 p.m.
Added
data.worldbank-snapshot
Sept. 17, 2026, 12:33 p.m.
Added
data.vin-decode
Sept. 17, 2026, 12:33 p.m.
Added
research.organization-evidence
Sept. 17, 2026, 12:33 p.m.
Discover
Similar MCP servers
Crinkl Commerce MCP
xyz.crinkl.mcp/crinkl-commerce
Processes cryptographically verified receipts and provides commerce spend, GMV, merchant, rewards, and settlement data.
apex-x1
xyz.apexfaucet/apex-x1
Provides X1 and Arc token screening, liquidity and exit-risk checks, wallet and bridge data, non-custodial token operations, comm…
Crypto Bot Audit + Market Data (x402 paid)
io.github.kaminariouji/x402-audit-agent
Audits crypto bot source code and provides paid crypto market, token, gas, stablecoin, and DeFi TVL data.
amazon-product-research-mcp
com.webotee/amazon-product-research-mcp
Researches Amazon products, brands, sellers, buy-box activity, sourcing profitability, category competition, and supplier opportu…
DeltaSignal ATLAS-7
io.github.aitrailblazer/deltasignal-atlas-7
Analyzes SEC and XBRL data for crypto-related public companies, including fundamentals, issuer signals, peer comparisons, stress …
intel
io.chainhelix/intel
Provides multi-chain market intelligence, blockchain activity metrics, trading and portfolio planning, sanctions clearance, agent…
pulsenetwork
com.theaslangroupllc.pulse/pulsenetwork
Provides paid, multi-domain intelligence endpoints covering markets, finance, crypto, compliance, healthcare, climate, education,…
Oblique Markets
markets.oblique.api/oblique-markets
Offers paid research, web extraction, agent-service routing, market analytics, Base blockchain inspection, browser evidence, and …