Name: Roamer MCP
Author: mathismeadows

What can you do with Roamer MCP?

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.

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.

Install

Add Roamer MCP to your client. Pick the one you use.

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

Add to `.vscode/mcp.json` in your workspace.

claude mcp add roamer-device-auth -- npx -y @mathismeadows/roamer-device-auth

codex mcp add roamer-device-auth -- npx -y @mathismeadows/roamer-device-auth

amp mcp add roamer-device-auth -- npx -y @mathismeadows/roamer-device-auth

{
  "mcpServers": {
    "roamer-device-auth": {
      "command": "npx",
      "args": [
        "-y",
        "@mathismeadows/roamer-device-auth"
      ]
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "roamer-device-auth": {
      "command": "npx",
      "args": [
        "-y",
        "@mathismeadows/roamer-device-auth"
      ]
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

{
  "mcpServers": {
    "roamer-device-auth": {
      "command": "npx",
      "args": [
        "-y",
        "@mathismeadows/roamer-device-auth"
      ]
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

{
  "mcpServers": {
    "roamer-device-auth": {
      "command": "npx",
      "args": [
        "-y",
        "@mathismeadows/roamer-device-auth"
      ]
    }
  }
}

Add to `cline_mcp_settings.json` via the MCP Servers panel.

{
  "mcpServers": {
    "roamer-device-auth": {
      "command": "npx",
      "args": [
        "-y",
        "@mathismeadows/roamer-device-auth"
      ]
    }
  }
}

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "roamer-device-auth": {
      "type": "local",
      "command": "npx",
      "args": [
        "-y",
        "@mathismeadows/roamer-device-auth"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "roamer-device-auth": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mathismeadows/roamer-device-auth"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

npx -y @mathismeadows/roamer-device-auth

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

Score

39 / 100

Incomplete

Documentation22/25
Maintenance19/25
Trust9/20
Capability0/15
Install experience15/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 0 days ago
Has a release history
Repository is not archived
No licence detected
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
0 tool(s) documented
Provides prompt templates
Provides resources
18 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Read the full rubric →

Version history

Versions	Published
1.2.5Latest	Aug 31, 2026