Outbox MCP server

@out-box/mcp — Outbox MCP server

Server MCP oficial de Outbox (out-box.dev), la biblioteca privada agents-first para publicar HTMLs. Expone Outbox como herramientas nativas para cualquier cliente MCP (Claude Desktop, Cursor, etc.) — sin curl ni CLI.

Es una de las 3 vías para usar Outbox desde un agente:

• CLI (outbox …) — comandos shell.
• skill outbox-publish — para agentes con skills.
• MCP (este paquete) — tools nativas en clientes MCP.

Instalación

Hay dos formas de conectarlo. Las dos exponen las mismas tools.

Claude (web, escritorio y celular) — connector remoto, sin instalar nada

En claude.ai → Settings → Connectors → Add custom connector, con la URL https://mcp.out-box.dev/mcp. Claude te manda a iniciar sesión en Outbox y a elegir los permisos (outbox:read, outbox:write, outbox:delete); no hace falta API key. Cada conexión crea una agent key "Claude connector" que podés revocar en out-box.dev → Settings → Keys.

En Claude Code: claude mcp add --transport http outbox https://mcp.out-box.dev/mcp.

Claude Desktop / Cursor / cualquier cliente stdio — vía npx

Necesitás tu API key de Outbox (outbox) y Node.js 20 o superior**. No requiere instalar nada global: el cliente MCP lo lanza con npx.

{
  "mcpServers": {
    "outbox": {
      "command": "npx",
      "args": ["-y", "@out-box/mcp"],
      "env": {
        "OUTBOX_API_KEY": "outbox_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Desde el repo (desarrollo)

git clone https://github.com/jonathanleiva15/out-box-mcp.git
cd out-box-mcp
npm install
npm run build        # compila a dist/

Y en el config usá "command": "node" con "args": ["/ruta/absoluta/al/repo/out-box-mcp/dist/index.js"] (o npm link y "command": "outbox-mcp").

💡 Tip de seguridad (entornos cloud/compartidos): usá una agent key acotada a una carpeta

(outbox keys gen-agent --folder --verbs publish,list --days 30). Si el entorno se filtra,

el blast radius es esa sola carpeta. El verbo list hace falta para que el agente pueda releer

sus páginas privadas (outboxpull); sin él, leerlas da 403 privatereadscoperequired.

Autenticación

Precedencia de la key:

1. OUTBOXAPIKEY (variable de entorno) — recomendado.
2. ~/.outboxrc — el archivo que escribe el CLI con outbox login.

La key nunca se loguea. El server no escribe ~/.outboxrc (eso lo hace el CLI). En sesiones remotas/headless el agente no puede hacer login interactivo → por eso la auth es por key.

Sin credencial el server igual arranca: cada tool que necesita auth responde un error accionable (missingcredential: "configurá OUTBOXAPIKEY…"). outboxcapabilities (público) funciona igual, y se suma outboxpublishanonymous para publicar sin cuenta (ver abajo).

Sin cuenta: outboxpublishanonymous (0.4.0)

Solo se registra cuando el server arrancó sin credencial (ni OUTBOXAPIKEY ni ~/.outboxrc). Con key no aparece: el agente publica en la biblioteca del usuario con outbox_publish.

Shortened. The full README is on GitHub.