> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended**:
> ```bash
> npx @scalekit-inc/cli setup
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# AgentKit API reference

AgentKit's API lets your agent act in each user's apps. It sends the user to approve access, keeps their tokens, and runs tools as that user.

The API is REST over HTTPS. Requests and responses are JSON, and every request carries a bearer token. Call it with the Python or Node.js SDK, or from any language over HTTP. Each endpoint page shows all three.

A [connector](https://docs.scalekit.com/agentkit/concepts/) is the app, such as Gmail, and a connection is your configuration for it, so the REST field `connector` takes the connection name, such as `my-gmail`.

## Start here

1. [Authenticate](https://docs.scalekit.com/agentkit/reference/authentication/) with your client ID and secret.
2. Create a user's [authorization link](https://docs.scalekit.com/agentkit/reference/authorization/get-an-authorization-link/) and send them to approve.
3. [Execute a tool](https://docs.scalekit.com/agentkit/reference/tools/execute-a-tool/) as that user.

## Resources

- [Connected accounts](https://docs.scalekit.com/agentkit/reference/connected-accounts.md): Each user's link to an app: create, read, update and delete it.
- [Authorization](https://docs.scalekit.com/agentkit/reference/authorization.md): Send a user to approve access, then confirm it was them.
- [Tools](https://docs.scalekit.com/agentkit/reference/tools.md): Find the tools a user can call, and run one as that user.
- [Virtual MCP servers](https://docs.scalekit.com/agentkit/reference/virtual-mcp-servers.md): Serve a chosen set of tools to an MCP client, with a token per user.
- [Custom connectors](https://docs.scalekit.com/agentkit/reference/custom-connectors.md): Tell Scalekit how to sign in to an app that isn't in the catalog.
- [Webhooks](https://docs.scalekit.com/agentkit/reference/events.md): The events Scalekit sends to your endpoint when a connected account changes.

## Examples

### Base URL

```text
https://<your-environment>.scalekit.dev
https://<your-environment>.scalekit.com
```

Development environments end in `.scalekit.dev`, Production in `.scalekit.com`. Copy yours from **Developers** > **Settings** > **API Credentials**. See [Environments and regions](https://docs.scalekit.com/agentkit/environments/).

### SDKs

Python:

```bash
pip install scalekit-sdk-python
```

Node.js:

```bash
npm install @scalekit-sdk/node
```

Source and releases: [scalekit-sdk-python](https://github.com/scalekit-inc/scalekit-sdk-python), [scalekit-sdk-node](https://github.com/scalekit-inc/scalekit-sdk-node).

### Create a client

REST:

```bash
TOKEN=$(curl -sS "$SCALEKIT_ENVIRONMENT_URL/oauth/token" \
  -d grant_type=client_credentials \
  -d client_id="$SCALEKIT_CLIENT_ID" \
  -d client_secret="$SCALEKIT_CLIENT_SECRET" | jq -r .access_token)
```

Python:

```python
import os
from scalekit import ScalekitClient

scalekit_client = ScalekitClient(
    env_url=os.environ["SCALEKIT_ENVIRONMENT_URL"],
    client_id=os.environ["SCALEKIT_CLIENT_ID"],
    client_secret=os.environ["SCALEKIT_CLIENT_SECRET"],
)
actions = scalekit_client.actions
```

Node.js:

```ts
import { ScalekitClient } from '@scalekit-sdk/node';

const scalekit = new ScalekitClient(
  process.env.SCALEKIT_ENVIRONMENT_URL!,
  process.env.SCALEKIT_CLIENT_ID!,
  process.env.SCALEKIT_CLIENT_SECRET!,
);
const actions = scalekit.actions;
```

Next: [Authentication](https://docs.scalekit.com/agentkit/reference/authentication.md)


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |