SDKs

Typed HTTP clients for the agent REST API. TypeScript @agentcell/sdk and Python agentcell. No admin routes, no JWT, SMS only.

Install

npm i @agentcell/sdk
import { AgentCell } from "@agentcell/sdk";
const client = new AgentCell({ apiKey: process.env.AGENTCELL_API_KEY });

First send

Pay, create a cell (no client_id), wait until it has an E.164 (CELL_NOT_READY until then), then POST …/messages/send. No connected handset returns 503 CARRIER_UNAVAILABLE. Simulation is e2e-only, not a product mode.

const cell = await client.cells.create({
  displayName: "support",
  areaCode: "415",
});
await client.messages.send({
  cellId: cell.cell_id ?? cell.id,
  to: "+14155550144",
  body: "Hello from my agent",
  idempotencyKey: "hello-1",
});

MCP

Prefer hosted MCP when the agent can use OAuth. Use the SDK when you want a library.

MCP integration

Common errors

PAYMENT_REQUIRED
Pay before create-cell or send.
CELL_NOT_READY
No number assigned yet.
CARRIER_UNAVAILABLE
Production fail-closed without a carrier.
FLEET_REQUIRED
Usage/analytics locked on new unpaid orgs.

Copy for Cursor / Claude

npm i @agentcell/sdk
pip install agentcell
export AGENTCELL_API_KEY=ac_...
# POST /v1/cells/{id}/messages/send
# Errors: PAYMENT_REQUIRED, CELL_NOT_READY, CARRIER_UNAVAILABLE, FLEET_REQUIRED