mcpserver.lol
registry/agentplaybooks
Connection check verified live · 20h ago deprecated

agentplaybooks

Manage portable AI agent playbooks, Agent Skills, MCP configurations, personas, and memory.

Tools 49
GitHub stars 5
Installs / wk
Licence MIT
Transport streamable-http
Last checked 20h ago

Tools & capabilities

49 tools

Read from the running server on 20h ago.

archive_memories keystagsfrom_tierplaybook_id*older_than_hoursgenerate_summaries
Archive memories from the working or contextual tier into longterm. Entries are kept, not deleted; filters (keys, tags, from_tier, older_than_hours) combine as AND. Requires memory…
call_connected_tool can modify data argumentsserver_id*tool_name*playbook_id*
Call a tool on one of this playbook's connected MCP or OpenAPI servers. Arguments are forwarded as-is and the result mirrors the connected tool, including any side effects that too…
consolidate_memories summary*parent_key*memory_keys*parent_tagsplaybook_id*archive_children
Consolidate related memories under a new parent memory with a summary. Child rows stay readable; by default they are archived to the longterm tier rather than deleted. Requires mem…
create_mcp_server name*toolsresourcesdescriptionplaybook_id*transport_type +1
Connect an MCP or OpenAPI server to this playbook by storing its transport configuration. This writes playbook state; it does not by itself invoke remote tools. Requires playbooks:…
create_persona can modify data name*metadataplaybook_id*system_prompt*
Set the playbook's singleton persona name and system prompt. This does not add a second persona; it is a backward-compatible alias that overwrites those fields. Requires personas:w…
create_playbook name*tagsvisibilitydescriptioninstructionspersona_name +2
Create a new playbook container for a singleton persona, skills, and memory. Each call inserts a new playbook; it does not upsert by name. Requires playbooks:write or full permissi…
create_run name*contextplaybook_id*
Create a workflow run so this playbook can be applied immediately with isolated context and canvas artifacts. Requires canvas:write or full permission. Use list_runs to inspect exi…
create_skill name*content*prioritydescriptionplaybook_id*
Create a new skill for this playbook. Use this to expand capabilities. Requires full or skills:write permission. Use update_skill to change an existing skill and list_skills to che…
create_task_graph can modify data tagstasks*plan_key*playbook_id*plan_summary*
Create a hierarchical task plan in one call: a parent plan memory plus a child node per subtask. Upserts by key, so repeating the same plan_key overwrites the previous graph. Requi…
delete_mcp_server can modify data server_id*playbook_id*
Disconnect an MCP or OpenAPI server from this playbook. The remote server is not shut down; only this playbook's connection record is removed. Requires playbooks:write or full perm…
delete_memory can modify data key*playbook_id*
Permanently delete one memory entry by key from this playbook. The row is removed from storage, not moved to another tier, and cannot be recovered. Requires a credential with memor…
delete_persona can modify data persona_id*playbook_id*
Reset the playbook's singleton persona to the default Assistant name and system prompt. Despite the delete_* name, this is not a hard delete: each playbook always keeps exactly one…
delete_playbook can modify data playbook_id*
Permanently delete a playbook and all of its contents (persona, skills, memory, API keys, canvas, and secrets). This cannot be undone. Requires playbooks:write or full permission,…
delete_run can modify data run_id*playbook_id*
Permanently delete a workflow run and its isolated canvas artifacts. This cannot be undone. Requires canvas:write or full permission. Use update_run with status=archived to keep ar…
delete_secret can modify data name*playbook_id*
Permanently delete a secret. Cannot be undone. Requires secrets:write or full permission. Use rotate_secret to replace the value without removing the name, and list_secrets to conf…
delete_skill can modify data skill_id*playbook_id*
Permanently delete a skill from this playbook. This cannot be undone except by recreating the skill. Requires full or skills:write permission. Use rollback_skill to restore a previ…
find_tools read-only limitquery*playbook_id*
Search this playbook's complete tool catalog by keyword: the built-in playbook tools (memory, skills, canvas, workflow runs, secrets) and every connected server's federated tools (…
get_canvas_toc read-only slug*run_id*playbook_id*
Get the table of contents for a canvas document. Returns section IDs, headings, and levels for navigation and patch_canvas_section. Read-only. Use read_canvas for full markdown and…
get_memory_context read-only max_itemsexpand_keysplaybook_id*tags_filterinclude_tiers
Get a context-optimized view of memories: full working memory, summaries for contextual, and keys only for longterm. Read-only. Use this to pack a prompt; use read_memory for one k…
get_memory_tree read-only root_keymax_depthplaybook_id*include_values
Get a hierarchical tree of memories showing parent-child relationships and per-node status. Read-only. Use this to visualize task graphs; use search_memory to filter flat lists, ge…
get_playbook read-only playbook_id*
Get a playbook with its singleton persona, skills, connected MCP servers, and memory. This is the only persona retrieval tool; there is no get_persona. Read-only. Requires playbook…
get_skill read-only skill_id*playbook_id*
Return the full definition of one skill in this playbook, including name, description, content, priority, and attachments. Identify the skill with skill_id, which may be a UUID or…
list_canvas read-only run_idplaybook_id*
List canvas documents in a workflow run. Canvas documents are collaborative markdown files that multiple agents can edit in parallel. Omit run_id to list documents across all runs.…
list_mcp_servers read-only playbook_id*
List the MCP and OpenAPI servers connected to this playbook, including transport metadata and discovered capability counts. Read-only. There is no get_mcp_server; this list is the…
list_playbooks read-only
List playbooks owned by or shared with the authenticated user, including access role and content counts. Read-only; it does not create or modify playbooks. Use get_playbook when yo…
list_runs read-only playbook_id*
List workflow runs for this playbook. Runs isolate canvas artifacts and execution context. Read-only. There is no get_run; this list returns the run records. Use create_run to star…
list_secrets read-only categoryplaybook_id*
List all secret names and metadata in this playbook. Does not return values — secret values are never exposed to agents. Requires secrets:read or full permission. Use use_secret to…
list_skills read-only playbook_id*
List every skill currently attached to this playbook, returning id, name, description, content, licence, and priority ordered by priority descending. Read-only; it does not create…
list_skill_versions read-only limitskill_id*playbook_id*
List historical versions of a skill for auditing or rollback. Read-only. Use this before rollback_skill; use get_skill for the current definition and list_skills for every skill in…
lock_canvas_section slug*run_id*locked_by*section_id*playbook_id*
Lock a section for exclusive editing so other agents cannot modify it. Requires canvas:write or full permission. Always unlock_canvas_section when finished. Do not use this to edit…
patch_canvas_section slug*run_id*content*headingsection_id*playbook_id*
Edit a specific section of a canvas document. Parallel-safe: only the targeted section is updated. Requires canvas:write or full permission. Lock the section first in multi-agent s…
promote_memory key*playbook_id*target_tierpriority_boost
Promote a memory to a higher tier or boost its priority for active use. This tool cannot demote; use archive_memories to move working or contextual entries to longterm. Repeating t…
read_canvas read-only slug*run_id*section_idplaybook_id*
Read a canvas document. Returns full content, sections structure, and metadata. Optionally read a specific section by ID. Read-only. Use get_canvas_toc to discover section IDs befo…
read_memory key*playbook_id*
Read one memory entry by key and return its value, tags, tier, summary, and metadata. This is not a pure read: it increments access_count and updates last_accessed_at as a side eff…
rollback_skill can modify data version_id*playbook_id*
Rollback a skill to a previous version recorded by list_skill_versions. The current definition is replaced and cannot be recovered except by rolling forward to another stored versi…
rotate_secret can modify data name*value*playbook_id*
Rotate an existing secret with a new value. The old value is permanently replaced and cannot be recovered. Requires secrets:write or full permission. Use store_secret to create a n…
search_memory read-only tagstiersearchstatusmemory_typeplaybook_id* +1
Search memories by text, tags, tier, or type. Returns summaries for large memories. Use tags for categorical search; use tier to focus on active vs archived data; use memory_type t…
store_secret name*value*categoryexpires_atdescriptionplaybook_id*
Store a new encrypted secret. The value is encrypted with AES-256-GCM using a per-user derived key and never stored or returned in plaintext. Requires secrets:write or full permiss…
unlock_canvas_section slug*run_id*section_id*playbook_id*
Unlock a previously locked canvas section so other agents can edit it. Requires canvas:write or full permission. Use lock_canvas_section to take the lock; this tool does not change…
update_mcp_server nametoolsresourcesserver_id*descriptionplaybook_id* +2
Update a connected MCP or OpenAPI server's stored name, description, tools, resources, or transport. Requires playbooks:write or full permission. Use call_connected_tool to invoke…
update_persona namemetadatapersona_id*playbook_id*system_prompt
Update the singleton persona's name, system prompt, or metadata without resetting to defaults. persona_id must equal playbook_id because the persona is stored on the playbook row.…
update_playbook can modify data nametagsconfigvisibilitydescriptionplaybook_id* +4
Update this playbook's name, description, visibility, tags, config, singleton persona fields, or always-on project instructions. Replacement fields overwrite previous values. Handl…
update_run namerun_id*statuscontextplaybook_id*
Update a workflow run's name, status, or context. Requires canvas:write or full permission. Use list_runs to find run_id (there is no get_run) and delete_run to remove the run and…
update_skill namecontentpriorityskill_id*descriptionplaybook_id*
Update an existing skill in this playbook. Requires full or skills:write permission. Use create_skill to add a skill, list_skill_versions before a risky edit, and rollback_skill to…
update_task_status key*resultstatus*summaryplaybook_id*
Update the status of a task node in a hierarchical plan. When all children of a parent are completed, the parent is auto-updated. Returns the current subtree state. Requires memory…
use_secret read-only url*methodtimeout_msheader_nameplaybook_id*secret_name* +2
Send a GET or HEAD request with a secret injected as a header, and return the response. The secret value is never returned to the agent — it is decrypted and used server-side only.…
use_secret_write can modify data url*bodymethodtimeout_msheader_nameplaybook_id* +3
Send a POST, PUT, PATCH or DELETE request with a secret injected as a header, and return the response. The secret value is never returned to the agent — it is decrypted and used se…
write_canvas can modify data name*slug*run_id*content*metadataplaybook_id*
Create or fully replace a canvas document. Markdown headings are auto-parsed into sections for parallel editing. A replace overwrites prior content and cannot be undone. Requires c…
write_memory can modify data key*tagstiervalue*statussummary +6
Create or overwrite a memory entry by key. There is no separate update_memory; a second write to the same key replaces the previous value and cannot be undone. Use tier='working' f…