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

# fetchbean: One API key for your AI agent's tools

> fetchbean routes your agent's web tool calls — search, page reading, weather, social data, and more — through one key, one base URL, and one account.

fetchbean puts a unified gateway in front of every web tool your AI agent needs. Instead of juggling separate signups, API keys, and rate limits for a dozen providers, you point your agent at `https://api.fetchbean.com`, pass your single `fb_` key, and call search, page reading, weather, social data, app intelligence, and more — all from one place. You're only charged for calls that succeed, so provider failures and timeouts cost you nothing.

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Create a key and make your first call in under two minutes.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    Learn how to pass your API key and handle auth errors.
  </Card>

  <Card title="Catalog" icon="book" href="/catalog">
    Every provider, endpoint, parameter, and per-call price.
  </Card>

  <Card title="MCP server" icon="plug" href="/guides/mcp">
    Point any MCP-compatible agent at the whole catalog through one connection.
  </Card>
</CardGroup>

## How it works

Get up and running in three steps — no provider accounts or extra configuration required.

<Steps>
  <Step title="Get an API key">
    Sign in at [fetchbean.com/app](https://fetchbean.com/app), open **API Keys**, and create a new key. Copy it immediately — it's shown only once and starts with `fb_`.
  </Step>

  <Step title="Call a curated tool">
    Use a normalized endpoint like `POST /v1/search` to get a consistent JSON response regardless of which provider powers it under the hood:

    ```bash theme={null}
    curl https://api.fetchbean.com/v1/search \
      -H "X-API-Key: $FETCHBEAN_KEY" \
      -H "Content-Type: application/json" \
      -d '{"query":"best vector databases"}'
    ```
  </Step>

  <Step title="Explore providers">
    Browse the [Providers](/concepts/providers) page to see every supported provider and reach any of them directly with `POST /v1/run` for full native responses.
  </Step>
</Steps>

## Your first call

All requests go to the base URL `https://api.fetchbean.com`. Here's a search request you can run right now:

```bash theme={null}
curl https://api.fetchbean.com/v1/search \
  -H "X-API-Key: $FETCHBEAN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"best vector databases"}'
```