Agent Apps
GitHubEmpezar↓

Protocolo abierto · SDK · Station · CLI

Dale aplicaciones
a tus agentes,
no solo herramientas.

Las Agent Apps son aplicaciones pensadas para agentes de IA. Les dan herramientas para actuar, interfaces para presentar información y un runtime completo que gestiona su ciclo de vida: instalar, configurar, autenticar, ejecutar y escalar.

npm create @agentapps
O usa las +80 que ya existen↓
+80 apps listas para instalarProtocolo abierto · MITCreado por Pablo López→

Funciona hoy en

Teros
Claude Code
Claude Desktop
Cursor
Windsurf
VS Code
01

El hueco

Una llamada a herramienta devuelve texto.
Una Agent App devuelve un producto.

Los agentes llevan años con llamada a funciones, es decir, el modelo elige una de tus funciones y rellena sus argumentos. Lo que nunca tuvieron fue un sitio donde poner una pantalla, guardar estado, custodiar una credencial o pasarle trabajo a otra aplicación. De eso va exactamente este protocolo.

Solo con herramientas

  • ·Texto entra, texto sale. Cada resultado es un párrafo que el agente tiene que narrar.
  • ·Sin interfaz. Las tablas, los gráficos y los formularios se aplastan hasta volverse prosa.
  • ·Sin memoria entre llamadas. El agente reconstruye el contexto cada vez.
  • ·Sin ciclo de vida. No hay nada que instalar, configurar ni contra lo que autenticarse.
  • ·Ninguna vía para que una integración hable con otra.
  • ·Un solo proceso para todo el mundo, o nada.

Con Agent Apps

  • 01 Herramientas tipadas con parámetros, permisos y resultados estructurados.
  • 02 Interfaces reales que el anfitrión renderiza de forma nativa: tarjetas, tablas, gráficos, formularios e imágenes.
  • 03 Almacenamiento que aporta la plataforma: la aplicación guarda los datos y la plataforma es su dueña.
  • 04 Un ciclo de vida gestionado, con autenticación por OAuth o clave de API y comprobaciones de estado.
  • 05 Intents, para que una aplicación pueda invocar las capacidades de otra.
  • 06 standalone, cluster u on-demand. Una instancia por usuario si te hace falta.
02

Gateway

No hace falta que adoptes
nada para empezar.

Las Agent Apps hablan su propio protocolo. Gateway es el puente que las vuelve a exponer como herramientas MCP. MCP, el Model Context Protocol, es el estándar que tu cliente ya habla para descubrir y llamar herramientas, así que ve las +80 apps como herramientas nativas. Sin fork, sin plugin y sin tocar ni una sola aplicación.

Tus apps
+80 Agent Apps

Notion, GitHub, Playwright, Calendar. Cada una con su manifiesto, sus herramientas y sus permisos.

protocol v2.0
Quién las sirve
Station

Un único endpoint. Levanta, enruta, reinicia y duerme instancias.

traduce
El puente
Gateway MCP

Habla el protocolo por un lado y MCP por el otro. Ahí está todo el truco.

mcp / stdio
Dónde trabajas
Tu cliente

Teros, Claude Code, Cursor, Windsurf, VS Code, Zed. Sin modificar.

Dos comandoszsh
# 1. start the station with every installed app$ agentapps serve 4100 station listening · 79 apps · 10 running# 2. point your MCP client at it$ claude mcp add agent-apps \ -e STATION_URL=http://localhost:4100 \ -- node /path/to/gateway-mcp/dist/index.js ✓ agent-apps connected# every tool of every installed app is now callable from the client$

Funciona hoy en

Teros
Claude Code
Claude Desktop
Cursor
Windsurf
VS Code
Instalar Gateway MCP→
03

Qué se ve por el cable

Haz una pregunta.
Mira lo que hace la aplicación.

Dices «¿tengo libre el jueves por la tarde?». El agente elige la herramienta. La aplicación responde con datos estructurados, no con prosa. Más tarde alguien mueve una reunión y la aplicación se lo cuenta al agente sin que nadie se lo pida.

