# Roamer MCP [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/mathismeadows/roamer-mcp-plugin  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/roamer-mcp

## Description
Project registry, behavioral specs, and engineering threads for AI coding agent workflows.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "roamer-mcp": {
    "url": "https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/mathismeadows/roamer-mcp-plugin"
  }
}
```

## Documentation & README

# roamer-mcp-plugin

[![Listed on mcpservers.org](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/mathismeadows/roamer-mcp-plugin)

Distributable Claude Code plugin for RoamerMcp — the Roamer project registry, behavioral spec database, and engineering threads MCP server. Learn more at [roamermcp.mathismeadows.com](https://roamermcp.mathismeadows.com).

Installing this plugin gives you six workflows backed by the same tools RoamerMcp exposes over MCP. Each is a slash command, but Claude can also invoke one on its own when the conversation calls for it — you don't have to type the command yourself:

- `/roamer:orient` — start-of-session briefing (project registry + open threads)
- `/roamer:breadcrumb` — end-of-session checkpoint (registry + thread updates)
- `/roamer:feature` — seven-step gated feature workflow
- `/roamer:bug` — eight-step gated bug-fix workflow
- `/roamer:spec-audit` — spec coverage audit
- `/roamer:spec-check` — hygiene checklist

## Install

```
/plugin marketplace add mathismeadows/roamer-mcp-plugin
/plugin install roamer@roamer
```

On first use, Claude Code will prompt you to authenticate against the hosted RoamerMcp endpoint (per-user Entra ID login via OAuth) — no manual token setup required.

## Status

This repo is public — install directly with the commands above. New accounts are provisioned automatically on first login, but currently need manual approval before they can use RoamerMcp's tools (a beta access gate); you'll be notified once yours is enabled.

## Structure

- `.claude-plugin/plugin.json` — plugin manifest
- `.claude-plugin/marketplace.json` — self-referential marketplace entry
- `.mcp.json` — spawns `scripts/roamer-bridge.sh` via `${CLAUDE_PLUGIN_ROOT}`
- `scripts/` — the same local stdio bridge (authenticates against RoamerMcp's own OAuth server — a device-code flow for Safari-default machines, a lighter loopback redirect for everything else — via the published `@mathismeadows/roamer-device-auth` npm package, invoked via `npx`) used by RoamerMcp's own dev setup
- `skills/` — the six workflow commands above

This repo is distribution-only — it has no server code, no tests, and no relation to RoamerMcp's internal architecture beyond consuming its public MCP endpoint.