Servidor MCP

PubFi MCP

ai.pubfi/mcp
Otros Público y accesible MCP 2025-11-25

Qué hace este MCP

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.
Solo lectura Idempotente
Esquema de entrada
{'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}
Esquema de salida
{'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.
Solo lectura Idempotente
Esquema de entrada
{'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}
Esquema de salida
{'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.
Destructivo
Esquema de entrada
{'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}
Esquema de salida
{'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.
Destructivo Acceso externo Idempotente
Esquema de entrada
{'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}
Esquema de salida
{'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}
Añadido
pubfi.substrate.runtime_upgrade.verify
17 de September de 2026 a las 07:57
Añadido
pubfi.route.execute
17 de September de 2026 a las 07:57
Añadido
pubfi.capabilities.get
17 de September de 2026 a las 07:57
Añadido
pubfi.capabilities.list
17 de September de 2026 a las 07:57