Proporciona un proxy sin código para MCP servers que implementa la aplicación de políticas, control mediante intervención humana (human-in-the-loop) y registros de verificación a prueba de manipulaciones.
También conocido como dev-prathap/ATTEST, attest-proxy, attestlayer
- Stars
- 1
- Herramientas
- —
- Descargas, 30 días
- 104
- Última versión
- 0.1.0
- Último commit
- 24 sept 2026
- Licencia
- MIT
¿Qué es Attest proxy MCP?
Proporciona un proxy sin código para MCP servers que implementa la aplicación de políticas, control mediante intervención humana (human-in-the-loop) y registros de verificación a prueba de manipulaciones.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Attest proxy
El proxy de Attest ofrece una solución sin código para asegurar MCP servers mediante la aplicación de políticas y el control mediante intervención humana. Actúa como una capa intermedia que decide si se permite una acción, se pausa para obtener aprobación humana cuando es necesario y utiliza la verificación por lectura para garantizar que el éxito reportado por un agente coincida con el estado real del sistema de registro. Esta configuración permite a los desarrolladores añadir una capa de responsabilidad a los agentes de IA sin tener que reescribir la lógica de sus herramientas actuales.
Los usuarios pueden implementar esto a través de los SDK de Python o TypeScript o utilizando el proxy frente a cualquier MCP server. El sistema mantiene un registro encadenado por hashes y a prueba de manipulaciones que registra cada acción con niveles de verificación específicos, como verified, acknowledged o unverified. Mientras que el SDK es de código abierto bajo la licencia MIT, Attest Cloud ofrece una versión gestionada con registros compartidos, políticas organizativas y exportaciones de cumplimiento. El proxy garantiza que los tokens sensibles de los proveedores permanezcan dentro de tu proceso, ya que a la nube solo se envían hashes y vistas previas.
Qué puedes hacer con él
- 1Forzar la aprobación humana para acciones sensiblesUn desarrollador puede configurar el proxy para pausar la ejecución de un agente y esperar a que un humano apruebe o edite los parámetros antes de enviar un comando.
- 2Verificar las acciones del agente contra datos realesPuedes usar el sistema para comprobar si un agente actualizó correctamente un CRM leyendo los datos directamente desde la fuente.
- 3Auditar el comportamiento del agente con un registro seguroMantén un registro a prueba de manipulaciones de todas las actividades del agente para detectar cuándo una herramienta reporta éxito pero el sistema subyacente no logra actualizarse.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Attest proxy MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Attest proxy MCP en Claude Code
$ claude mcp add --env 'SLACK_BOT_TOKEN=<YOUR_SLACK_BOT_TOKEN>' attest-proxy -- uvx attestlayerInstalar Attest proxy MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"attest-proxy": {
"command": "uvx",
"args": [
"attestlayer"
],
"env": {
"SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>"
}
}
}
}Instalar Attest proxy MCP en VS Code
.vscode/mcp.json
{
"servers": {
"attest-proxy": {
"type": "stdio",
"command": "uvx",
"args": [
"attestlayer"
],
"env": {
"SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>"
}
}
}
}Instalar Attest proxy MCP en VS Code CLI
$ code --add-mcp '{"name":"attest-proxy","type":"stdio","command":"uvx","args":["attestlayer"],"env":{"SLACK_BOT_TOKEN":"<YOUR_SLACK_BOT_TOKEN>"}}'Instalar Attest proxy MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"attest-proxy": {
"command": "uvx",
"args": [
"attestlayer"
],
"env": {
"SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>"
}
}
}
}Instalar Attest proxy MCP en Codex
$ codex mcp add attest-proxy --env 'SLACK_BOT_TOKEN=<YOUR_SLACK_BOT_TOKEN>' -- uvx attestlayerInstalar Attest proxy MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.attest-proxy] command = "uvx" args = ["attestlayer"] [mcp_servers.attest-proxy.env] SLACK_BOT_TOKEN = "<YOUR_SLACK_BOT_TOKEN>"
Instalar Attest proxy MCP en Gemini CLI
$ gemini mcp add -s user -e 'SLACK_BOT_TOKEN=<YOUR_SLACK_BOT_TOKEN>' attest-proxy uvx -- attestlayerInstalar Attest proxy MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"attest-proxy": {
"command": "uvx",
"args": [
"attestlayer"
],
"env": {
"SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>"
}
}
}
}Configuración
SLACK_BOT_TOKENSecretoSlack bot token for confirm cards
ATTEST_AUTO_APPROVEATTEST_INBOX_URLURL of the confirm inbox (attest serve) linked from Slack cards
ATTEST_LEDGERLedger SQLite path (default .attest/ledger.sqlite)
ATTEST_POLICYPath to a policy YAML
ATTEST_SLACK_CHANNELSlack channel for confirm cards
| Nombre | Descripción | Tipo |
|---|---|---|
| SLACK_BOT_TOKEN | Slack bot token for confirm cards | Secreto |
| ATTEST_AUTO_APPROVE | — | |
| ATTEST_INBOX_URL | URL of the confirm inbox (attest serve) linked from Slack cards | |
| ATTEST_LEDGER | Ledger SQLite path (default .attest/ledger.sqlite) | |
| ATTEST_POLICY | Path to a policy YAML | |
| ATTEST_SLACK_CHANNEL | Slack channel for confirm cards |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibledev-prathap/attest is public and reachablegithub.com/dev-prathap/attest ↗Aprobado
- El paquete indica este repositorio como su origenattestlayer names dev-prathap/attest as sourcepypi.org/project/attestlayer/ ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-09-24github.com/dev-prathap/attest ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from attestlayerAprobado
- No hay avisos críticos en el paquete ni en sus dependencias7 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- 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 GitHubAttest — prove what your AI agent actually did
Decide → Gate → Verify → Attest. Your agent sends the email, updates the CRM, moves the money. Attest decides whether it may, gates it behind a human when it matters, reads back from the system of record to check it actually happened, and records tamper-evident evidence either way.
Attest never executes your action. Your tool does. That is why it works with any app and any framework on day one.
Your agent says it worked. Did it?
Two identical CRM writes, both reported success by the tool, both approved by a human:
$ attest ledger
#2 2026-09-19 10:16:46 someweirdcrm.create → leads ask approved unverified a09e7641db12
#1 2026-09-19 10:16:46 someweirdcrm.create → leads ask approved verified 77a6d99a60f6
The second one read back clean. The first did not, and the ledger says which field disagreed:
{ "level": "unverified", "matched": false,
"evidence": { "compared": 4, "exists": true, "failed": ["stage"],
"fields": { "stage": { "want": "qualified", "got": "new", "ok": false } } } }
A trace would have shown two green steps. That gap is the entire product.
Install
pip install attestlayer # Python
npm install attestlayer # TypeScript — byte-identical ledger format
import attest
@attest.action(system="gmail", verb="send", target="to")
def send_email(to, subject, body): ...
import { Attest } from "attestlayer";
const at = new Attest({ agent: "followup-agent@v3", readers: { gmail: process.env.GMAIL_TOKEN! } });
const sendEmail = at.wrap({ system: "gmail", verb: "send", target: "to" },
async ({ to, subject, body }) => gmail.send({ to, subject, body }));
That is the whole change. The first external send now pauses for a human, and the ledger row says
acknowledged, or verified once Attest can read back with the agent's own credentials
(Attest(readers={"gmail": service})). Nothing else in your code moves.
Verification is layered, and it never overstates
Every row states exactly how much was checked. A check that could not run is never dressed up as a pass.
| level | what it means |
|---|---|
verified |
read back from the system of record, and the fields matched |
verified-custom |
your own check ran and passed |
acknowledged |
the action was accepted, but no read-back could run here |
attested-only |
recorded with no verifier available for this action |
unverified |
a check ran and contradicted the claim |
Only a contradiction earns unverified. Missing credentials, a read-only scope or an unsupported verb
degrade to acknowledged, because "we could not check" and "it did not happen" are different facts.
Where it plugs in
| surface | how |
|---|---|
| Decorator / wrapper | @attest.action(...) · at.wrap(...) |
| LangGraph | tool node wrapper, gate as a graph interrupt |
| OpenAI Agents · Claude Agent SDK · CrewAI · DeerFlow | adapters in attest/ |
| MCP | zero-code proxy in front of any server, plus a verify server |
| HTTP gateway | point outbound traffic at it, no SDK at all |
| API only | POST the descriptor yourself |
Human confirmation lands where the team already works: Slack, the web inbox, a webhook, a LangGraph interrupt, or the console. Approvers can edit the parameters before approving, and the edit is recorded.
The record itself
Hash-chained ledger, SQLite locally and Postgres per organisation in the cloud. Signed checkpoints let
you prune old rows and still verify the chain. Optional Ed25519 signing, and external anchoring to a
file, a git repo or an HTTP endpoint. Exports: JSON, CSV, the IETF draft-sharif-agent-audit-trail
JSONL format, and an EU AI Act event-log pack.
Overhead is roughly a sixth of a millisecond per action, measured in benchmarks/ (published numbers).
Try it locally
python examples/unknown_app.py # an app Attest has never seen, L1 → L3
ATTEST_AUTO_APPROVE=1 python examples/langgraph_agent.py
cd deploy && cp .env.example .env && docker compose up # cloud API :8400 + dashboard :3400
Attest Cloud
The SDK is MIT and works standalone with a local ledger. Attest Cloud adds the shared ledger, the
confirm inbox, versioned org policy, agent keys and compliance exports. Your vendor tokens never reach
it: read-back happens in your process with your own credentials, and only hashes and previews are sent.
Self-host it from deploy/, or read DEPLOY.md.
Install channels
| where | how |
|---|---|
| PyPI | pip install attestlayer → attest, attest-mcp, attest-mcp-server, attest-gateway |
| npm | npm install attestlayer |
| MCP Registry | io.github.dev-prathap/attest (verify server) · io.github.dev-prathap/attest-proxy (zero-code proxy) |
| Smithery | attestlayer/attest |
| Claude Desktop | attest-<version>.mcpb on the latest release |
| Docker | ghcr.io/dev-prathap/attest-api · ghcr.io/dev-prathap/attest-dashboard |
Documentation
Full docs at dev-prathap.github.io/ATTEST — quickstart · verification levels · policy · read-back recipes · ledger & exports · hardening
Repository
| path | what |
|---|---|
| attest/ | Python SDK — descriptor, policy, ledger, verification ladder, gates, adapters, MCP proxy, CLI |
| packages/attest-ts/ | TypeScript SDK — same canonical hashes, fixture-tested against Python |
| cloud/ | Attest Cloud — FastAPI + Postgres: orgs, keys, policy versions, ledger, confirm inbox, exports |
| dashboard/ | Next.js dashboard — ledger drill-down, confirm inbox, policy and keys |
| examples/ | unknown app, LangGraph, OpenAI Agents, MCP config, API-only, cloud |
| deploy/ | Dockerfiles and compose |
| benchmarks/ | what the layer costs per action |
| docs/ | documentation site source, plus design notes |
pytest -q && (cd cloud && pytest -q) # 355 + 37 offline tests
pytest tests/live # 8 live suites; need real credentials, skipped without them
Contributing
Read-back recipes are the easiest place to start: each one teaches Attest how to confirm a write in one more app, and needs nothing but that app's read API. See CONTRIBUTING.md, and SECURITY.md for reporting a vulnerability.
Principles
- We never execute your action. Your tool executes; we decide, gate, verify and record.
- Coverage is universal. Verification depth is layered and stated honestly on every row.
- Open-source SDK under MIT. Paid cloud for the shared ledger, inbox, policy and exports.
Design notes
The thinking behind the product, kept in the open: vision · product · universal adapter · architecture · market · build plan · decisions · phase plan
Lineage
Attest's core mechanisms are extracted from two working codebases: DO (policy engine, read-back
verification pairs, evidence ledger) and DeerFlow (tool receipts, verification patterns, MCP and
chat-channel adapters), which run against real Gmail, Slack, HubSpot, Notion, Linear and Google
Workspace. Attest ships its own live suites for those systems in tests/live/; they
need real credentials and are skipped without them.
Preguntas sobre Attest proxy MCP
¿Cómo agrego Attest proxy MCP a Claude Code?
Ejecuta claude mcp add --env 'SLACK_BOT_TOKEN=<YOUR_SLACK_BOT_TOKEN>' attest-proxy -- uvx attestlayer en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Attest proxy MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Attest ejecuta acciones por mi agente?
No, Attest nunca ejecuta la acción por sí mismo; tu propia herramienta o agente realiza la ejecución mientras Attest gestiona la decisión, el control y la verificación.
¿Cómo verifica Attest que una acción realmente ocurrió?
Utiliza un mecanismo de lectura (read-back) desde el sistema de registro para comprobar si los campos en el sistema coinciden con la acción prevista.
¿Cuáles son los diferentes niveles de verificación?
Los niveles de verificación incluyen verified (leído y coincidente), verified-custom (pasó una comprobación personalizada), acknowledged (acción aceptada pero sin lectura posible), attested-only (registrado sin verificador) y unverified (la comprobación contradijo la afirmación).