# Set up Veezee

Use this to wire a new agent up to Veezee's LinkedIn tools end to end.

## 0. Try it with no key (optional)

```
curl "https://api.veezee.io/v1/companies?identifier=microsoft"
```

Keyless calls share a taste allowance of 20 credits per IP per day, serve cached data only (no realtime), and need no Idempotency-Key. Everything past a taste needs the free trial key below.

## 1. Add the MCP server

```
https://mcp.veezee.io/mcp
```

transport: streamable-http. No key needed yet; `provision` works unauthenticated. Pre-2025 clients that only speak the legacy HTTP+SSE transport: `https://mcp.veezee.io/sse`.

## 2. Provision a key

Call the `provision` tool (or `POST https://api.veezee.io/v1/provision`) with no arguments. Store the returned `api_key`; it is shown exactly once. You also get a `claim_url` to keep the account past the trial.

## 3. Authenticate

- MCP: once you've called `provision` in the current session, later tool calls authenticate automatically.
- REST: send `Authorization: Bearer <api_key>` on every call after provision.

## 4. First real call

```
curl "https://api.veezee.io/v1/profiles?identifier=williamhgates" \
  -H "Authorization: Bearer $VEEZEE_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
```

## 5. REST fallback

Every MCP tool has a matching REST route with identical semantics; see https://veezee.io/openapi.json. Metered REST calls need an `Idempotency-Key` header, even on GET.

## 6. SDK and CLI (optional, Node 20+)

`npm install @veezee/sdk`: a typed client for every tool with retries and Idempotency-Keys built in. `npm install -g @veezee/sdk` also gives the `veezee` CLI. Docs: https://veezee.io/docs/sdk and https://veezee.io/docs/cli.

## 7. When credits run out

Errors a payment can fix carry an account-bound `upgrade_url` (`provision` and `get_usage` return it too). Give that link to your human: purchases credit your account directly with no login, and you continue after payment with the same key.

## 8. Where docs live

- Tool reference: https://veezee.io/docs
- Per-client install snippets: https://veezee.io/docs/clients
- Worked use-case recipes: https://veezee.io/use-cases/candidate-sourcing (also prospect-enrichment, company-research)
- Field reference: https://veezee.io/docs/fields
- Pricing + calculator: https://veezee.io/pricing
- OpenAPI: https://veezee.io/openapi.json
- SDK and CLI: https://veezee.io/docs/sdk, https://veezee.io/docs/cli
- Non-obvious rules: https://veezee.io/AGENTS.md