> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corbits.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Discovery Service

> A searchable registry of Corbits-hosted APIs — for agents, developers, and anyone with a wallet

## What is Discovery?

The Corbits Discovery Service is a registry and search engine for APIs hosted on Corbits. When a merchant registers a proxy through [Marketplace](/marketplace/overview), Discovery makes that proxy findable — by developers, by AI agents, and by any programmatic client that can query the catalog.

Agents don't need API keys, accounts, or billing setups. They search Discovery, inspect an API's OpenAPI spec and pricing, then make pay-per-call requests using a crypto wallet. The [Corbits Skill](/discovery/corbits-skill) makes this even simpler — install it in Claude Code or OpenCode and your agent can search, browse, and call APIs with a few slash commands.

## Two sides of Discovery

Discovery connects two groups:

* **Merchants** — register your Marketplace proxy with Discovery so it appears in the catalog and becomes findable
* **Consumers** — search the catalog, inspect endpoints, and call APIs without any prior registration

<CardGroup cols={2}>
  <Card title="Marketplace: Register a Proxy" icon="server" href="/marketplace/control-plane/proxies">
    Build and publish your proxy so it appears in Discovery
  </Card>

  <Card title="Agents with Corbits" icon="robot" href="/discovery/agent-overview">
    See how AI agents discover and call APIs with Corbits
  </Card>
</CardGroup>

## Registering your proxy with Discovery

<Note>
  **Built a proxy in Marketplace? Register it with Discovery so people can find it.**

  Once your proxy is active in Marketplace, you can register it with the Discovery Service. Registered proxies appear in search results and expose their OpenAPI spec and per-endpoint pricing to any agent or developer querying the catalog.
</Note>

To get your proxy listed:

1. Build and activate your proxy in [Marketplace](/marketplace/control-plane/proxies)
2. Submit it for listing — see [Marketplace Proxies](/marketplace/control-plane/proxies)

Once listed, your proxy is immediately visible in Discovery search results.

## How agents discover and consume APIs

<Steps>
  <Step title="Search">
    Agents query the Discovery API or use the [Corbits Skill](/discovery/corbits-skill) to search for APIs by name, category, or capability. Results include pricing, endpoint descriptions, and OpenAPI specs.
  </Step>

  <Step title="Evaluate">
    Each listed proxy exposes its full OpenAPI specification. Agents inspect available endpoints, request/response schemas, and per-endpoint pricing before making a call.
  </Step>

  <Step title="Call and pay">
    The x402 protocol handles payment negotiation automatically. The agent's wallet signs a payment, the facilitator settles it on-chain, and the API responds — all in a single round-trip.
  </Step>
</Steps>

## Ways to access Discovery

<CardGroup cols={3}>
  <Card title="Corbits Skill" icon="terminal" href="/discovery/corbits-skill">
    Interactive discovery and calling from Claude Code or OpenCode
  </Card>

  <Card title="Discovery API" icon="code" href="/discovery/discovery-api">
    REST endpoints for programmatic search, listing, and OpenAPI spec retrieval
  </Card>

  <Card title="MCP Integration" icon="plug" href="/discovery/mcp/overview">
    Model Context Protocol servers for agent-native API consumption
  </Card>
</CardGroup>