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

# Quickstart

> Make a token, call the API and connect an assistant.

You will make a token, read your agents with the API and list the tools of your Chief of Staff over MCP.

**1. Make a token**

Sign in to the ImpelLabs app. In Settings, make an API token. Give it a name. Copy the token when it shows. It starts with `imp_` and you can see it only once.

Keep it as a secret. See [access and keys](https://docs.impellabs.tech/guides/access-and-keys.md) for scopes and expiry.

**2. Call the API**

Read the agents you can see.

```bash curl theme={null}
curl https://api.impellabs.tech/api/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```javascript fetch theme={null}
const res = await fetch("https://api.impellabs.tech/api/v1/agents", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const agents = await res.json();
```

The answer is a list. Each agent has `id`, `kind`, `name`, `status`, `live_version` and more:

```json theme={null}
[
  {
    "id": "AGENT_ID",
    "kind": "company",
    "name": "Front desk",
    "status": "active",
    "live_version": 3,
    "latest_version": 3,
    "unpublished_changes": false
  }
]
```

The list holds the agents you may read, and your Chief of Staff. The example shows some fields only.

If the token is wrong, the answer is `401` with a message that says to make a new one.

**3. Connect over MCP**

The MCP server is at `https://api.impellabs.tech/mcp`. It uses JSON-RPC over HTTP. Start with `initialize`, then list the tools.

```bash initialize theme={null}
curl https://api.impellabs.tech/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2025-06-18", "capabilities": {}}}'
```

```bash tools/list theme={null}
curl https://api.impellabs.tech/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/list"}'
```

The tools are the tools of your Chief of Staff. A tool that needs a yes does not run. It waits for you. See [approvals](https://docs.impellabs.tech/guides/approvals.md).

**4. Choose a client**

Most assistants connect with the MCP address and a sign-in. See [connect an assistant](https://docs.impellabs.tech/connect/overview.md) and the page for your client.

## Next

* [How ImpelLabs works](https://docs.impellabs.tech/guides/how-it-works.md)
* [API overview](https://docs.impellabs.tech/api/overview.md) and the API reference
* [Webhooks](https://docs.impellabs.tech/api/webhooks.md) to hear about events
* [Add knowledge](https://docs.impellabs.tech/guides/knowledge.md) so agents can answer


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.