# PubFi

> Agent-readable entry index for PubFi's public Discovery, runtime, and documentation surfaces.

Official site: https://pubfi.ai
Format: text/plain; charset=utf-8

## Start Here
- [Agents guide](https://pubfi.ai/agents.md): Concise integration order, authority boundaries, access lanes, topic guides, and blog Markdown companions.
- [AI Catalog](https://pubfi.ai/.well-known/ai-catalog.json): AI Catalog manifest that references the public MCP Server Card and runtime OpenAPI.
- [Agent Resource Descriptor](https://pubfi.ai/.well-known/ard.json): Ora-compatible alias of the same AI Catalog manifest.
- [Developer LLM index](https://pubfi.ai/developers/llms.txt): Compact runtime, Registry, MCP, authentication, pricing, and execution entry point.
- [MCP Server Card](https://pubfi.ai/.well-known/mcp/server-card.json): Public machine-readable metadata for the hosted PubFi MCP endpoint.
- [Discovery directory](https://pubfi.ai/discovery): Canonical source-selection directory for crypto data APIs and related workflows.
- [Discovery directory Markdown](https://pubfi.ai/discovery.md): Detailed Markdown directory with source classes, topic map, and publication boundaries.
- [Full Discovery export](https://pubfi.ai/llms-full.txt): Detailed generated export with published source, hub, comparison, topic, and live Registry sections.
- [Partners](https://pubfi.ai/partners): Public partner overview and institutional context.
- Partnership inquiries start a conversation; they do not create a partnership or make an API live through PubFi.

## Runtime Interfaces
- [Registry v2 catalog](https://api.pubfi.ai/v1/capabilities): Live execution authority for installed generation, exact capabilities, route matchers, methods, policies, and readiness.
- [Runtime OpenAPI](https://pubfi.ai/openapi.json): OpenAPI document for executable PubFi HTTP routes and their request and response contracts.
- [Hosted MCP manifest](https://pubfi.ai/.well-known/mcp.json): MCP discovery manifest for the hosted endpoint.
- [MCP protected-resource metadata](https://mcp.pubfi.ai/.well-known/oauth-protected-resource): OAuth protected-resource metadata for the current hosted MCP endpoint.
- [OAuth authorization-server metadata](https://mcp.pubfi.ai/.well-known/oauth-authorization-server): Authorization-server metadata for the issuer named by the protected resource.

## When to use PubFi
- Use Discovery to collect public source evidence and compare source fit.
- Inspect the complete live Registry and matching OpenAPI before execution.
- Choose the documented HTTP or MCP lane only after you verify its contract, authentication, and billing mode.
- Discovery does not imply that a source or route is executable through PubFi.

## Public Guides
- [Homepage Markdown](https://pubfi.ai/index.md): Concise Markdown overview of how PubFi separates source discovery, live contracts, route selection, and execution.
- [About PubFi](https://pubfi.ai/about.md): Markdown overview of PubFi's platform boundary, intended users, and explicit non-goals.
- [Contact PubFi](https://pubfi.ai/contact.md): 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): Markdown integration loop for the live catalog, exact capability detail, Runtime OpenAPI, hosted MCP, and execution lanes.
- [Products overview](https://pubfi.ai/products.md): Markdown index of Discovery, Registry-backed API access, hosted MCP, custom delivery, and editorial provider guides.
- [Authentication guide](https://pubfi.ai/auth.md): 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): Markdown guide to current public, registered-account Credit, accountless x402, and custom-delivery access paths.
- [PubFi public docs](https://docs.pubfi.ai): Public documentation for PubFi concepts, quickstarts, runtime boundaries, agent setup, examples, and claim-safety rules.
- [Agent Resource Descriptor](https://pubfi.ai/.well-known/ard.json): Ora-compatible route for the same AI Catalog manifest and entries.
- [Developer LLM index](https://pubfi.ai/developers/llms.txt): Compact OpenAPI, Registry, MCP, authentication, pricing, and execution entry point.
- [PubFi Discovery full export](https://pubfi.ai/llms-full.txt): Expanded Discovery export generated from checked-in public catalog records and publication gates.
- [PubFi Discovery directory Markdown](https://pubfi.ai/discovery.md): 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): Editorial Discovery source cards with source schemas, provenance, and freshness metadata. This is not the executable Registry catalog.
- [MCP protected-resource metadata](https://mcp.pubfi.ai/.well-known/oauth-protected-resource): OAuth protected-resource metadata for the current hosted MCP endpoint.
- [OAuth authorization-server metadata](https://mcp.pubfi.ai/.well-known/oauth-authorization-server): Authorization-server metadata for the issuer named by the protected resource.

## 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): 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 article: https://pubfi.ai/blog/pubfi-discovery-searchable-knowledge-layer-for-crypto-data-apis

## Reading And Execution Boundary
- Use Discovery and public guides for source context, workflow selection, and claim-safe documentation.
- Use the live Registry catalog and matching OpenAPI for current paths, methods, schemas, readiness, provider identity, and billing facts.
- Do not infer PubFi execution from a Discovery record, blog article, old example, or incomplete catalog page.
- Public exports exclude private account data, provider credentials, supplier procurement records, and non-public operational evidence.
- Choose one documented access lane and re-check the live contract before making a request.

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