# Amba

> The agent-native backend for mobile apps. Auth, push, segments,
  content, gamification, economy, social, payments, serverless
  functions, AI prompts, queues, transactional email, and a sites
  CDN — one backend, one MCP, callable by any AI agent.

## For AI agents (preferred path)

Connect to the MCP server and provision a developer account in one tool call. No browser. No copy-paste from a console.

- MCP server: https://mcp.amba.dev/mcp
- Bootstrap tool: `amba_developer_signup` — mints a developer PAT, creates a project, returns API keys. Call this first if no token is in scope.
- Auth on subsequent calls: `Authorization: Bearer <developer-token>` (returned by the signup tool)
- OAuth 2.1 with PKCE is also supported for human-in-the-loop flows.
- Tools: 178 across 19 domains (auth, push, segments, content, gamification, economy, social, functions, ai, sites, email, queues, …)

### Sandbox tier (pre-verification, agent-provisioned)

Agents that call `amba_developer_signup` land directly on the Sandbox tier — no signup form, no credit card, no email verification gate. Limits are small but production-shaped (real DB, real API, real MCP). Upgrade by claiming the email on the account from any browser.

### Prompt to paste into your AI coding agent

```
Set up Amba (https://amba.dev) as my backend. Run `npx @layers/amba init --sandbox` and follow the instructions it prints.
```

`amba init --sandbox` signs up agentically, provisions a project, writes credentials to `.env.local` + your MCP client config, and prints a final "restart your MCP client" line — surface that to the human so the new MCP credential loads.

## For humans

- CLI (interactive): `npx @layers/amba init` — walks through signup, project creation, key minting; writes `.env.local` and `AMBA.md` to your project root.
- CLI (headless, agentic): `amba init --sandbox` — same outcome with no prompts. Also auto-wires the Amba MCP server into Claude Code, Cursor, and Windsurf configs.
- Local function dev: `amba functions dev` runs your handlers locally with hot reload on http://localhost:8787.
- Console: https://app.amba.dev — sign up with email or GitHub OAuth.

## Docs

- Quickstart: https://docs.amba.dev/docs/quickstart
- SDK reference: https://docs.amba.dev/docs/sdk
- API reference: https://docs.amba.dev/docs/api-reference
- CLI reference: https://docs.amba.dev/docs/cli
- MCP guide: https://docs.amba.dev/docs/mcp
- MCP install: https://docs.amba.dev/docs/mcp/install

## SDK packages

TypeScript (npm):

- `@layers/amba` — CLI (latest 1.0.1)
- `@layers/amba-web` — browser SDK (latest 1.0.1)
- `@layers/amba-node` — Node.js SDK (latest 1.0.1)
- `@layers/amba-react` — React hooks (latest 1.0.1)
- `@layers/amba-react-native` — bare React Native SDK (latest 1.0.1)
- `@layers/amba-expo` — Expo config plugin wrapping react-native (latest 1.0.1)
- `@layers/amba-mcp` — MCP tool registry (used by the hosted server at mcp.amba.dev)
- `@layers/amba-shared` — shared types and constants

Native:

- iOS / macOS / tvOS / watchOS: Swift Package Manager → `github.com/layers/amba-sdk-ios` (1.0.0)
- Android: Maven Central → `com.layers.amba:amba-sdk-android` (1.0.0)
- Flutter: pub.dev/packages/amba (1.0.0)
- Unity: Unity Package Manager → `github.com/layers/amba-sdk-unity` (1.0.0)

## Security

- Disclosure policy: https://amba.dev/.well-known/security.txt
- Contact: security@layers.com