Agent Interface Reference

Hosted MCP

Public API Schema

Generic MCP Tools

ToolPurposePublic input fields
pubfi.capabilities.searchSearch PubFi’s capability catalog for routeable crypto data needs. This returns read-only catalog metadata and does not call upstream providers or consume request allowance.query, required_capabilities, categories
pubfi.route.planCreate a dry-run PubFi route plan from an intent, objective, chains, categories, or required capabilities. This is read-only and does not call upstream providers, execute routes, or consume request allowance.intent, objective, chains, categories, required_capabilities, dry_run
pubfi.route.executeExecute a selected PubFi capability route using route-planning evidence from pubfi.route.plan. This requires a PubFi API key, may consume request allowance, and rejects provider-specific route ids outside the generic capability surface.route_id, route_plan, arguments, idempotency_key, request_id
pubfi.route.explainExplain the routing decision PubFi would make for an intent. This read-only diagnostic returns reason codes, filters, and selected route metadata without executing providers or consuming request allowance.intent, objective, chains, categories, required_capabilities, dry_run
pubfi.schema.getReturn PubFi MCP input and output schema details for a named tool, especially pubfi.route.execute. This is read-only and intended for agent setup and validation before planning or execution.tool
Durable provider-specific public tools are rejected. Provider identity belongs in route-result data, not tool names.

Auth

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.