WritBase
WritBase is an MCP-native task management control plane for AI agent fleets, providing a persistent task registry with scoped permissions, inter-agent delegation, and full provenance. It solves the problem of ephemeral in-memory state by storing tasks in Postgres, accessible via the Model Context Protocol. It is for developers building multi-agent systems who need a shared, auditable task store.
✨ Key features
- Persistent task registry in Postgres
- Scoped permissions per agent (project/department)
- Full provenance with append-only audit log
- Inter-agent delegation with depth limits
- MCP-native, no custom integration needed
- Optimistic concurrency and rate limiting
🎯 Use cases
- CI bot creates tasks on build failure
- Triage agent reviews and comments on tasks
- Manager agent delegates tasks across departments
- Human supervisors monitor agent activity via dashboard
📦 Installation
🧰 Requirements: Node 18+, Supabase CLI, a Supabase project (free tier works), and an MCP client.
Option A: CLI Setup (recommended)
No repo clone needed. Just npx:
npx writbase init # Interactive setup — configures Supabase credentials
npx writbase migrate # Apply database schema
npx writbase key create # Create your first agent key
Prerequisites: Node 18+, Supabase CLI, a Supabase project (free tier works)
Deploy the Edge Function:
npx supabase functions deploy mcp-server --no-verify-jwt
Option B: Manual Setup
git clone https://github.com/Writbase/writbase.git
cd writbase && npm installnpx supabase link --project-ref <your-project-ref>
npx supabase db push
npx supabase functions deploy mcp-server --no-verify-jwt🚀 Usage
Connect your MCP client (Claude Code example)
claude mcp add writbase \
--transport http \
--url https://<project-ref>.supabase.co/functions/v1/mcp-server/mcp \
--header "Authorization: Bearer wb_<key_id>_<secret>"
Then ask your agent:
"Check my WritBase permissions" → calls info
"Create a task in my-app: Fix login bug" → calls add_task
"Mark it as in_progress" → calls update_task (with version for concurrency)
"Show all high priority tasks" → calls get_tasks with priority filter
❓ FAQ
What are the prerequisites for using WritBase?
You need Node 18+, Supabase CLI, and a Supabase project (free tier works).
How do agents authenticate?
Agents use SHA-256 agent keys (format wb_<key_id>_<secret>) passed as Bearer tokens in MCP requests.
Can agents delegate tasks to each other?
Yes, WritBase supports inter-agent delegation with depth limits and cycle detection.
What MCP tools are available?
Worker tools include info, get_tasks, add_task, update_task. Manager tools include manage_agent_keys, manage_agent_permissions, get_provenance, and more.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.