Airlock
by adamoradcommunityv2.0.0
Airlock is a local MCP HTTP server backed by a Go daemon and SQLite that lets agents coordinate on the same repo using blocking resource locks, shared notes/state, presence tracking, events, and a leased task queue. It runs on 127.0.0.1:27183 and supports server-side waits so clients do not need retry loops.
From the registry: Local daemon giving AI agents named locks, shared state, events, and a task queue over MCP.
Install & configure
Prerequisites
- requiredInstall Airlock binaryInstall the Airlock daemon using the simplest portable path shown in the README.
$ go install github.com/adamorad/airlock/v2@latest - requiredInstall and start the Airlock background serviceRegister the always-on background service so the local HTTP MCP server runs on 127.0.0.1:27183.
$ airlock install-service - optionalRetrieve bearer token on Linux or multi-user hostsOn Linux and other multi-user hosts, Airlock requires a bearer token. Read the token from ~/.airlock/token and send it in the Authorization header. On macOS, the token is optional. AIRLOCK_TOKEN can override the file on any OS.
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `airlock` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Airlock binary** — Install the Airlock daemon using the simplest portable path shown in the README. Run: `go install github.com/adamorad/airlock/v2@latest`
- **Install and start the Airlock background service** — Register the always-on background service so the local HTTP MCP server runs on 127.0.0.1:27183. Run: `airlock install-service`
Optional prerequisites:
- Retrieve bearer token on Linux or multi-user hosts — On Linux and other multi-user hosts, Airlock requires a bearer token. Read the token from ~/.airlock/token and send it in the Authorization header. On macOS, the token is optional. AIRLOCK_TOKEN can override the file on any OS.
Canonical MCP server config (HTTP transport):
- url: `http://127.0.0.1:27183`
- headers:
- `Authorization`: `Bearer <paste-contents-of-~/.airlock/token>`
Note: Airlock is a local HTTP MCP server provided by an always-running daemon. The Authorization header is required on Linux and multi-user hosts, optional on macOS. The daemon listens on 127.0.0.1:27183.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Airlock is a local HTTP MCP server provided by an always-running daemon. The Authorization header is required on Linux and multi-user hosts, optional on macOS. The daemon listens on 127.0.0.1:27183.
Tools (22)
lock_resource
Acquire a named lock, optionally blocking until it becomes available.
unlock_resource
Release a named lock using its lock token or agent id.
renew_lock
Extend the TTL of an existing lock.
list_locks
List currently held locks.
lock_resources
Acquire multiple locks atomically in a deadlock-safe order.
set_note
Store a key/value note with optional author and TTL.
get_note
Retrieve a note by key.
list_notes
List all notes.
delete_note
Delete a note by key.
set_note_if
Conditionally update a note only if its current value matches the expected value.
increment_counter
Atomically increment a named counter and return the new value.
register_agent
Register or heartbeat an agent presence record.
unregister_agent
Remove an agent presence record and release its locks.
list_agents
Environment variables
AIRLOCK_TOKENOverrides the token file used for bearer authentication.Packages
ghcr.io/adamorad/airlock:2.0.0
ocitransport: streamable-http
Details
- Language
- Go
- License
- MIT
- Released
- Jun 18, 2026
- Last commit
- Jun 18, 2026
- Registry name
- io.github.adamorad/airlock