Log inSubmit server
Roamer MCP logo

Roamer MCP

Roamer MCP supports coding workflows with project context, behavioral specs, engineering threads, and gated feature and bug processes.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Roamer MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "roamer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mathismeadows/roamer-device-auth"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

Roamer MCP MCP server connects Claude Code workflows to a hosted project registry, behavioral specification database, and engineering thread system. Its distributable plugin provides eleven slash-command workflows, including session briefings, checkpoints, feature and bug processes, spec checks, thread review, release-note drafting, and identity management. Claude Code can invoke the workflows manually or when the conversation requires them. Reach for it when coding sessions need shared project context, specification tracking, or structured engineering follow-up.

Use cases

  • Orient a coding session with project and thread context
  • Run a gated workflow for a feature or bug fix
  • Audit behavioral specification coverage
  • Review and disposition open engineering threads
  • Draft internal and external release notes

Key features

  • Project registry access
  • Behavioral specification workflows
  • Engineering thread review
  • Seven-step feature workflow
  • Eight-step bug-fix workflow
  • OAuth device authentication bridge

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

6/6 checks healthy over the last 43d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · @mathismeadows/roamer-device-auth (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads369Package downloads in the last 30 days.
Last commit10d agoMost recent push to the default branch.

How Roamer MCP works

What Roamer MCP MCP server does

Roamer MCP MCP server provides a Claude Code plugin for working with three parts of the Roamer system: a project registry, a behavioral specification database, and engineering threads. The plugin exposes eleven workflows as slash commands, while also allowing Claude to invoke a workflow when the conversation matches its purpose.

The session-oriented commands help maintain continuity. /roamer:orient prepares a start-of-session briefing from the registry and open threads, while /roamer:breadcrumb records an end-of-session checkpoint with registry and thread updates. Feature and bug work follow separate gated processes: /roamer:feature runs a seven-step workflow, and /roamer:bug runs an eight-step workflow.

Other commands cover specification review, thread maintenance, release-note drafting, and authentication state. /roamer:spec-audit checks specification coverage, /roamer:spec-check runs a hygiene checklist, and /roamer:thread-scrub guides review of the open-thread backlog. /roamer:release-notes drafts internal and external notes for a selected date window and is review-only. Login, logout, and status commands manage the identities cached for each client.

How it works

The repository is a distribution package rather than the implementation of the Roamer backend. Its .mcp.json configuration runs npx -y @mathismeadows/roamer-device-auth. That device-auth component authenticates against RoamerMcp’s OAuth server and bridges the local stdio connection to the hosted MCP endpoint.

On first use, Claude Code prompts the user to authenticate through a per-user Entra ID OAuth flow. The plugin workflows then use the same MCP-backed capabilities exposed by RoamerMcp.

Setup and configuration

Install the marketplace entry and plugin from Claude Code:

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

After installation, authenticate when Claude Code requests it. New accounts are provisioned automatically at first login, but the project currently requires manual approval before a new account can use RoamerMcp tools. Access is therefore subject to the documented beta gate.

No environment variables or manually supplied access tokens are documented for this package. The repository contains the plugin manifest, marketplace metadata, MCP configuration, and workflow skills; it does not contain server implementation or test code.

Tools and capabilities

Roamer MCP MCP server is suited to teams that want coding agents to begin with current project context and finish by recording relevant changes. Its documented workflows support:

  • Session orientation and end-of-session checkpoints
  • Gated feature implementation and bug-fix processes
  • Specification coverage and hygiene reviews
  • Guided cleanup of open engineering threads
  • Review-only release-note drafts for a date range
  • Per-client identity switching, logout, and status inspection

The package is specifically documented for Claude Code.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Roamer MCP

Roamer MCP is an MCP server that connects Claude Code to a hosted project registry, behavioral specification database, and engineering thread system. Its main tools are eleven workflow commands for orientation, checkpoints, feature and bug processes, specification checks, thread review, release notes, and client identity management.

Install it through Claude Code with `/plugin marketplace add mathismeadows/roamer-mcp-plugin`, followed by `/plugin install roamer@roamer`. Claude Code then prompts for OAuth authentication on first use.

Yes, Roamer MCP is distributed as a Claude Code plugin. Its workflows are available as slash commands, and Claude Code may also invoke them when the conversation calls for one.

No manual token or environment-variable setup is documented. The plugin uses `@mathismeadows/roamer-device-auth` to authenticate through per-user Entra ID OAuth and bridge stdio to the hosted endpoint.

Related MCP servers

All in Coding Agents All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewRoamer MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/roamer-mcp?style=directory)](https://allmcps.com/mcp/roamer-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/roamer-mcp"><img src="https://allmcps.com/api/badge/roamer-mcp?style=directory" alt="Roamer MCP on AllMCPs" /></a>