Quickstart

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

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 for scopes and expiry.

Call the API

Read the agents you can see.

curl https://api.impellabs.tech/api/v1/agents \
  -H "Authorization: Bearer YOUR_API_KEY"

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:

[
  {
    "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.

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.

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": {}}}'

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.

Choose a client

Most assistants connect with the MCP address and a sign-in. See connect an assistant and the page for your client.

How ImpelLabs works
API overview and the API reference
Webhooks to hear about events
Add knowledge so agents can answer

Get started

Concepts

Next