# Lawang Onboard

> Lawang Onboard is an open-source MCP server for developer tools. Role-aware onboarding answers about a codebase, filtered to what the caller may see. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Website:** https://lawang-onboard.samsulhadi.com
- **Repository:** https://github.com/gablooge/lawang-onboard
- **MCP Registry name:** io.github.gablooge/lawang-onboard
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http lawang-onboard https://lawang-onboard.samsulhadi.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://lawang-onboard.samsulhadi.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "lawang-onboard": {
      "url": "https://lawang-onboard.samsulhadi.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "lawang-onboard": {
      "type": "http",
      "url": "https://lawang-onboard.samsulhadi.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "lawang-onboard": {
      "serverUrl": "https://lawang-onboard.samsulhadi.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "lawang-onboard": {
      "type": "http",
      "url": "https://lawang-onboard.samsulhadi.com/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/lawang-onboard
