# Roamer MCP

> Roamer MCP is a freemium MCP server for developer tools. Hosted MCP server that keeps specs, engineering threads and project memory in one place. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API
- **Website:** https://roamermcp.mathismeadows.com
- **Repository:** https://github.com/mathismeadows/roamer-mcp-plugin
- **MCP Registry name:** com.mathismeadows/roamer-mcp
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-16

## About

Roamer treats requirements, user stories, test cases and specs as structured, linked records rather than loose documents. Agents read and write a project registry, a behavioural spec database and engineering threads through the server. The site's central rule is that the AI may propose changes to the stored truth but cannot alter it without explicit human approval.

An optional Claude Code plugin adds slash workflows such as /roamer:orient for a session briefing, /roamer:feature and /roamer:bug for gated multi-step flows, /roamer:spec-audit and /roamer:spec-check for coverage and hygiene, /roamer:thread-scrub, /roamer:release-notes and /roamer:export. Other MCP clients can use the same workflows as server prompts or call the tools directly.

Sign-in is OAuth in the browser, and the server itself needs no local install. It is in beta: you join a waitlist with a Microsoft account and are admitted gradually. Solo developers, small teams and engineering leads are the stated audience.

## Features

- **Truth layer:** Stored specs change only after explicit human approval.
- **Slash-skill workflows:** Skills like /roamer:feature and /roamer:bug run gated, repeatable steps.
- **Spec audits:** Check spec coverage and hygiene on demand.
- **Session briefings:** Start with open threads and a project registry summary, and end with a checkpoint.
- **Release notes drafts:** Generate internal or external notes for a date window, for review only.
- **Export:** Save specs, threads and project memory to local files.

## Good for

- Start a coding session with a briefing of open threads
- Run a gated workflow for a new feature or bug fix
- Audit whether specs still match each other
- Draft release notes from recent work
- Keep decisions from one AI session available to the next

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http roamer-mcp https://roamer-mcp.mathismeadows.com/mcp
```

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

```sh
https://roamer-mcp.mathismeadows.com/mcp
```

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

```json
{
  "mcpServers": {
    "roamer-mcp": {
      "url": "https://roamer-mcp.mathismeadows.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "roamer-mcp": {
      "type": "http",
      "url": "https://roamer-mcp.mathismeadows.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "roamer-mcp": {
      "serverUrl": "https://roamer-mcp.mathismeadows.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "roamer-mcp": {
      "type": "http",
      "url": "https://roamer-mcp.mathismeadows.com/mcp"
    }
  }
}
```

## FAQ

### Does it need a local install?

No. The server is hosted and you sign in with OAuth. The Claude Code plugin is optional.

### Can the AI change my specs on its own?

No. The site says it can propose changes but not alter truth without human approval.

### What does it cost?

A free plan allows 50 spec items and threads in total; Pro is billed monthly per seat, with the price not shown.

### Is it generally available?

It is in beta with a waitlist and a manual approval gate.

### Is Roamer MCP free?

Roamer MCP has a free plan, with paid plans for more usage or features.

### How do I add Roamer MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http roamer-mcp https://roamer-mcp.mathismeadows.com/mcp

### What are the best alternatives to Roamer MCP?

The closest alternatives to Roamer MCP 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.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [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.

---
Source: https://ai-powered.com/mcp/roamer-mcp
