MCP server de Agent Middleware
Commit 12 nov 2026Proporciona una pasarela segura para las llamadas de herramientas de agentes mediante permisos firmados, claves de idempotencia y recibos verificables fuera de línea.
También conocido como agentmiddleware/agent-middleware
- Stars
- 1
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 12 nov 2026
- Licencia
- Apache-2.0
¿Qué es Agent Middleware MCP?
Agent Middleware es un MCP server. Proporciona una pasarela segura para las llamadas de herramientas de agentes mediante permisos firmados, claves de idempotencia y recibos verificables fuera de línea.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Agent Middleware
Asegurar acciones críticas de agentes, como reembolsos, pagos o despliegues, es la función principal del middleware para agentes. Actúa como una pasarela situada frente a herramientas de riesgo para garantizar que cada invocación siga una gobernanza estricta. Los desarrolladores pueden usar esto como una pasarela local a través de un Makefile o conectar un cliente MCP a un endpoint alojado utilizando una clave API pasada en el header X-API-Key.
El sistema se basa en varios conceptos fundamentales para mantener el control. Utiliza permisos (permits), que son concesiones firmadas que definen herramientas específicas, presupuestos y tiempos de expiración, y claves de idempotencia para evitar solicitudes duplicadas. Cada llamada exitosa genera un recibo firmado que contiene hashes de la solicitud y la respuesta, lo que permite la verificación fuera de línea. Esta configuración está diseñada para desarrolladores que necesitan gestionar llamadas a herramientas con consecuencias mediante un protocolo estructurado en lugar de una ejecución directa.
Qué puedes hacer con él
- 1Prevención de transacciones financieras duplicadasGarantiza que un pago o reembolso se procese solo una vez, incluso si el agente reintenta la solicitud.
- 2Verificación de resultados de herramientas fuera de líneaComprueba la validez del resultado de una llamada a una herramienta utilizando un registro firmado sin necesidad de una conexión en vivo.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Configuración
AMW_API_KEYAMW_WALLET_ID
| Nombre | Descripción | Tipo |
|---|---|---|
| AMW_API_KEY | — | |
| AMW_WALLET_ID | — |
Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibleagentmiddleware/agent-middleware is public and reachablegithub.com/agentmiddleware/agent-middleware ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-11-12github.com/agentmiddleware/agent-middleware ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubAgent Middleware
Agent Middleware is a gateway you put in front of an agent's risky tools (refunds, payouts, deploys) so each action needs a signed permit, runs at most once per request key, and leaves a signed receipt anyone can check offline.
Status: Pre revenue, pre release, solo maintained. There are no paying customers or production deployments to point to. We are looking for design partners with one real consequential tool. Install from source; nothing is published to PyPI or npm.
Try it in 3 minutes
Use the hosted demo. Get a demo key at the demo key page. The example also needs the associated wallet ID.
Connecting an MCP client to the hosted endpoint https://api.agentmiddleware.dev/mcp? Get an API key and send it as the X-API-Key header.
git clone https://github.com/agentmiddleware/amw-demo.git
cd amw-demo
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
export AMW_API_KEY='<your key>'
export AMW_WALLET_ID='<your wallet id>'
python examples/permit_echo_retry.py
The example creates a permit, calls the reference echo tool, retries with the same key, and checks the receipt offline.
Run it locally
Use the gateway Makefile to start a local gateway. QUICKSTART.md has the full walk through.
git clone https://github.com/agentmiddleware/agent-middleware
cd agent-middleware/gateway
make quickstart
Concepts
- Permit: A signed grant that limits an agent to specified tools, a budget, and an expiry.
- Call: A governed MCP tool invocation under a permit.
- Request key: The
Idempotency-Keyheader that identifies a request for retry handling. - Receipt: A signed record of a call's outcome and hashes of its request and response, with a debit link when applicable.
- Credits: Internal metering units, not money.
Guarantees and limits
- a retry with the same key returns the original receipt instead of dispatching again
- a new key is a new request
- Reusing a key with a different request fails with a conflict before dispatch.
- A
delivery_uncertainreceipt means no trustworthy answer came back. The debit is kept, and the operator must reconcile with the downstream tool. The gateway does not resend automatically. - The gateway limits dispatch and debit per key, but remote effects depend on the tool honoring the forwarded key. A receipt signs request and response hashes, not raw tool content, and cannot prove a remote effect happened. This is not exactly once.
Read Security Limitations before relying on the gateway for a consequential action.
Repo map
This repository holds the reference gateway, protocol spec, SDKs,
integrations, and design-partner pilot loop (start with
QUICKSTART.md). The separate agent-middleware-api
repository is outside this checkout; partner evaluation guidance is here.
| Path | What it contains |
|---|---|
| gateway/ | Gateway implementation and local Makefile |
| sdk/ | Python and TypeScript client and verification code |
| verifier/ | Offline verification guide and vector checker |
| spec/ | Draft permit, receipt, and key formats |
| integrations/ | Framework wrappers and adapters |
| examples/ | Runnable examples and MCP client config |
| amw-demo | Hosted demo client and receipt verifier |
| amw-paypal-agent-demo | PayPal agent demo |
Apache 2.0 (gateway is Fair Source, FSL-1.1)
Preguntas sobre Agent Middleware MCP
¿Qué sucede si reintento una solicitud con la misma clave?
Un reintento con la misma clave devolverá el recibo original en lugar de ejecutar la acción nuevamente.
¿Puede la pasarela demostrar que realmente ocurrió un efecto remoto?
No, el recibo firma los hashes de la solicitud y la respuesta en lugar del contenido bruto de la herramienta, por lo que no puede probar que haya ocurrido un efecto remoto.
¿Qué es un recibo 'delivery_uncertain'?
Este estado significa que no se recibió una respuesta confiable; el débito se mantiene y el operador debe realizar una conciliación manual con la herramienta de destino.