# AgentPlaybooks

> AgentPlaybooks is an open-source MCP server for ai models and llm tooling. Keep skills, MCP references, memory and secrets in one portable playbook for any agent. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, self-hosted
- **Website:** https://agentplaybooks.ai
- **Repository:** https://github.com/matebenyovszky/agentplaybooks
- **MCP Registry name:** ai.agentplaybooks/agentplaybooks
- **Categories:** AI models and LLM tooling, knowledge and memory
- **Listing updated:** 2026-11-14

## About

The idea is a playbook as an agent's portable work profile: a persona, skills, MCP server references, canvas documents, key-value memory and credentials that agents use without seeing. One command deploys it to Claude Code, Cursor, Codex, Antigravity and Hermes, and the site says it also syncs across ChatGPT, Gemini and local models.

This registry entry points at the manage endpoint, agentplaybooks.ai/api/mcp/manage over Streamable HTTP, through which an agent can read and edit the playbook. Skills can carry files or timestamped recordings of a task, aimed at agents that learn by watching, including future robots. A secret proxy tool called use_secret lets an agent use a credential without exposing it. Sharing a playbook URL gives a team consistent behaviour across platforms.

The project is open source and self-hostable, with private versioned recovery of agent configuration.

## Features

- **Portable playbook:** Persona, skills, MCP references and instructions in one place.
- **Multi-agent deploy:** One command to Claude Code, Cursor, Codex, Antigravity and Hermes.
- **Memory store:** Key-value memory across sessions.
- **Canvas documents:** Structured markdown the agent reads and writes.
- **Secret proxy:** Agents use credentials without seeing them.
- **Self-hostable:** Open source with standard formats.
- **Versioned recovery:** Private history for configuration.

## Good for

- Move agent setup between Claude Code and Cursor
- Share one playbook across a team
- Give an agent credentials without exposing them
- Back up skills and project instructions

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http agentplaybooks https://agentplaybooks.ai/api/mcp/manage
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://agentplaybooks.ai/api/mcp/manage
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "agentplaybooks": {
      "url": "https://agentplaybooks.ai/api/mcp/manage"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "agentplaybooks": {
      "type": "http",
      "url": "https://agentplaybooks.ai/api/mcp/manage"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "agentplaybooks": {
      "serverUrl": "https://agentplaybooks.ai/api/mcp/manage"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "agentplaybooks": {
      "type": "http",
      "url": "https://agentplaybooks.ai/api/mcp/manage"
    }
  }
}
```

## Tools

- `use_secret`: Lets an agent use a stored credential through the proxy without seeing it.

## FAQ

### Is it open source?

The site says it is open source and self-hostable.

### Which agents are supported?

Claude Code, Cursor, Codex, Antigravity and Hermes for deployment.

### Can agents see my secrets?

The site says credentials are used without the agent seeing them.

### Does it store memory?

Yes, key-value memory across sessions.

### Is AgentPlaybooks free?

Yes. AgentPlaybooks is open source, so you can use and self-host it for free.

### How do I add AgentPlaybooks to Claude Code?

Run this command in your terminal: claude mcp add --transport http agentplaybooks https://agentplaybooks.ai/api/mcp/manage

### What are the best alternatives to AgentPlaybooks?

The closest alternatives to AgentPlaybooks are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/agentplaybooks
