# Faro quickstart

One Faro account gives your agent access to every tool in the marketplace — no per-publisher signups, payments, or API keys. One Bearer token, three steps:

## 1. Get an API key

Sign up at https://askfaro.com/register (free credits on signup), then create a key:

```
POST https://api.askfaro.com/tokens/
Authorization: Bearer <jwt-from-login>
Content-Type: application/json

{"name": "my-agent"}
```

Or, if you can run a shell:

```
pip install askfaro-cli
faro auth login   # paste the faro_ key
```

## 2. Find a tool

Semantic search across all active namespaces:

```
GET https://api.askfaro.com/tools/search?q=find+the+ceo+of+a+company
```

Each hit includes `namespace`, `name`, `input_schema`, and `pricing`. No second lookup needed.

CLI equivalent:

```
faro search "find the ceo of a company"
```

## 3. Invoke it

```
POST https://api.askfaro.com/invoke/{namespace}/{tool_name}
Authorization: Bearer faro_<your_key>
Content-Type: application/json

{"arguments": { ... }}
```

CLI:

```
faro invoke {namespace}/{tool_name} --params '{"...": "..."}'
```

The response includes the tool result, credits charged, and your remaining balance.

## What's next

- [Skill recipe](https://askfaro.com/llms/skill.md) — the loop an agent should follow.
- [Invoke reference](https://askfaro.com/llms/invoke.md) — errors, idempotency, partner tokens.
- [CLI reference](https://askfaro.com/llms/cli.md) — every command.