# Byteland MCP server

Source: https://glimind.com/server/mcp-registry%2Fdev.byteland%2Fbyteland
Registry id: `mcp-registry/dev.byteland/byteland`
Status: live (checked 2026-11-22T19:37:43.931Z)

## Measurements (30 days)

- Uptime: 100%
- Checks: 966
- Outages (90 days): 0

## Install

```json
{
  "mcpServers": {
    "byteland-mcp-server": {
      "type": "http",
      "url": "https://byteland.dev/mcp"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http byteland-mcp-server https://byteland.dev/mcp
```

## Tools (16)

- `about`: Short description of Byteland: what buildings, rooms and lights stand for, units, privacy rules and supported languages. A good first call.
- `get_building`: Public detail of one building: the owner’s profile, rooms and their states, machine-readable parts and the building recipe.
- `get_profile`: A developer’s or company’s profile: bio, links (GitHub, website, socials), badges, projects and open-source contributions. If not on the street, looks for a sav
- `get_project`: A single project of a profile. Returns nothing for private projects.
- `get_stats`: Unique visits (all time and this week), project views, weekly rank and the last 14 days for one username.
- `get_street`: Buildings in a range (owner, type, floors, light counts) and gaps (alleys, empty lots). Positions in centimetres, at most 80000 cm.
- `list_projects`: A profile’s projects: state, description, stack, links (repo, site) plus open-source contributions. Private projects appear only as hidden:true.
- `list_rooms`: The project rooms of a person that have been used (every public project of a resident has a room, open by default; one nobody wrote in is empty and not listed):
- `live`: Voice rooms with people in them right now and the rooms with messages in the last 48 hours. Voice presence comes from the running site (BYTELAND_URL, default ht
- `popular`: The leaderboard: buildings by unique visits this week (or period: "all"), the most viewed projects and the newest residents. A visit counts once per person per 
- `preview_building`: Builds a user's building as if it stood at the start of a street (GitHub repositories become rooms). The preview is not added to the city. Append the returned u
- `read_room`: The latest messages of one channel of a project room (default: its first channel) and the forum threads (idea, review, question, announcement) with reply and re
- `read_thread`: One forum thread of a project room with all of its replies and reactions.
- `repo_street`: Any public GitHub repository as a Byteland street: its top contributors (bots left out) with commit counts, who pushed in the last 30 days (their lights are on)
- `search`: Find people, projects and stacks across every resident of the city (people, projects, stacks), plus buildings on the street by username, name, project or techno
- `year_in_lights`: Anyone's GitHub contribution calendar for one year, by month: contributions per day (with GitHub's quartile level), the total, days with contributions, the long

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
