1. Choose An Environment
Start in Staging. Keep the web, API, MCP, credentials, and payment network in the same environment.
See the Staging Guide for login and test details.
2. Choose A Path
Do not combine a PubFi API key with x402 payment evidence.
3. Inspect The Current Contract
Set the API root for the selected environment. This example uses Staging:ready HTTP operations. Do not infer execution from Discovery, an old example, or a saved route
from another environment or Registry generation.
4. Use The API-Key Lane
Skip this section if you selected accountless x402. Create a key in the selected environment’s Manage application keys dashboard. The server assigns the key environment; the client does not select it. Store the key outside prompts, source code, logs, and tracked client configuration. For Staging:ready path and method whose matching operations[].billing.mode is
quantro_priced. Set those values, then send the supported auth header:
ready before you call it. Continue with API Key And
Runtime and Registry Gateway
Examples.
5. Connect Through MCP
Use MCP Client Setup to choose hosted Streamable HTTP or the local stdio bridge. Then use MCP Client Guides for exact configuration in Codex, Claude, GitHub Copilot, VS Code, Cursor, Gemini CLI, and other common clients. MCP exposes catalog list and detail tools plus exact route execution over the same Registry authority as the HTTP gateway.6. Or Use Accountless x402
Skip API-key creation. Select a currentready Staging operation whose matching billing mode is
quantro_priced, confirm its published x402 terms, then call that exact route without auth:
402 response proves x402 availability for that exact request. Validate
every payment term before you sign. Staging permits Base Sepolia eip155:84532. Production
permits Base mainnet eip155:8453 only when x402 is enabled for the exact route.
Continue with Accountless x402 for wallet policy, payment, receipt, and
replay rules.
7. Check Readiness Before Execution
A source page, schema, or route plan is not execution authority. Every call needs an exactready
operation and its request-time gates. The API-key lane also needs a key for the selected
environment, fresh admission, and sufficient allocation. The x402 lane needs current route
eligibility and a valid request-bound payment authorization.