Home

BoJ Server

One MCP stdio endpoint for a whole toolchain — GitHub, GitLab, cloud, mail, calendar, browser automation, research, ML and multi-agent coordination, reachable through a single zero-dependency bridge.

This wiki is a map, not a manual. Every page here links to a document in the repository rather than restating it, so the wiki cannot quietly drift out of date the way it did between March and August 2026. If a page tells you a number, treat the linked source as authoritative.

Start here

You want to…	Go to
Install it and make a first call	Getting-Started
Understand how the pieces fit	Architecture
Do a specific task	Guides
Know why something is the way it is	FAQ
Fix something that's broken	Troubleshooting

The one thing to know first

Cartridges do not live in this repository. They live in boj-server-cartridges, which is canonical, and this server fetches them on demand into a local cache:

scripts/fetch-cartridges.sh          # populates ~/.boj/cartridges by default
export BOJ_CARTRIDGES_PATH=~/.boj/cartridges

The bundled cartridges/ tree was retired in #300. Any document, script or comment that tells you to look in boj-server/cartridges/ predates that and is wrong — please open an issue if you find one still standing.

What is actually live

The catalogue is large; the live surface is smaller, and the project publishes the difference rather than the flattering number. See §Number transparency in the README for the current count and what it counts, and DEBT.md for where the estate's numbers currently disagree with each other.

Layers

Layer	Language	Where
MCP bridge (the shipped artefact)	JavaScript, runs on Node/Deno/Bun	mcp-bridge/
REST backend (localhost:7700)	Elixir/BEAM	elixir/
FFI + cartridge shim	Zig	ffi/zig/
Formal ABI	Idris2	src/abi/

Related projects

• boj-server-cartridges — the cartridge registry (canonical)
• PanLL — Human-Things Interface, another cartridge consumer
• Hypatia — neurosymbolic CI/CD scanning
• VeriSimDB — cross-modal consistency engine

Licence

Code MPL-2.0; prose and documentation CC-BY-SA-4.0. See LICENSE, NOTICE and .reuse/dep5.

(This page previously stated PMPL-1.0-or-later. That was never correct for this repository and has been fixed.)