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

# Discovering endpoints

> Find available premium APIs and their pricing.

AgentCash can discover what endpoints are available on any compatible origin, along with their pricing and schemas.

## Search for a capability

When you don't know which origin to use, start with `search`. It takes a natural-language query and returns ranked providers along with endpoint details and pricing.

> Use AgentCash to search for an API that can send physical mail.

Or from the CLI:

```bash theme={null}
npx agentcash search "send physical mail"
```

Skip `search` when the task clearly maps to a registered origin. For example, people research maps to `stableenrich.dev` and image generation maps to `stablestudio.dev`. In that case, go straight to `discover` below.

## Discover endpoints on an origin

Ask your agent:

> Discover available endpoints on stableenrich.dev using AgentCash.

Or use the CLI:

```bash theme={null}
npx agentcash discover https://stableenrich.dev
```

This fetches the discovery document from the origin and returns a list of endpoints with their descriptions and pricing.

## Known origins

AgentCash ships with a set of pre-indexed origins:

| Origin             | Description                                                      |
| ------------------ | ---------------------------------------------------------------- |
| `stableenrich.dev` | Company and contact enrichment via Apollo, Exa, Serper, and more |
| `stablesocial.dev` | Social media data (Instagram, TikTok, YouTube, Reddit, Facebook) |
| `stablestudio.dev` | Image and video generation                                       |
| `stableupload.dev` | File hosting                                                     |
| `stableemail.dev`  | Email sending                                                    |

These are available immediately without needing to discover them first.

## Check a specific endpoint

To inspect a single endpoint's pricing and schema without paying:

> Check the schema for POST [https://stableenrich.dev/api/company/lookup](https://stableenrich.dev/api/company/lookup) using AgentCash.

Or via CLI:

```bash theme={null}
npx agentcash check https://stableenrich.dev/api/company/lookup
```

This returns:

* **Price**: how much the call costs in USDC
* **Methods**: which HTTP methods are supported
* **Input schema**: expected request body format
* **Output schema**: response format
* **Auth type**: whether it uses x402, SIWX, or other auth

## Discovery protocol

Servers advertise their endpoints as an OpenAPI document at `/openapi.json`. Each paid operation carries an `x-payment-info` block with price, currency, and accepted protocols (`x402`, `mpp`). AgentCash parses this to build the endpoint index.

If `/openapi.json` is missing, AgentCash falls back to `/.well-known/x402` for older servers. Either path makes the server discoverable.

See [server discovery](/discovery) if you're building a server and want to be listed.