# PubFi Agents

> Concise entry guide for using public PubFi Discovery and runtime resources.

This page is an index. Follow the linked Markdown guides for detailed public content and the live interfaces for current runtime facts.
Format: text/markdown; charset=utf-8
Private-data rule: account usage, API keys, billing state, provider credentials, and supplier procurement records are not public data.

## Start Here
- [Homepage Markdown](https://pubfi.ai/index.md): public. Concise Markdown overview of how PubFi separates source discovery, live contracts, route selection, and execution.
- [About PubFi](https://pubfi.ai/about.md): public. Markdown overview of PubFi's platform boundary, intended users, and explicit non-goals.
- [Contact PubFi](https://pubfi.ai/contact.md): public. Verified email task paths for product and API questions, partnership and integration inquiries, and account or support help.
- [Developer entry points](https://pubfi.ai/developers.md): public. Markdown integration loop for the live catalog, exact capability detail, Runtime OpenAPI, hosted MCP, and execution lanes.
- [Products overview](https://pubfi.ai/products.md): public. Markdown index of Discovery, Registry-backed API access, hosted MCP, custom delivery, and editorial provider guides.
- [Authentication guide](https://pubfi.ai/auth.md): public. Markdown guide to public reads, account API keys, MCP OAuth, account-bound free routes, and accountless x402.
- [Pricing and access guide](https://pubfi.ai/pricing.md): public. Markdown guide to current public, registered-account Credit, accountless x402, and custom-delivery access paths.
- [PubFi public docs](https://docs.pubfi.ai): public. Public documentation for PubFi concepts, quickstarts, runtime boundaries, agent setup, examples, and claim-safety rules.
- [AI Catalog](https://pubfi.ai/.well-known/ai-catalog.json): public. AI Catalog manifest that references the public MCP Server Card and the runtime OpenAPI document.
- [Agent Resource Descriptor](https://pubfi.ai/.well-known/ard.json): public. Ora-compatible route for the same AI Catalog manifest and entries.
- [MCP Server Card](https://pubfi.ai/.well-known/mcp/server-card.json): public. Public MCP Server Card for the hosted PubFi MCP endpoint and its supported discovery artifacts.
- [Agents guide](https://pubfi.ai/agents.md): public. Markdown guide for agents using PubFi public docs, Registry v2, Runtime OpenAPI, hosted MCP, API-key or OAuth execution, and explicit accountless x402 HTTP or MCP routes.
- [LLMs index](https://pubfi.ai/llms.txt): public. Concise index of public PubFi pages, documentation, Discovery exports, and integration resources.
- [Developer LLM index](https://pubfi.ai/developers/llms.txt): public. Compact OpenAPI, Registry, MCP, authentication, pricing, and execution entry point.
- [PubFi Discovery full export](https://pubfi.ai/llms-full.txt): public. Expanded Discovery export generated from checked-in public catalog records and publication gates.
- [PubFi Discovery directory Markdown](https://pubfi.ai/discovery.md): public. Agent-readable Markdown mirror for the canonical crypto data API directory and non-brand query-to-page map.
- [Discovery capability-card JSON](https://pubfi.ai/discovery/agent-capabilities.json): public. Editorial Discovery source cards with source schemas, provenance, and freshness metadata. This is not the executable Registry catalog.
- [Registry v2 catalog](https://api.pubfi.ai/v1/capabilities): public. Public view of the installed Registry generation, exact route matchers, methods, typed policies, and current readiness.
- [PubFi Runtime OpenAPI](https://pubfi.ai/openapi.json): public. OpenAPI 3.1 schema for PubFi runtime HTTP routes, including capability, gateway, account, billing, usage, and MCP surfaces.
- [MCP protected-resource metadata](https://mcp.pubfi.ai/.well-known/oauth-protected-resource): public. OAuth protected-resource metadata for the current hosted MCP endpoint.
- [OAuth authorization-server metadata](https://mcp.pubfi.ai/.well-known/oauth-authorization-server): public. Authorization-server metadata for the issuer named by the protected resource.
- [PubFi Discovery](https://pubfi.ai/discovery): public. Public crypto API directory with provider, chain, category, capability, commercial, and claim-safe status metadata.

## Safe Integration Order
1. Read Discovery or a linked public guide to understand source context and the intended workflow.
2. Walk the complete live Registry catalog and fetch exact capability detail for the operation you may use.
3. Confirm the matching Runtime OpenAPI request, response, method, readiness, and billing contract.
4. Select one documented access lane, enforce its auth or payment boundary, and send only the exact route request.

## Authority And Boundaries
- This response observed a live Registry snapshot. Use the linked catalog and OpenAPI for the exact current route contract.
- Discovery and blog content provide public source-selection context. They do not establish provider routeability, ranking, or execution capability.
- The active signed Registry generation and matching Runtime OpenAPI own current paths, methods, schemas, readiness, provider identity, and billing facts.
- The AI Catalog and MCP Server Card point to public machine artifacts; they do not duplicate the runtime capability catalog.
- If the live Registry is unavailable, do not infer a call from an old example, a Discovery record, or an incomplete catalog page.

## Access Lanes
- Public reads cover public documentation, Discovery, and the published capability list/detail surfaces.
- Registered-account execution uses a PubFi API key only when the live capability permits that lane.
- Hosted MCP OAuth and accountless x402 are separate explicit lanes; inspect the linked guides and current challenge before use.
- Custom delivery is separately agreed and is not implied by a public page or source listing.

## Public Runtime Guides
- [Gateway quickstart](https://docs.pubfi.ai/getting-started/quickstart): public. API-key authentication, gateway headers, route selection, and response boundaries.
- [API reference](https://docs.pubfi.ai/reference/api-reference): public. Runtime HTTP methods, request bodies, response schemas, and auth requirements.
- [Accountless x402](https://docs.pubfi.ai/getting-started/x402): public. Explicit payment challenge, signed retry, settlement, and account boundary.
- [PubFi Runtime OpenAPI](https://pubfi.ai/openapi.json): public. OpenAPI 3.1 schema for executable PubFi HTTP routes, request bodies, response schemas, auth requirements, and route-level details.

## Discovery Topic Guides
- [Crypto Data API Directory For AI Agents](https://pubfi.ai/discovery/topic/crypto-data-api-for-ai-agents.md): public. Public Discovery topic guide for crypto data API for AI agents. It is source-selection context, not proof of PubFi execution.
- [CoinGecko Alternatives for Crypto Data APIs](https://pubfi.ai/discovery/topic/coingecko-alternatives.md): public. Public Discovery topic guide for CoinGecko alternatives. It is source-selection context, not proof of PubFi execution.
- [MCP Crypto Data API Directory For AI Agents](https://pubfi.ai/discovery/topic/mcp-crypto-data-api.md): public. Public Discovery topic guide for MCP crypto data API. It is source-selection context, not proof of PubFi execution.
- [x402 Crypto Data API Directory For AI Agents](https://pubfi.ai/discovery/topic/x402-crypto-data-api.md): public. Public Discovery topic guide for x402 crypto data API. It is source-selection context, not proof of PubFi execution.
- [Polkadot Governance API Source Fit](https://pubfi.ai/discovery/topic/polkadot-governance-api.md): public. Public Discovery topic guide for Polkadot governance API. It is source-selection context, not proof of PubFi execution.
- [Wallet Labels API Directory For AI Agents](https://pubfi.ai/discovery/topic/wallet-labels-api.md): public. Public Discovery topic guide for wallet labels API. It is source-selection context, not proof of PubFi execution.
- [TypeScript Crypto Data API Directory For Developers](https://pubfi.ai/discovery/topic/typescript-crypto-data-api.md): public. Public Discovery topic guide for TypeScript crypto data API. It is source-selection context, not proof of PubFi execution.

## Blog Markdown
- [PubFi Discovery: A Searchable Knowledge Layer for Crypto Data APIs](https://pubfi.ai/blog/pubfi-discovery-searchable-knowledge-layer-for-crypto-data-apis.md): public. PubFi Discovery; PubFi Discovery is a searchable knowledge layer for crypto data APIs, built for developers comparing source fit and agents retrieving capability boundaries before execution.
  HTML: https://pubfi.ai/blog/pubfi-discovery-searchable-knowledge-layer-for-crypto-data-apis

## Contact
- [Contact PubFi](https://pubfi.ai/contact.md): Verified task paths for product and API questions, partnership and account help through hello@pubfi.ai.