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

# Sella REST API: all endpoints for direct HTTP access

> HTTP endpoints for catalogue browsing, dataset access, agent auth, wallet management, and wallet funding. Base URL: https://sellag.vercel.app.

Agents should use the [MCP tools](/reference/mcp-tools) — that is the primary, fully-specified interface, and it handles the [x402](/reference/x402) payment handshake for you automatically. The REST surface below is useful for read-only catalogue access, building dashboards, and non-agent integrations where you want direct HTTP calls instead.

<Note>
  **Base URL:** `https://sellag.vercel.app`. Authenticated routes require `Authorization: Bearer sk_live_…`.
</Note>

## Datasets

These endpoints let you browse the catalogue and access dataset content. The `/access` endpoint mirrors `get_dataset`: free tiers return content immediately, while paid tiers return a `402` with payment instructions you replay against.

| Method | Path                                | Purpose                                                                                |
| ------ | ----------------------------------- | -------------------------------------------------------------------------------------- |
| `GET`  | `/api/datasets`                     | List and search the catalogue. Accepts `?search=`, `?tier=`, and `?limit=`. Read-only. |
| `GET`  | `/api/datasets/{id}`                | Fetch a single listing's public metadata.                                              |
| `POST` | `/api/datasets/{id}/access`         | Request full access. Free tiers return content; paid tiers return `402`.               |
| `GET`  | `/api/datasets/{id}/card.json`      | The machine-readable datacard for a listing.                                           |
| `POST` | `/api/datasets/{id}/process`        | (Publisher) Run analysis and build the datacard.                                       |
| `GET`  | `/api/datasets/{id}/publish-status` | (Publisher) Current publish state for a listing.                                       |

List the catalogue with an optional keyword filter:

```bash theme={null}
curl "https://sellag.vercel.app/api/datasets?search=market&limit=5"
```

Request access to a specific dataset (paid tiers will return a `402` challenge):

```bash theme={null}
curl -i -X POST "https://sellag.vercel.app/api/datasets/<id>/access" \
  -H "Authorization: Bearer sk_live_your_key_here"
```

## MCP

The MCP endpoint exposes all nine tools over JSON-RPC 2.0. Use this if you want to call tools directly from HTTP rather than through an MCP client library.

| Method | Path       | Purpose                                        |
| ------ | ---------- | ---------------------------------------------- |
| `POST` | `/api/mcp` | The JSON-RPC 2.0 MCP endpoint. All nine tools. |

See the [MCP tools reference](/reference/mcp-tools) for the full `tools/call` request format.

## Agent auth & account

These routes back the `sella_auth_start` and `sella_auth_complete` MCP tools. Call them directly if you are building a custom auth flow outside of MCP.

| Method | Path                         | Purpose                                                                      |
| ------ | ---------------------------- | ---------------------------------------------------------------------------- |
| `POST` | `/api/agent/auth/send-otp`   | Email a 6-digit code (backs `sella_auth_start`).                             |
| `POST` | `/api/agent/auth/verify-otp` | Verify the code and return your key + wallets (backs `sella_auth_complete`). |
| `GET`  | `/api/agent/wallets`         | Your agent's wallet addresses across all supported chains.                   |
| `GET`  | `/api/agent/usage`           | Spend and activity history.                                                  |
| `GET`  | `/api/agent/policies`        | Active policy configuration from your SKILLS.md.                             |

## API Data Market

Browse the aggregated provider catalogue and proxy calls to providers. Proxy calls are payment-gated via x402 or MPP.

| Method | Path                            | Purpose                                     |
| ------ | ------------------------------- | ------------------------------------------- |
| `GET`  | `/api/market/catalog`           | Browse the aggregated provider catalogue.   |
| `POST` | `/api/market/{provider}/{path}` | Proxy a call to a provider (payment-gated). |

## Funding

Start a funding checkout to top up your agent's wallet with USDC.

| Method | Path                    | Purpose                                      |
| ------ | ----------------------- | -------------------------------------------- |
| `POST` | `/api/funding/checkout` | Start a funding checkout to top up a wallet. |

## Content for answer engines

Sella publishes machine-readable content for LLMs and answer engines. These endpoints return structured data suitable for indexing or direct consumption by language models.

| Path                    | Purpose                                                 |
| ----------------------- | ------------------------------------------------------- |
| `/llms.txt`             | Compact site map for LLMs.                              |
| `/api/content/index`    | Full content index.                                     |
| `/api/content/glossary` | The [glossary](/reference/glossary) as structured data. |
| `/api/content/tools`    | Tool catalogue as structured data.                      |

<Tip>
  For anything transactional — buying data, running compute, calling APIs — use the [MCP tools](/reference/mcp-tools). They wrap these endpoints and handle the x402 handshake end to end, so you never have to implement the payment loop yourself.
</Tip>