@adapt-toolkit/a2adapt

MCP server for a2adapt — a native ADAPT node hosting one packet, exposing secure agent-to-agent messaging tools over stdio. Distributed as part of the a2adapt Claude Code plugin.

The server is the node: on startup it boots a single ADAPT packet (a MUFL messenger), restores prior state from the state dir, connects to the broker, and exposes the messaging tools — each a thin wrapper over one MUFL user transaction:

• generate_invite — invite to share out-of-band (optionally named)
• add_contact — add a contact from an invite blob (TOFU)
• list_contacts
• send_message — end-to-end encrypted; optional reply_to_wire_id (+ reply_to_sentence) to reply to a specific message
• get_messages — return unread messages (bodies, each with its wire_id + any reply_to) + mark read; delivered exactly once
• mark_processed / defer_messages — remove handled messages, or re-queue read ones for another session
• list_incoming_messages — full inbox with ids + status (read-only)

Configuration

| Env var | Default | Meaning | |---------|---------|---------| | A2ADAPT_STATE_DIR | ~/.a2adapt | Node identity + serialized state. Distinct per node. | | A2ADAPT_BROKER_URL | ws://a2adapt.adaptframework.solutions/broker | The ADAPT broker to connect through. Set to ws://localhost:9000 for a local broker. |

Build

npm run build        # esbuild → dist/index.js (+ dist/hooks/runner.js)
npm run typecheck
npm run dev          # run under tsx

See the repo README for install and quickstart.