@abraca/mcp
v2.36.0
Published
MCP server for Abracadabra — AI agent collaboration on CRDT documents
Readme
@abraca/mcp
A Model Context Protocol server that exposes an Abracadabra space to AI tooling — documents, tree, content, metadata, files, chat, and presence over stdio. Bin: abracadabra-mcp.
Documentation
Full, code-derived documentation lives in docs/ — a numbered Nuxt-Content
site covering startup/transport, every env var, all 27 tools, the 3 resources, schema
validation, and the channel/dispatch model + gotchas. It is the source of truth.
Quick start
ABRA_URL=https://my-server.example.com abracadabra-mcpIdentity is an Ed25519 key file (ABRA_KEY_FILE, default ~/.abracadabra/agent.key); the agent auto-registers on first run (ABRA_INVITE_CODE optional). See docs/1.getting-started/configuration for every variable.
Highlights
- 27 tools — tree/documents, content/meta, files, channel (
reply,send_chat_message), awareness, SVG, hooks. - 3 resources —
agent-guide(the authoritative in-band reference),server-info,tree. - Opt-in schema validation via
ABRA_MCP_SCHEMA_BUNDLE(a@abraca/schemabundle). - Hook bridge mirrors Claude Code tool activity into the agent's presence.
::
Plain text is invisible to users — chat replies go via
send_chat_message, ai:task answers viareply.read_document's body is not full content (children are content). Seedocs/4.reference/.
License
MIT.
