Agent Interface Reference

Hosted MCP

https://mcp.pubfi.ai
https://mcp.pubfi.ai/.well-known/mcp.json

Public API Schema

https://api.pubfi.ai/openapi.json

Generic MCP Tools

ToolPurpose
pubfi.capabilities.searchFind candidate capabilities, routes, providers, schemas, source-fit evidence, freshness evidence, and readiness posture.
pubfi.route.planTurn an agent data need into a selected route, ranked candidates, rejected candidates, abstention, unsupported result, or procurement preview.
pubfi.route.executeExecute a previously planned supported PubFi capability route id, or return a fail-closed gate readback.
pubfi.route.explainReturn route reasons, hard filters, provenance evidence, redaction state, and production-gate status.
pubfi.schema.getReturn schemas for a capability, route, envelope, or planned argument set.
pubfi.pricing.quoteEstimate price, payment mode, quota impact, and budget impact before execution.
Durable provider-specific public tools are rejected. Provider identity belongs in route-result data, not tool names.

Auth

Authorization: Bearer <PubFi API key>
X-PubFi-Api-Key: <PubFi API key>
Upstream provider keys remain server-side.

Execution Rule

pubfi.route.execute should execute only a supported callable PubFi capability route id with validated planning evidence. Unsupported provider-specific route ids, non-callable plans, and paid supplier intents should fail closed with explicit reasons.