agentdraft-mcp — servidor MCP para AgentDraft

Un servidor MCP que expone AgentDraft — la API de operaciones para agentes de IA con bandeja de entrada, calendario sin conflictos y herramientas de auditoría — como un conjunto de herramientas que cualquier cliente de IA compatible con MCP puede invocar.

Úsalo si tu runtime de agente es Claude Desktop, Claude Code, Cursor, Cline, una aplicación de OpenAI Agents SDK, o cualquier otro host MCP. El servidor es un envoltorio ligero alrededor del SDK de Python agentdraft — misma autenticación, mismos errores, misma semántica que la API REST y los SDK de lenguaje.

Instalación

pip install agentdraft-mcp

Requiere Python 3.10+ y una clave de agente avs_live_… válida del panel de AgentDraft.

Related MCP server: Labradoc MCP Server

Actualización

pip install -U agentdraft-mcp

Notas de la versión: https://agentdraft.io/changelog

Configura tu cliente MCP

agentdraft-mcp está en PyPI, así que una vez instalado, la configuración JSON a continuación funciona en cualquier host MCP de inmediato — sin descargas adicionales.

Claude Desktop / Claude Code — configuración JSON (recomendada)

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o el equivalente en Windows/Linux:

{
  "mcpServers": {
    "agentdraft": {
      "command": "agentdraft-mcp",
      "env": {
        "AGENTDRAFT_API_KEY": "avs_live_..."
      }
    }
  }
}

Cursor / Cline / host stdio genérico

{
  "mcpServers": {
    "agentdraft": {
      "command": "python",
      "args": ["-m", "agentdraft_mcp"],
      "env": {
        "AGENTDRAFT_API_KEY": "avs_live_..."
      }
    }
  }
}

Para desarrollo local contra un backend de desarrollo, también establece AGENTDRAFT_BASE_URL=http://localhost:8080.

Claude Desktop — Extensión de Escritorio .mcpb (arrastrar y soltar)

Cada versión también incluye un paquete de Extensión de Escritorio .mcpb en GitHub Releases. Arrastra agentdraft-mcp.mcpb a Claude Desktop → Configuración → Extensiones y pega tu clave API avs_live_… — sin editar JSON, sin pip install.

Herramientas

Todas las horas son cadenas ISO 8601 (2026-06-01T14:00:00Z). Todas las herramientas de escritura aceptan una idempotency_key para reintentos seguros. create_hold y commit_booking también aceptan un title y invitee opcionales ({name, email, notes}) que registran para quién es el espacio — visible para el propietario en el panel.

Cómo se manifiestan los conflictos

Cuando dos agentes compiten por el mismo espacio, exactamente uno gana. Los agentes perdedores reciben un payload estructurado de superado — no un error de cadena:

{
  "error": "outranked",
  "winning_booking_id": "bkg_…",
  "winning_agent_id": "agt_…",
  "winning_agent_priority": 1,
  "your_priority": 3,
  "message": "Your booking was outranked. Read winning_agent_id and propose an alternate slot rather than retrying."
}

Tu agente debe ramificarse en esto y proponer una alternativa, no reintentar el mismo espacio.

En qué se diferencia de los SDK de AgentDraft

Usa el SDK cuando tú estés escribiendo el agente. Usa este servidor MCP cuando el runtime de agente de otra persona (Claude Desktop, Cursor, Cline, host MCP genérico) necesite llamar a AgentDraft en nombre de un usuario sin código personalizado.

Enlaces

• Especificación del protocolo: https://agentdraft.io/spec

• Documentación de la API: https://agentdraft.io/docs

• Registro de cambios: https://agentdraft.io/changelog

• SDK de Python: agentdraft

• SDK de TypeScript: agentdraft

• Código fuente: https://github.com/ryabinski-labs/agentdraft-mcp

• Problemas: https://github.com/ryabinski-labs/agentdraft-mcp/issues

Seguridad

¿Encontraste una vulnerabilidad? Consulta SECURITY.md. No abras un problema público para un informe de seguridad.

Contribuciones

Consulta CONTRIBUTING.md. ryabinski-labs/agentdraft-mcp es un espejo publicado de un directorio en el repositorio de aplicaciones privado de AgentDraft — los problemas y las solicitudes de extracción se leen allí y regresan a través de la próxima sincronización de versión.

Licencia

MIT — consulta LICENSE.