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

# Quickstart

> Install the Keenable CLI, log in, wire the MCP server into your agents, and run your first search.

Keenable provides web search and content access for AI agents. There are three ways in — for an agent, **MCP is the recommended one**; the CLI wires it up and searches from the terminal, and the REST API is there when you want to call the endpoints directly.

<Columns cols={3}>
  <Column>
    <Card title="MCP" icon="plug" href="/mcp-server">
      Add tools to your agent — the recommended path
    </Card>
  </Column>

  <Column>
    <Card title="CLI" icon="rectangle-terminal" href="/cli">
      Search from the terminal, and configure MCP in one command
    </Card>
  </Column>

  <Column>
    <Card title="REST API" icon="code" href="/api-reference">
      Call the endpoints directly over HTTP
    </Card>
  </Column>
</Columns>

Install the CLI with your preferred method:

<CodeGroup>
  ```bash Homebrew theme={"system"}
  brew install keenableai/tap/keenable-cli
  ```

  ```bash macOS / Linux theme={"system"}
  curl --proto '=https' --tlsv1.2 -LsSf \
    https://github.com/keenableai/keenable-cli/releases/latest/download/keenable-cli-installer.sh \
    | sh
  ```

  ```powershell PowerShell theme={"system"}
  irm https://github.com/keenableai/keenable-cli/releases/latest/download/keenable-cli-installer.ps1 | iex
  ```
</CodeGroup>

Then authenticate — this stores your credentials so every command and every MCP client the CLI configures below picks them up:

```bash theme={"system"}
keenable login
```

To give your agents web search, set up MCP. The CLI can configure it for all supported agents in one command:

```bash theme={"system"}
keenable configure-mcp --all
```

This sets up Claude Code, Cursor, Windsurf, and other detected clients. See [MCP](/mcp-server) for manual setup.

Once installed, run a search straight from the terminal:

```bash theme={"system"}
keenable search "AI news" -p
```

## Prefer raw HTTP?

The REST API is a first-class way in — no CLI, no MCP. `POST` your query with your key in the `X-API-Key` header:

```bash theme={"system"}
curl -X POST "https://api.keenable.ai/v1/search" \
  -H "X-API-Key: keen_<your_key>" \
  -H "Content-Type: application/json" \
  -d '{ "query": "typescript best practices" }'
```

See the [API reference](/api-reference) for every endpoint, the keyless `/public` twins, and playgrounds you can call with your own key. For an agent, though, MCP is the smoother path — it hands the tools to the model directly rather than leaving it to compose HTTP calls.

That's it. See [authentication](/authentication) for API keys and [rate limits](/rate-limits) for the request caps that apply.