# Pebble

> Pebble is a small-software platform: AI agents write tiny internal tools
> as plain folders, `pebble ship` deploys each one into its own isolated
> Firecracker microVM in under a second, and teammates use them from a
> link after Google sign-in. Built for small groups (a team, a family,
> a 10-200 person company), not internet scale.

## What makes it different

- Tools are real code written by your AI agent — not a form builder.
- No per-seat pricing; viewers are free.
- One microVM per tool: hardware-level isolation, not shared containers.
- Outbound network is blocked by default; tools declare egress and the
  human shipping approves the exact allowlist diff.
- Tools sleep when idle and wake on click (~2.4s) or on their own cron
  schedule; data persists across sleeps, versions, and restores.
- Sharing works like a document: whole org, or named people.

## For AI agents: connect via MCP

Pebble is an MCP server. Agents can operate it directly — no human
terminal steps:

- Remote (recommended): add `https://shippebble.com/mcp` as an MCP connector /
  remote server. OAuth sign-in happens automatically (discovery via
  /.well-known/oauth-authorization-server, dynamic client
  registration, PKCE).
- Local: after `pebble login`, run the CLI as a stdio MCP server
  with `pebble mcp`.
- Tools exposed: get_contract (fetch the build rules), ship_tool
  (deploy files to a live URL), share_tool, list_tools, get_logs,
  restore_version.
- Typical flow: get_contract -> write the tool -> ship_tool ->
  share_tool. Egress changes require explicit human approval
  (ship_tool returns the diff; retry with approve_egress=true after
  the human confirms).

## Key pages

- [Home](https://shippebble.com/): what Pebble is
- [Get started](https://shippebble.com/start): connect your AI (MCP) or install the
  CLI, then build and ship a first tool

## Facts

- Ship to live URL: 0.59 seconds (measured).
- Cold start from sleep: 2.4 seconds (measured).
- Tool contract: a folder with run.sh (HTTP server on $PORT), optional
  pebble.toml for memory, egress allowlist, and cron schedules.
- Status: early access.