# AgentCell
- Hosted cellphones for AI agents. SMS included. Console is observe + pay + connect; agents create and send via API, MCP, or CLI.
- $229 setup / $79 monthly. No per-message SMS fee. No SMS top-up.
- POST /cells does not return a number. Wait until phone_number is set (typically 1–72h). Do not pass client_id on cell create.
- Send: POST /v1/cells/{id}/messages/send. SMS body only. Phone offline → 503 CARRIER_UNAVAILABLE.
- Append .md to any public doc URL for markdown of that page
- MCP: https://mcp.agentcell.store/mcp (agent-scoped; no admin tools)
- Docs MCP: https://agentcell.store/docs/_mcp/server
- Onboarding: https://agentcell.store/docs/agent-onboarding
- API: https://api.agentcell.store/v1
- Contact: connor@divine.games

## Docs
- [Docs home](https://agentcell.store/docs): Human vs agent paths, popular guides, and machine-readable exports.
- [Welcome](https://agentcell.store/docs/welcome): Product vision, org → pods → cells, and how AgentCell differs from CPaaS.
- [Quickstart](https://agentcell.store/docs/quickstart): Sign up, verify, pay, create a cell, attach a webhook, send the first SMS.
- [Agent onboarding](https://agentcell.store/docs/agent-onboarding): Canonical playbook for an AI agent from zero to first send and receive.
- [Cells](https://agentcell.store/docs/guides/cells): Fleet CRUD for dedicated phone identities: create, list, health, multi-cell.
- [Messages](https://agentcell.store/docs/guides/messages): Send and receive SMS with idempotency and labels. MMS is not available yet.
- [Conversations](https://agentcell.store/docs/guides/conversations): Threading model, conversationState, and between-number lookups.
- [Drafts](https://agentcell.store/docs/guides/drafts): Human-in-the-loop create and send workflow for outbound SMS.
- [Labels](https://agentcell.store/docs/guides/labels): Message state: unread, spam, and campaign tags.
- [Lists](https://agentcell.store/docs/guides/lists): Allow and block policy by direction and list type.
- [Ignore lists](https://agentcell.store/docs/guides/ignore-lists): STOP / opt-out at cell or pod scope with auto_ignore_on_stop.
- [Pod cycle send](https://agentcell.store/docs/guides/pod-cycle-send): Round-robin campaigns across a pod at 1 message per second per cell.
- [Pods](https://agentcell.store/docs/guides/pods): Multi-tenant isolation, nested resources, and pod operations.
- [Webhooks](https://agentcell.store/docs/guides/webhooks): Signed event delivery, retries, and event types.
- [WebSockets](https://agentcell.store/docs/guides/websockets): WSS subscribe to the real-time event stream.
- [Billing](https://agentcell.store/docs/guides/billing): Tiers, invoices, Stripe checkout, and console pay.
- [Machine payments](https://agentcell.store/docs/guides/machine-payments): x402 and MPP for agent-autonomous payment and prepaid balance.
- [Console login](https://agentcell.store/docs/guides/console-login): Human magic link and phone OTP. Console is observe + pay + connect.
- [Agent activity](https://agentcell.store/docs/guides/agent-activity): Status, activity log, and connections in the owner console.
- [Compliance](https://agentcell.store/docs/guides/compliance): User-owned 10DLC/TCPA, quiet hours, STOP handling, and first-message rules.
- [MCP](https://agentcell.store/docs/integrations/mcp): Hosted MCP URL (primary) or local npx -y @agentcell/mcp, OAuth or API key, tool catalog.
- [CLI](https://agentcell.store/docs/integrations/cli): npm i -g @agentcell/cli — Go binary shim and command tree.
- [SDKs](https://agentcell.store/docs/integrations/sdk): TypeScript @agentcell/sdk and Python agentcell for the agent REST API.
- [Skills](https://agentcell.store/docs/integrations/skills): Cursor plugin and editor skills for onboard, messaging, billing, and CLI.
- [API](https://agentcell.store/docs/reference/api): REST base URL, bearer auth, and resource index.
- [OpenAPI](https://agentcell.store/docs/reference/openapi): Machine-readable OpenAPI 3.1 spec download.
- [Errors](https://agentcell.store/docs/reference/errors): Stable error envelope and codes such as PAYMENT_REQUIRED and TCPA_QUIET_HOURS.
- [Rate limits](https://agentcell.store/docs/reference/rate-limits): Per-cell, conversation streak, and pod cycle throttling.
- [Pagination](https://agentcell.store/docs/reference/pagination): limit + page_token (10/25/50) on lists; message history time cursors.
- [Idempotency](https://agentcell.store/docs/reference/idempotency): client_id on pods/drafts/cycle; Idempotency-Key on sends. Not on cell create.
- [WebSockets](https://agentcell.store/docs/reference/websockets): AsyncAPI event types for WSS /v1/events/stream.
- [FAQ](https://agentcell.store/docs/faq): Pricing, ownership, 10DLC, console vs API, admin vs console login.
- [Changelog](https://agentcell.store/docs/changelog): Reverse-chronological releases and API breaking changes.
- [Ownership](https://agentcell.store/ownership): You own the phone, SIM, and number while the cell is active.

## Errors
- VALIDATION_ERROR (400): Fix the request body.
- PAYMENT_REQUIRED (402): Settle Stripe, x402, or MPP.
- X402_INVALID_PAYMENT (402): Signature did not verify.
- X402_SETTLEMENT_FAILED (402): Retry settlement.
- MPP_CHALLENGE_EXPIRED (402): Request a new challenge.
- MPP_INVALID_CREDENTIAL (402): Credential rejected.
- MPP_SETTLEMENT_FAILED (402): Retry MPP settlement.
- PREPAID_INSUFFICIENT (402): Prepaid balance too low.
- NOT_VERIFIED (403): Complete agent verify.
- CONSOLE_LINK_INVALID (401): Create a new login link.
- CONSOLE_LINK_EXPIRED (401): Create a new login link.
- CONSOLE_CHALLENGE_RATE_LIMITED (429): Slow OTP requests.
- CONSOLE_PHONE_NOT_FOUND (404): Must be sign-up human_phone.
- RATE_LIMITED (429): Honor Retry-After.
- CONVERSATION_STREAK_LIMIT (429): Wait for a reply.
- OUTBOUND_LIMIT_REACHED (429): Daily cap.
- CARRIER_REJECTED (422): Carrier refused the message.
- CARRIER_UNAVAILABLE (503): The cell’s phone is offline. Retry when health is online.
- IGNORED_RECIPIENT (422): Number is ignored.
- TCPA_QUIET_HOURS (422): Outside pod quiet hours.
- CELL_NOT_READY (409): Cell has no E.164 yet; poll health.
- PHONE_NOT_ASSOCIATED (409): No phone on this workspace or pod.
- FLEET_REQUIRED (403): New accounts cannot read usage/analytics until purchase or a cell exists.
- MMS_NOT_SUPPORTED (400): SMS only; MMS is later.
- RESTART_NOT_SUPPORTED (501): Remote restart is not available.
- ADMIN_RADIO_OFFLINE (503): Operator setup messaging is temporarily unavailable.
- INVALID_CLAIM (400): Device claim token was invalid or expired.
- FACILITATOR_UNAVAILABLE (503): x402 facilitator not configured.
- CYCLE_JOB_NOT_FOUND (404): Unknown cycle job.
- PHONE_KEY_EXPIRED (401): Device API key expired.
- INVALID_CONFIRMATION (400): Provisioning confirm failed.
- PROVISION_FAILED (500): Device provisioning failed.

## Exports
- llms.txt: https://agentcell.store/docs/llms.txt
- llms-full.txt: https://agentcell.store/docs/llms-full.txt
- OpenAPI JSON: https://agentcell.store/docs/openapi.json
- OpenAPI YAML: https://agentcell.store/docs/openapi.yaml
- AsyncAPI: https://agentcell.store/docs/asyncapi.json
- Docs MCP: https://agentcell.store/docs/_mcp/server