app.google.calendarplano de sesión
# the agent chose the tool and the arguments. you never typed this.→ tool_call get_freebusy { "calendars": ["primary"], "timeMin": "2026-08-13T12:00Z", "timeMax": "2026-08-13T18:00Z" }← tool_result ok · 218 ms { "busy": [ { "start": "…T15:00Z", "end": "…T16:30Z" } ] }# a structured result, so the host can render a calendar strip instead of a paragraph# twenty minutes later, a colleague moves a meeting in Google Calendar← subscription_event calendar_updated { "action": "updated", "eventId": "3f9a…", "title": "Design review" }$

Lo que habría devuelto una herramienta suelta

  • 01Un párrafo que el agente tiene que interpretar y volver a narrar.
  • 02Nada cuando cambia el calendario. O vuelves a preguntar o no te enteras.
  • 03Un token por llamada, reautenticado, sin sesión que sostener.

Lo que devolvió la Agent App

  • 01JSON tipado que el anfitrión puede renderizar como una interfaz de verdad.
  • 02Un evento calendar_updated, enviado sin que nadie lo pida.
  • 03Una sesión OAuth que la plataforma custodia y refresca por ella.
04

El catálogo

+80 apps
ya escritas.

El protocolo no es una propuesta esperando a que alguien la adopte. El repositorio trae +80 aplicaciones repartidas en 22 categorías, y todas declaran sus herramientas y sus permisos en un manifiesto que valida hoy mismo.

Ver las +80→

El catálogo · las encendidas están migradas y en marcha

BashElevenLabsFilesystemGitHubGoogle CalendarNotionPerplexity AIPlaywrightReplicateSentryActiveCampaignAirtableAmplitudeAsanaBrevoBrowserbaseCalendlyCanvaClickUpCloudflareContext7DatadogDiscordDropboxExcalidrawFactorialFigmaFreshdeskVer las +80→

Por categoría

  • Productividad16
  • Desarrollo11
  • Comunicación8
  • Google7
  • IA5
  • Otras4
  • Analítica3
  • Diseño3
  • Finanzas3
  • 13 más19
05

Qué aporta una Agent App

Seis cosas que vas a usar.
Seis más cuando las necesites.

Una Agent App puede ser una sola herramienta o un producto completo con pantallas, almacenamiento, llamadas entre aplicaciones y su propio agente de IA integrado. Todo lo de abajo se declara en el manifiesto y lo hace cumplir el protocolo. Nada se deduce.

01

Herramientas

Funciones que un agente de IA puede llamar, con parámetros tipados, permisos y resultados estructurados.

02

Interfaces

Interfaz visual que el anfitrión renderiza de forma nativa: tarjetas, tablas, gráficos, formularios e imágenes. Si no puede, cae a texto o markdown.

03

Ciclo de vida

Instalar, configurar, autenticar (OAuth o clave de API), arrancar, parar y comprobar el estado.

04

Eventos

Avisos en tiempo real de la aplicación al agente: webhooks, cambios de estado y alertas.

05

Permisos

Concesiones granulares sobre qué herramientas, qué datos y qué superficies de interfaz. Las pide la aplicación y las aprueba la persona. Las pistas como destructiveHint se declaran, nunca se deducen.

06

Intents

Comunicación entre aplicaciones. Una puede invocar las capacidades de otra a través de un enlace que controlas tú.

Y cuando la aplicación crece hasta ser un producto

PantallasAlmacenamientoAgentes propiosGanchos de conversaciónVolúmenes y archivosTelemetría
06

Arquitectura

Agnóstica al transporte
por diseño.

Un anfitrión se conecta a un único endpoint de la Station. La Station levanta, enruta, reinicia y duerme las instancias de tu aplicación. Tu código nunca se pelea con transportes.

Anfitrión
La plataforma de IA

Un IDE, un asistente o un runtime de agentes que descubre, instala y usa Agent Apps en nombre de sus usuarios.

Station
Ciclo de vida y enrutado

Un único endpoint para los anfitriones. Levanta, enruta, reinicia y duerme instancias. Cuatro adaptadores de runtime, detección de caídas, apagado ordenado y particionado.

Instancias de la app
standalone · 1 compartidacluster · N réplicason-demand · 1 por usuario4 adaptadores de runtime
01InstalaronInstall · concede el consentimiento
02Configurarsecretos de sistema y de usuario
03AutenticarOAuth2 · PKCE · clave de API
04Ejecutarlevantar · enrutar · dormir
05RefrescaronRefreshToken
06ActualizaronUpgrade · onUninstall

