Mcp Roadmapsh
Connects Claude to roadmap.sh's public JSON APIs and the developer-roadmap GitHub repo to pull learning paths, best practices, interview questions, and project ideas. You get tools to list roadmaps, fetch topic markdown by node ID or search query, export entire roadmaps as text, and track progress locally in your state directory. The server caches HTTP responses for 24 hours by default and supports all the main content types: roadmaps, best practices, questions, projects, and videos. Useful when you want Claude to guide you through a learning path, suggest next topics based on your progress, or pull reference material without leaving the chat. Runs via npx with zero setup beyond Node 20+.
- tools
- 16
- transport
- STDIO
- last updated
- Jun 4, 2026
Tools
16 toolsPublic tool metadata for what this MCP can expose to an agent.
roadmap_diagnoseConnectivity + cache/state status
Connectivity + cache/state status
No parameter schema in public metadata yet.
roadmap_listList all roadmap slugs
List all roadmap slugs
No parameter schema in public metadata yet.
roadmap_getRoadmap graph by slug (`outline` or `raw`)
Roadmap graph by slug (`outline` or `raw`)
No parameter schema in public metadata yet.
roadmap_topicTopic markdown + links (by `nodeId` or `query`)
Topic markdown + links (by `nodeId` or `query`)
No parameter schema in public metadata yet.
roadmap_exportExport a whole roadmap as markdown/text
Export a whole roadmap as markdown/text
No parameter schema in public metadata yet.
roadmap_searchSearch slugs by keyword within a scope
Search slugs by keyword within a scope
No parameter schema in public metadata yet.
best_practices_listBest-practice guides
Best-practice guides
No parameter schema in public metadata yet.
best_practices_getBest-practice guides
Best-practice guides
No parameter schema in public metadata yet.
questions_listInterview question groups
Interview question groups
No parameter schema in public metadata yet.
questions_getInterview question groups
Interview question groups
No parameter schema in public metadata yet.
projects_listPractice project ideas
Practice project ideas
No parameter schema in public metadata yet.
project_getPractice project ideas
Practice project ideas
No parameter schema in public metadata yet.
videos_listVideo resources
Video resources
No parameter schema in public metadata yet.
progress_markMark a topic learning / done / skip (local)
Mark a topic learning / done / skip (local)
No parameter schema in public metadata yet.
progress_statusCompletion percent for a roadmap
Completion percent for a roadmap
No parameter schema in public metadata yet.
progress_nextRecommend the next topic to learn
Recommend the next topic to learn
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageReadme
mcp-roadmapsh
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).
All data comes from official, public sources — no scraping, no mock data:
https://roadmap.sh/{slug}.json— rendered roadmap graphsraw.githubusercontent.com/nilbuild/developer-roadmap— topic markdown- GitHub contents API — dynamic slug listings
Prerequisite
Node.js 20 or newer (node --version to check). That is
the only requirement — npx (bundled with Node) handles the rest, no manual
clone or build needed.
Quick start
Claude Code (one command)
# Once published to npm:
claude mcp add roadmapsh -- npx -y mcp-roadmapsh
Details
- Repository
- github.com/aissablk1/mcp-roadmapsh
- Package
mcp-roadmapsh- Transport
- STDIO
- Registry
- MCP registry, active