Lawang Onboard
Role-aware onboarding answers about a codebase, filtered to what the caller may see
- Pricing
- Open source
- Platforms
- CLI, self-hosted, API
- Runs
- Locally or Remotely
- Version
- 0.1.1
- Listing updated
- 1 day ago
About Lawang Onboard
Lawang Onboard is an open-source MCP server for developer tools. It can run locally on your machine or as a hosted remote server.
Lawang Onboard was built for the IBM Bob 2.0 Hackathon in September 2026. It answers a new engineer's questions about a codebase from its code, commit messages, ADRs, pull requests, reviews and issues, but filters by the caller's role before the model sees anything. Every item carries scopes, a role maps to scopes, and the role comes from the bearer token on the connection, so a contractor's session cannot leak what it was never given. Answers end with a Withheld line stating how many items were hidden.
The server is written in Go. Its tools are whoami, map_system, search, get, trace_feature, why, setup_guide, starter_tasks and withheld, and a hidden id gets the same answer as a missing one. Scopes come from a roles.yaml of path globs, labels and kinds, and an item with no scope is denied to everyone. Tokens are compared in constant time, and an audit log is kept.
The README reports a self-run test with the contractor role: 10 of 10 onboarding questions correct and 5 of 5 leak probes held. It can run over stdio from a container or over HTTPS, and a live demo page lets you paste a role token to see that role's view.
Install
Run in a terminal
claude mcp add --transport http lawang-onboard https://lawang-onboard.samsulhadi.com/mcpAdd to Settings → Connectors → Add custom connector
https://lawang-onboard.samsulhadi.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"lawang-onboard": {
"url": "https://lawang-onboard.samsulhadi.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"lawang-onboard": {
"type": "http",
"url": "https://lawang-onboard.samsulhadi.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"lawang-onboard": {
"serverUrl": "https://lawang-onboard.samsulhadi.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"lawang-onboard": {
"type": "http",
"url": "https://lawang-onboard.samsulhadi.com/mcp"
}
}
}Configuration
ONBOARD_TOKENThe token this client uses. Set it to the same value as one of the role tokens below; that role decides what you see.RequiredONBOARD_TOKEN_CONTRACTORToken for the contractor role (any secret you choose)ONBOARD_TOKEN_EMPLOYEEToken for the employee role (any secret you choose)ONBOARD_TOKEN_MAINTAINERToken for the maintainer role (any secret you choose)
Tools this server provides (9)
Taken from the project documentation; the running server may differ.
- whoami
- Reports the caller's role.
- map_system
- Gives a map of the visible system.
- search
- Searches visible items.
- get
- Retrieves a visible item.
- trace_feature
- Traces a feature step by step.
- why
- Explains decisions and reviews behind a path.
- setup_guide
- Provides a setup guide.
- starter_tasks
- Suggests starter tasks.
- withheld
- Reports how many items are hidden from the role.
What it does
- Role-based filtering
- Filters context by scopes before the model sees it.
- Withheld report
- Each answer ends with a count of hidden items.
- Guided tour
- Maps the visible parts of the codebase module by module.
- Decision history
- Explains why a path looks the way it does from commits, ADRs and reviews.
- Audit log
- Records requests per role.
- Leak testing
- Includes tests across roles with planted injection items.
Good for
- Onboard a contractor to one module without exposing the rest
- Trace how a webhook becomes a record
- Find starter tasks suited to a new engineer
- Check what a role is not allowed to see
Pricing
Open source
Prices change. Check lawang-onboard.samsulhadi.com before you buy.
Lawang Onboard FAQ
How is the role determined?
By the bearer token on the connection, mapped to scopes in roles.yaml.
Can a hidden item be detected?
A hidden id and a missing id receive the same answer.
How does it run?
Over stdio from a container image or over streamable HTTP.
What do the README's results show?
10 of 10 onboarding questions correct and 5 of 5 leak probes held in the team's own test.
Is Lawang Onboard free?
Yes. Lawang Onboard is open source, so you can use and self-host it for free.
How do I add Lawang Onboard to Claude Code?
Run this command in your terminal: claude mcp add --transport http lawang-onboard https://lawang-onboard.samsulhadi.com/mcp
What are the best alternatives to Lawang Onboard?
The closest alternatives to Lawang Onboard are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Lawang Onboard

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools