Skip to content
MCP server

Lawang Onboard

Role-aware onboarding answers about a codebase, filtered to what the caller may see

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://lawang-onboard.samsulhadi.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "lawang-onboard": {
      "url": "https://lawang-onboard.samsulhadi.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.Required
  • ONBOARD_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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools