Roadmapsh MCP Server

MCP server for roadmap.sh - developer roadmaps, best practices, interview questions, project ideas, videos, and local progress tracking. Built on the official @modelcontextprotocol/sdk (TypeScript / stdio). Its 10 documented tools cover roadmap, progress.

People connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-06-11 · ★ 2 · #485 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Roadmapsh

Claude Code

claude mcp add aissablk1-mcp-roadmapsh -- npx -y mcp-roadmapsh

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "aissablk1-mcp-roadmapsh": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-roadmapsh"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package mcp-roadmapsh - unscoped; check the name against the project README before installing

registry namespace io.github.aissablk1 is GitHub-verified and matches the repo owner

03 · What Roadmapsh can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list all roadmap slugs, export a whole roadmap as markdown/text, and search slugs by keyword within a scope.

Capability map

Tools grouped from the project's README - what Roadmapsh lets an agent do.

Roadmap

6 tools - e.g. Connectivity + cache/state status; List all roadmap slugs; Roadmap graph by slug (outline or raw)

roadmap_diagnose · roadmap_list · roadmap_get · roadmap_topic · roadmap_export · roadmap_search

Progress

3 tools - e.g. Mark a topic learning / done / skip (local); Completion percent for a roadmap; Recommend the next topic to learn

progress_mark · progress_status · progress_next

Videos

1 tool - e.g. Video resources

videos_list

Latest releases

v0.2.0 · 2026-06-04

Security hardening, robustness fixes and full documentation. See CHANGELOG.md. · Highlights · strict api.github.com token scoping, env owner/branch validation, bounded nodeId/query inputs, prototype-pollution-safe JSON…

v0.1.0 · 2026-06-04

First public release of mcp-roadmapsh - an MCP server for roadmap.sh (developer roadmaps, best practices, interview questions, projects, videos, local progress tracking). · Install · bash · claude mcp add roadmapsh…

04 · Who maintains Roadmapsh

mcp-roadmapsh is maintained by aissablk1. It's the only MCP server we track from this author; the repo dates to Jun 2026.

05 · Facts

repository: github.com/aissablk1/mcp-roadmapsh
category: other - ranked #485 of 848 actively-maintained other servers as of 2026-08-25.
release cadence: 2 releases in the last 90 days (latest 2026-06-04)
registry: io.github.aissablk1/mcp-roadmapsh (active, first published 2026-06-04 · 2 versions)
packages: npm:mcp-roadmapsh

06 · Roadmapsh FAQ

Is Roadmapsh still maintained?

Yes - as of 2026-08-25, its last commit was 2026-06-11 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can Roadmapsh do?

With this server connected, an agent can list all roadmap slugs, export a whole roadmap as markdown/text, and search slugs by keyword within a scope.

How do I install Roadmapsh?

Run `npx -y mcp-roadmapsh`. You can also paste the ready-made client config above.

Does Roadmapsh run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Roadmapsh

Alternatives to Roadmapsh

Maintained other servers if Roadmapsh isn't the fit.

More MCP servers to compare · Etincel Nonfiction · Web Validator by DigestSEO · Kasbah MCP · Datos Gob Do MCP Server · Campus CLI

More TypeScript MCP servers · Aiven MCP · Coldstart · India Stock MCP · Android Security Analyzer · see all