x402-list-mcp

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['question', 'services'], 'properties': {'probe': {'type': 'object', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Slug of one listed service to probe live (must be one of the services above or another listed slug).'}, 'endpoint_path': {'type': 'string', 'maxLength': 500, 'minLength': 1, 'description': "Optional URL path on that service to probe, beginning with '/'. Omit to let the server pick the cheapest priced USDC-on-Base endpoint."}}, 'description': 'Optional live-probe request: pay one listed service for real and analyze what it returns. When the server has probing armed the price becomes $0.25 plus that endpoint price X (non-refundable); the report gains a probe_report block with a verdict and truncated extracts, never the verbatim third-party body. Ignored when probing is not armed.', 'additionalProperties': False}, 'question': {'type': 'string', 'maxLength': 1000, 'minLength': 1, 'description': 'The need to assess the shortlist against (1 to 1000 characters).'}, 'services': {'type': 'array', 'items': {'type': 'string', 'maxLength': 200, 'minLength': 1}, 'maxItems': 8, 'minItems': 1, 'description': 'Service slugs to compare for the need (1 to 8; find them with x402_search_services or x402_find_best_service).'}, 'payment_signature_b64': {'type': 'string', 'minLength': 1, 'description': 'Base64 PAYMENT-SIGNATURE for the x402 payment, produced by signing the accepts[0] challenge client-side. Omit on the first call to receive the challenge; set it on the retry to run the paid assessment.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'default': 90, 'maximum': 365, 'minimum': 1, 'description': 'Lookback window in days, 1 to 365 (default 90). Events older than the window are not in the feed.'}, 'page': {'type': 'integer', 'default': 1, 'minimum': 1, 'description': '1-based page index into the filtered event set (see total_pages).'}, 'type': {'enum': ['payto_changed', 'price_changed', 'schema_changed'], 'type': 'string', 'description': "Restrict to one kind of change: 'payto_changed' (the payout address set changed), 'price_changed' (at least one endpoint's price changed), 'schema_changed' (the 402 envelope gained or lost accepts entries or priced endpoints). Omit for all three."}, 'service': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': "Service slug to restrict the feed to, e.g. 'exa' (the same slug x402_get_service takes). Omit for changes across every listed service."}, 'per_page': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1, 'description': 'Events per page, 1 to 100 (default 25). Each event carries the full before/after envelope snapshots, so a large page is heavy.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'slug': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Service slug for a single-service health report. Omit for the whole directory.'}, 'uptime_period': {'enum': ['24h', '7d', '30d', '90d'], 'type': 'string', 'default': '30d', 'description': 'Daily uptime snapshot window for single-service mode.'}, 'include_services': {'type': 'boolean', 'default': False, 'description': 'Directory mode only (no slug): if true, also attach the full per-service status array. Off by default so a directory health check returns just the five status counts, not every service.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'default': 30, 'maximum': 90, 'minimum': 1, 'description': 'Length of the timeseries in days (only used when include_timeseries is true).'}, 'page': {'type': 'integer', 'default': 1, 'minimum': 1}, 'per_page': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1}, 'timeframe': {'enum': ['24h', '7d', '30d', 'all'], 'type': 'string', 'default': '7d', 'description': "Drives the sort order of the returned facilitators. '24h' sorts by today (UTC) so far, not by a trailing 24-hour window."}, 'include_chains': {'type': 'boolean', 'default': False, 'description': 'Include a per-chain (network/asset) volume breakdown per facilitator.'}, 'include_timeseries': {'type': 'boolean', 'default': False, 'description': 'Include a daily volume_usd / tx_count series per facilitator.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Free-text need description to match against name/description.'}, 'limit': {'type': 'integer', 'default': 5, 'maximum': 20, 'minimum': 1, 'description': 'How many ranked recommendations to return.'}, 'prefer': {'enum': ['balanced', 'cheapest', 'fastest', 'most_reliable'], 'type': 'string', 'default': 'balanced', 'description': 'Tie-breaking emphasis for the ranking weights.'}, 'network': {'type': 'string', 'maxLength': 50, 'minLength': 1, 'description': "Required network name or abbreviation, e.g. 'Base' or 'BSE'; any network code returned by /api/v1/networks is accepted."}, 'category': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Desired service category.'}, 'max_price_usd': {'type': 'number', 'minimum': 0, 'description': 'Cap on min_price_usd in US dollars; cheaper or equal passes.'}, 'require_verified': {'type': 'boolean', 'default': False, 'description': 'If true, only verified services are eligible.'}, 'include_facilitator_context': {'type': 'boolean', 'default': False, 'description': 'If true, also return top facilitators by 7d settlement volume as separate ecosystem context (NOT per-service).'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['slug'], 'properties': {'slug': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': "Service slug, e.g. 'my-api'."}, 'include_series': {'type': 'boolean', 'default': False, 'description': "If true, also attach this service's daily on-chain series under `series` (settlement volume and distinct buyers, one point per UTC day over the most recent 90 days, oldest first). Off by default to keep the response small."}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'maxLength': 200, 'minLength': 1, 'description': 'Free-text search across name, description, category, base_url.'}, 'page': {'type': 'integer', 'default': 1, 'minimum': 1, 'description': '1-based page index into the filtered result set (see meta.total_pages).'}, 'sort': {'enum': ['newest', 'uptime', 'cheapest', 'endpoints'], 'type': 'string', 'default': 'newest', 'description': 'Server-side sort order.'}, 'fields': {'enum': ['compact', 'full'], 'type': 'string', 'default': 'compact', 'description': "Response detail: 'compact' (default) = lean summaries (identity, price, status, uptime, verification, networks, compliance grade), 'full' = every field including the per-service assessment block. Compact keeps a directory sweep small enough to not truncate."}, 'status': {'enum': ['online', 'degraded', 'offline', 'unknown', 'all'], 'type': 'string', 'default': 'all', 'description': 'Filter by live monitoring status.'}, 'network': {'type': 'string', 'maxLength': 50, 'minLength': 1, 'description': "Network name or abbreviation, e.g. 'Base' or 'BSE'; any network code returned by /api/v1/networks is accepted. Omit for all."}, 'category': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Exact category name (see categories context). Omit for all.'}, 'per_page': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1, 'description': "Services per page, 1 to 100 (default 25). Higher values return larger results; with fields='full' a large page can be very heavy, so prefer compact when raising it."}, 'signable': {'type': 'boolean', 'description': 'Filter on the signability of the last observed 402 envelope: true = no EVM route of the service was observed missing the EIP-712 domain parameters (extra.name and extra.version) that a standard x402 client requires in order to sign a payment, false = at least one such route was observed. It describes the payment envelope on the wire, not the merit of the service. A service whose latest assessment has not measured that check yet matches NEITHER value, so omit this parameter to include it. Filtered server-side, so the result total covers the whole filtered set.'}, 'verified_only': {'type': 'boolean', 'default': False, 'description': 'If true, return only verified services. Filtered server-side, so the result total covers the whole verified set, not just this page.'}}, 'additionalProperties': False}