Installation

STACK can be used via MCP tools, REST API, or SDK. Choose the method that fits your workflow.

MCP Server (Recommended)

The fastest way to start. Works with Claude Code, Cursor, Windsurf, and any MCP-compatible client.

bash

claude mcp add stack --transport http https://mcp.getstack.run/mcp --header "Authorization: Bearer sk_live_YOUR_KEY"

JavaScript / TypeScript SDK

Zero-dependency SDK for Node.js, Deno, Bun, and browsers.

bash

npm install @stack/sdk

typescript

import { Stack } from '@stack/sdk';

const stack = new Stack({ apiKey: 'sk_live_...' });

const agent = await stack.agents.register({ name: 'my-agent' });
const passport = await stack.passports.issue({ agent_id: agent.id });
const cred = await stack.credentials.get('slack');

Python SDK

Sync and async clients using httpx.

bash

pip install getstack

python

from getstack import Stack

stack = Stack(api_key="sk_live_...")

agent = stack.agents.register("my-agent")
passport = stack.passports.issue(agent_id=agent.id)
cred = stack.credentials.get("slack")

REST API

Direct HTTP calls to https://api.getstack.run.

bash

curl -X POST https://api.getstack.run/v1/agents/register \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'

Authentication

All API requests require a Bearer token in the Authorization header. You can use an operator API key (sk_live_...) or a team member key.