MCP Server

PubFi MCP

ai.pubfi/mcp
Other Public & reachable MCP 2025-11-25

What this MCP does

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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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.
Read only Idempotent
Input schema
{'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}
Output schema
{'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.
Destructive
Input schema
{'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}
Output schema
{'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.
Destructive Open world Idempotent
Input schema
{'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}
Output schema
{'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}
Added
pubfi.substrate.runtime_upgrade.verify
Sept. 17, 2026, 7:57 a.m.
Added
pubfi.route.execute
Sept. 17, 2026, 7:57 a.m.
Added
pubfi.capabilities.get
Sept. 17, 2026, 7:57 a.m.
Added
pubfi.capabilities.list
Sept. 17, 2026, 7:57 a.m.