MCP-Server

PubFi MCP

ai.pubfi/mcp
Sonstiges Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Supports protocol discovery, initialization, listing, and execution of PubFi routes.

pubfi.capabilities.get
Return the full typed request, response, metering, and readiness contract for one exact capability id from the installed Registry generation.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'required': ['capability_id'], 'properties': {'capability_id': {'type': 'string', 'pattern': '^[a-z0-9][a-z0-9._:-]{0,127}$', 'maxLength': 128, 'minLength': 1, 'description': 'Exact capability id returned by pubfi.capabilities.list.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['schema_version', 'generation', 'manifest', 'compiled_at', 'observed_at', 'capability'], 'properties': {'manifest': {'type': 'object'}, 'capability': {'type': 'object', 'required': ['capability_id', 'route', 'provider', 'provider_key', 'provider_name', 'upstream', 'matcher', 'methods', 'request', 'response', 'credential_required', 'operations', 'readiness'], 'properties': {'route': {'type': 'object'}, 'matcher': {'type': 'object'}, 'methods': {'type': 'array', 'items': {'enum': ['GET', 'POST'], 'type': 'string'}}, 'request': {'type': 'object'}, 'provider': {'type': 'object'}, 'response': {'type': 'object'}, 'upstream': {'type': 'object'}, 'readiness': {'type': 'object'}, 'operations': {'type': 'array', 'items': {'type': 'object', 'required': ['method', 'billing'], 'properties': {'method': {'enum': ['GET', 'POST'], 'type': 'string'}, 'billing': {'oneOf': [{'type': 'object', 'required': ['mode'], 'properties': {'mode': {'const': 'pricing_unavailable'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['mode'], 'properties': {'mode': {'const': 'free_health'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['mode', 'price_policy_key', 'price_version', 'credit_cost', 'x402'], 'properties': {'mode': {'const': 'quantro_priced'}, 'x402': {'type': 'object', 'required': ['network', 'asset', 'atomic_amount', 'offer_id'], 'properties': {'asset': {'type': 'string'}, 'network': {'type': 'string'}, 'offer_id': {'type': 'string'}, 'atomic_amount': {'type': 'string'}}, 'additionalProperties': False}, 'credit_cost': {'type': 'integer', 'minimum': 1}, 'price_version': {'type': 'integer', 'minimum': 1}, 'price_policy_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}]}}, 'additionalProperties': False}, 'minItems': 1}, 'provider_key': {'type': 'string'}, 'capability_id': {'type': 'string'}, 'provider_name': {'type': 'string'}, 'free_rate_limit': {'type': ['object', 'null'], 'required': ['requests_per_window', 'window_seconds', 'max_concurrency', 'permit_ttl_seconds'], 'properties': {'quota': {'type': 'object', 'required': ['requests_per_window', 'window_seconds'], 'properties': {'window_seconds': {'type': 'integer', 'maximum': 86400, 'minimum': 1}, 'requests_per_window': {'type': 'integer', 'maximum': 9223372036854775807, 'minimum': 1}}, 'additionalProperties': False}, 'bucket_scope': {'enum': ['policy_source', 'provider'], 'type': 'string'}, 'window_seconds': {'type': 'integer', 'maximum': 86400, 'minimum': 1}, 'max_concurrency': {'type': 'integer', 'maximum': 256, 'minimum': 1}, 'permit_ttl_seconds': {'type': 'integer', 'maximum': 3600, 'minimum': 1}, 'requests_per_window': {'type': 'integer', 'maximum': 10000, 'minimum': 1}, 'total_request_limit': {'type': 'integer', 'maximum': 9223372036854775807, 'minimum': 1}}, 'additionalProperties': False}, 'credential_required': {'type': 'boolean'}}, 'additionalProperties': False}, 'generation': {'type': 'object'}, 'compiled_at': {'type': 'string'}, 'observed_at': {'type': 'string'}, 'schema_version': {'const': 'pubfi.gateway.registry.capability-detail.v5'}}, 'additionalProperties': False}
pubfi.capabilities.list
Enumerate the complete installed Registry v2 catalog as deterministic compact pages. The server does not rank, infer intent, or choose a capability.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 1000, 'minimum': 1, 'description': 'Maximum compact capability summaries to return.'}, 'cursor': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]+$', 'maxLength': 2048, 'minLength': 1, 'description': 'Opaque generation-bound cursor returned by the preceding page.'}, 'method': {'enum': ['GET', 'POST'], 'type': 'string'}, 'provider_key': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9]|-(?!-))*[a-z0-9]$|^[a-z0-9]$', 'maxLength': 64, 'minLength': 1, 'description': 'Optional exact public provider key. This is a static filter, not semantic search.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['schema_version', 'generation', 'manifest', 'compiled_at', 'observed_at', 'total_capability_count', 'matching_capability_count', 'filters', 'capabilities'], 'properties': {'filters': {'type': 'object', 'properties': {'method': {'enum': ['GET', 'POST'], 'type': 'string'}, 'provider_key': {'type': 'string'}}, 'additionalProperties': False}, 'manifest': {'type': 'object'}, 'generation': {'type': 'object'}, 'compiled_at': {'type': 'string'}, 'next_cursor': {'type': 'string'}, 'observed_at': {'type': 'string'}, 'capabilities': {'type': 'array', 'items': {'type': 'object', 'required': ['capability_id', 'provider_key', 'provider_name', 'matcher', 'methods', 'credential_required', 'operations', 'readiness'], 'properties': {'matcher': {'type': 'object'}, 'methods': {'type': 'array', 'items': {'enum': ['GET', 'POST'], 'type': 'string'}}, 'readiness': {'type': 'object'}, 'operations': {'type': 'array', 'items': {'type': 'object', 'required': ['method', 'billing'], 'properties': {'method': {'enum': ['GET', 'POST'], 'type': 'string'}, 'billing': {'oneOf': [{'type': 'object', 'required': ['mode'], 'properties': {'mode': {'const': 'pricing_unavailable'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['mode'], 'properties': {'mode': {'const': 'free_health'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['mode', 'price_policy_key', 'price_version', 'credit_cost', 'x402'], 'properties': {'mode': {'const': 'quantro_priced'}, 'x402': {'type': 'object', 'required': ['network', 'asset', 'atomic_amount', 'offer_id'], 'properties': {'asset': {'type': 'string'}, 'network': {'type': 'string'}, 'offer_id': {'type': 'string'}, 'atomic_amount': {'type': 'string'}}, 'additionalProperties': False}, 'credit_cost': {'type': 'integer', 'minimum': 1}, 'price_version': {'type': 'integer', 'minimum': 1}, 'price_policy_key': {'type': 'string', 'minLength': 1}}, 'additionalProperties': False}]}}, 'additionalProperties': False}, 'minItems': 1}, 'provider_key': {'type': 'string'}, 'capability_id': {'type': 'string'}, 'provider_name': {'type': 'string'}, 'free_rate_limit': {'type': ['object', 'null'], 'required': ['requests_per_window', 'window_seconds', 'max_concurrency', 'permit_ttl_seconds'], 'properties': {'quota': {'type': 'object', 'required': ['requests_per_window', 'window_seconds'], 'properties': {'window_seconds': {'type': 'integer', 'maximum': 86400, 'minimum': 1}, 'requests_per_window': {'type': 'integer', 'maximum': 9223372036854775807, 'minimum': 1}}, 'additionalProperties': False}, 'bucket_scope': {'enum': ['policy_source', 'provider'], 'type': 'string'}, 'window_seconds': {'type': 'integer', 'maximum': 86400, 'minimum': 1}, 'max_concurrency': {'type': 'integer', 'maximum': 256, 'minimum': 1}, 'permit_ttl_seconds': {'type': 'integer', 'maximum': 3600, 'minimum': 1}, 'requests_per_window': {'type': 'integer', 'maximum': 10000, 'minimum': 1}, 'total_request_limit': {'type': 'integer', 'maximum': 9223372036854775807, 'minimum': 1}}, 'additionalProperties': False}, 'credential_required': {'type': 'boolean'}}, 'additionalProperties': False}}, 'schema_version': {'const': 'pubfi.gateway.registry.capability-page.v5'}, 'total_capability_count': {'type': 'integer', 'minimum': 0}, 'matching_capability_count': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}
pubfi.route.execute
Execute one exact GET or POST path through the authenticated PubFi account lane and the same Registry v2 matcher and typed executor as the HTTP gateway. Append :free only when the capability catalog publishes that exact account-scoped free variant.
Destruktiv
Eingabeschema
{'type': 'object', 'required': ['raw_path', 'method'], 'properties': {'body': {'type': 'string', 'pattern': '^[\\x20-\\x7E]*$', 'maxLength': 1048576, 'description': 'Exact optional ASCII request-body bytes. For JSON routes, supply one compact serialized JSON document rather than a nested MCP argument value.'}, 'query': {'type': 'string', 'pattern': '^(?!\\?)[\\x20-\\x7E]*$', 'maxLength': 65536, 'description': 'Exact ASCII raw query string without a leading question mark.'}, 'method': {'enum': ['GET', 'POST'], 'type': 'string'}, 'raw_path': {'type': 'string', 'pattern': '^/(?!\\.{1,2}(?:/|$))[A-Za-z0-9._~-]{1,128}(?:/(?!\\.{1,2}(?:/|$))[A-Za-z0-9._~-]{1,128}){0,63}$', 'maxLength': 2048, 'minLength': 2, 'description': 'Exact original URI path consumed by the Registry matcher. Segments use canonical unreserved ASCII only; percent escapes, dot segments, query, fragment, and backslash are forbidden.'}, 'request_id': {'type': 'string', 'pattern': '^[\\x20-\\x7E]+$', 'maxLength': 256, 'minLength': 1}, 'idempotency_key': {'type': 'string', 'pattern': '^[\\x20-\\x7E]+$', 'maxLength': 256, 'minLength': 1}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['ok', 'execution_status', 'execution_authority', 'billing', 'generation', 'route', 'provider', 'upstream', 'upstream_response'], 'properties': {'ok': {'const': True}, 'route': {'type': 'object'}, 'billing': {'type': 'object', 'required': ['mode'], 'properties': {'mode': {'const': 'free_health'}}, 'additionalProperties': False}, 'provider': {'type': 'object'}, 'upstream': {'type': 'object'}, 'generation': {'type': 'object'}, 'execution_status': {'const': 'free_health_executed'}, 'upstream_response': {'type': 'object'}, 'execution_authority': {'const': 'typed_gateway_registry_v2'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['ok', 'execution_status', 'execution_authority', 'generation', 'route', 'provider', 'upstream', 'credits_charged', 'upstream_response'], 'properties': {'ok': {'const': True}, 'route': {'type': 'object'}, 'provider': {'type': 'object'}, 'upstream': {'type': 'object'}, 'generation': {'type': 'object'}, 'credits_charged': {'const': 0}, 'execution_status': {'const': 'registry_free_route_executed'}, 'upstream_response': {'type': 'object'}, 'execution_authority': {'const': 'typed_gateway_registry_v2'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['ok', 'execution_status', 'execution_authority', 'generation', 'route', 'provider', 'upstream', 'credits_charged', 'upstream_response'], 'properties': {'ok': {'const': True}, 'route': {'type': 'object'}, 'provider': {'type': 'object'}, 'upstream': {'type': 'object'}, 'generation': {'type': 'object'}, 'credits_charged': {'type': 'integer', 'minimum': 1}, 'execution_status': {'const': 'registry_route_executed'}, 'upstream_response': {'type': 'object'}, 'execution_authority': {'const': 'typed_gateway_registry_v2'}}, 'additionalProperties': False}]}
pubfi.substrate.runtime_upgrade.verify
Verify one reviewed Substrate System.apply_authorized_upgrade extrinsic through the authenticated account lane. Supply the expected Blake2b-256 hash of the FRAME System AuthorizedUpgrade code payload, not the active :code hash at the apply block. The server streams and discards provider runtime code, persists only a compact proof, and returns independent comparison evidence.
Destruktiv Externer Zugriff Idempotent
Eingabeschema
{'type': 'object', 'oneOf': [{'not': {'required': ['extrinsic_hash']}, 'required': ['extrinsic_index']}, {'not': {'required': ['extrinsic_index']}, 'required': ['extrinsic_hash']}], 'required': ['network', 'expected_authorized_code_hash'], 'properties': {'network': {'type': 'string', 'pattern': '^[a-z0-9](?:[a-z0-9_-]{0,62}[a-z0-9])?$', 'maxLength': 64, 'minLength': 1}, 'request_id': {'type': 'string', 'pattern': '^[\\x20-\\x7E]+$', 'maxLength': 256, 'minLength': 1}, 'extrinsic_hash': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$', 'maxLength': 66, 'minLength': 66, 'description': 'Canonical lowercase 0x-prefixed 32-byte hash.'}, 'extrinsic_index': {'type': 'string', 'pattern': '^(?:0|[1-9][0-9]*)-(?:0|[1-9][0-9]*)$', 'maxLength': 64, 'minLength': 3}, 'idempotency_key': {'type': 'string', 'pattern': '^[\\x20-\\x7E]+$', 'maxLength': 256, 'minLength': 1}, 'expected_authorized_code_hash': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$', 'maxLength': 66, 'minLength': 66, 'description': 'Canonical lowercase 0x-prefixed 32-byte hash.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['ok', 'execution_status', 'execution_authority', 'generation', 'route', 'provider', 'upstream', 'meter_key', 'reserved_units', 'credits_charged', 'runtime_code_bytes', 'computed_code_hash', 'expected_authorized_code_hash', 'matches', 'extrinsic_success', 'extrinsic_index', 'extrinsic_hash', 'provider_response_bytes', 'provider_response_sha256', 'upstream_status', 'upstream_latency_ms'], 'properties': {'ok': {'const': True}, 'route': {'type': 'object'}, 'matches': {'type': 'boolean'}, 'provider': {'type': 'object'}, 'upstream': {'type': 'object'}, 'meter_key': {'type': 'string'}, 'generation': {'type': 'object'}, 'extrinsic_hash': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$', 'maxLength': 66, 'minLength': 66, 'description': 'Canonical lowercase 0x-prefixed 32-byte hash.'}, 'reserved_units': {'type': 'integer', 'minimum': 1}, 'credits_charged': {'type': 'integer', 'minimum': 1}, 'extrinsic_index': {'type': 'string', 'pattern': '^(?:0|[1-9][0-9]*)-(?:0|[1-9][0-9]*)$'}, 'upstream_status': {'const': 200}, 'execution_status': {'const': 'runtime_upgrade_verification_completed'}, 'extrinsic_success': {'type': 'boolean'}, 'computed_code_hash': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$', 'maxLength': 66, 'minLength': 66, 'description': 'Canonical lowercase 0x-prefixed 32-byte hash.'}, 'runtime_code_bytes': {'type': 'integer', 'minimum': 1}, 'execution_authority': {'const': 'typed_gateway_registry_v2'}, 'upstream_latency_ms': {'type': 'integer', 'minimum': 0}, 'provider_response_bytes': {'type': 'integer', 'maximum': 67108864, 'minimum': 1}, 'provider_response_sha256': {'type': 'string', 'pattern': '^sha256:[0-9a-f]{64}$'}, 'expected_authorized_code_hash': {'type': 'string', 'pattern': '^0x[0-9a-f]{64}$', 'maxLength': 66, 'minLength': 66, 'description': 'Canonical lowercase 0x-prefixed 32-byte hash.'}}, 'additionalProperties': False}
Hinzugefügt
pubfi.substrate.runtime_upgrade.verify
17. September 2026 07:57
Hinzugefügt
pubfi.route.execute
17. September 2026 07:57
Hinzugefügt
pubfi.capabilities.get
17. September 2026 07:57
Hinzugefügt
pubfi.capabilities.list
17. September 2026 07:57