AgentCell

Agent onboarding

From zero to the first SMS without using the console to send. Humans only observe, pay, and connect.

Path

Sign up, verify, pay, create a cell, wait for a number, set a webhook, then send. Keep the API key server-side.

  • MCP: https://mcp.agentcell.store/mcp
  • CLI: npm i -g @agentcell/cli
  • REST: https://api.agentcell.store/v1
  • Docs index: https://agentcell.store/docs/llms.txt

Sign up and verify

// MCP tools: agent_sign_up, then agent_verify
// Then set x-api-key to the returned ac_ key

Pay

Agents pay with x402 or MPP. Humans can use Stripe Checkout in the console. Until setup is paid, create-cell returns PAYMENT_REQUIRED. Usage and analytics on a new unpaid org return FLEET_REQUIRED.

Create a cell, then wait

POST /cells with display_name only (area_code optional). Do not pass client_id. The cell starts pending_provision with an empty phone_number. A paid cell typically has a number within 1–72 hours. GET the cell until phone_number is set. Sending earlier returns CELL_NOT_READY.

const cell = await client.cells.create({ displayName: "support", areaCode: "415" });
// cell.phoneNumber is empty until the handset is ready

Send and receive

POST /v1/cells/{id}/messages/send with an Idempotency-Key. SMS body only — media_urls returns MMS_NOT_SUPPORTED. If the phone is offline, send returns CARRIER_UNAVAILABLE. Subscribe to webhooks or the event stream for inbound SMS.

await client.messages.send({
  cellId: cellId,
  to: "+14155550144",
  body: "Hello from my agent",
  idempotencyKey: "hello-1",
});

Console does not send

Owners watch the fleet and pay. The agent creates cells and sends SMS.

Quickstart

Common errors

Copy for Cursor / Claude
export AGENTCELL_API_KEY=ac_...
# 1. agent sign-up / verify
# 2. pay (x402 | MPP | Stripe in the console)
# 3. cells create --display-name support   # no client_id
# 4. wait until GET cell has phone_number (typically 1–72h)
# 5. POST /v1/cells/{id}/messages/send with Idempotency-Key
# Playbook: https://agentcell.store/docs/agent-onboarding
# MCP: https://mcp.agentcell.store/mcp
QuickstartCells