Agent App

Tu código. Una aplicación autocontenida con herramientas, interfaces y lógica. Corre en standalone, cluster u on-demand.

Station

Gestiona el ciclo de vida de la aplicación: levanta, enruta, reinicia y duerme instancias. Expone un único endpoint al que se conectan los anfitriones. Agnóstico al transporte.

Anfitrión

La plataforma de IA (un IDE, un asistente o un runtime de agentes) que descubre, instala y usa Agent Apps en nombre de sus usuarios.

Gateway

Un puente que expone las Agent Apps a protocolos de herramientas como MCP, para que funcionen en Teros, Claude Code, Cursor, Windsurf, VS Code y Zed sin cambiar nada.

07

Escribir una tú

Generar, ejecutar, probar.
Todo en local.

Si prefieres escribir una en vez de usar una ya hecha: un REPL y una CLI para ejecutar aplicaciones en local, un banco de pruebas para tu suite y un generador que lleva una aplicación nueva hasta su primera llamada a herramienta con un solo comando.

zsh
# Requires Node >= 20, pnpm and git$ git clone git@github.com:agentapps/agentapps.git$ cd agentapps$ ./install.sh installing dependencies… building @agentapps/cli… symlinked `agentapps` → /usr/local/bin$
08

El manifiesto

Un archivo dice
lo que es la aplicación.

Cada aplicación incluye un agentapp.json que tiene que pasar safeParseAppManifest(), del paquete del protocolo. Si no valida, no se instala. Ni campos opcionales que se van de las manos ni comportamientos sin documentar.

Campos obligatorios

  • idIdentificador estable, por ejemplo app.notion
  • versionSemver, independiente del protocolo
  • nameNombre visible
  • descriptionQué hace la aplicación
  • tagline120 caracteres, límite duro
  • authorNombre y correo
  • logoSVG, o PNG de 1024×1024 como mínimo
  • logoMonoSVG a una tinta que el anfitrión recolorea
  • termsURL de los términos que aplican
  • categoryUna de las 22 en uso hoy
  • entrypointRuta del módulo y export
  • runtimeTransporte, comando y argumentos
apps/notion/agentapp.jsonválido
"id": "app.notion",
"version": "2.0.0",
"tagline": "Manage Notion pages, databases, and content",
"license": "MIT",
"category": "productivity",

"entrypoint": {
  "type": "module",
  "path": "src/app.ts",
  "export": "factory"
},
"runtime": {
  "transport": "stdio",
  "command": "tsx"
},
"auth": {
  "type": "oauth2",
  "scopes": ["read_content", "update_content"],
  "pkce": false,
  "systemSecrets": ["CLIENT_ID", "CLIENT_SECRET"],
  "userSecrets": ["ACCESS_TOKEN", "REFRESH_TOKEN"]
}
09

Paquetes

Son ocho.
Coge solo lo que necesites.

Coge solo el protocolo si vas a implementar tu propio anfitrión. Coge el SDK para escribir una aplicación. Coge la Station para ejecutarlas.

protocolEsquemas Zod, los dos planos y códigos de errorsdkEscribir una app: herramientas, ganchos, eventos e interfazstationCiclo de vida, proxy y adaptadores de runtimehostLo que integra una plataforma para consumir appsexecution-hostDesplegable independiente para instanciascliREPL y modo directo, ejecuta apps en localtestingBanco de pruebas y suite de conformidadcreateGenerar, modo desarrollo, validar y empaquetar
10

En otra parte

Dos entradas
más.

Gateway · instalación

Conecta el cliente que ya usas

Sirve las aplicaciones que tengas instaladas y apunta ahí Teros, Claude Code, Cursor o Windsurf. Seis clientes, un bloque de configuración cada uno.

Leerlo→Creador

Pablo López

Fundador, asesor de startups y la persona que construye esto. Arquitectura de software, ciberseguridad y escalado de sistemas.

Leerlo→

Empezar

Tu primera Agent App está
a un comando de distancia.

Genérala, ejecútala en el REPL y luego exponla a Teros, Claude Code, Cursor, Windsurf, VS Code o Zed a través de Gateway MCP, sin cambiar una línea.

npm create @agentapps
Leer la documentación↗Dar una estrella en GitHub↗
Agent Apps · Aplicaciones pensadas para agentes de IA