Plan roadmaps with your AI assistant

What it is

MCP (Model Context Protocol) is an open standard that lets AI assistants use outside tools. JustRoadmap runs a remote MCP server, so there is nothing to install: point your assistant at the server URL and sign in.

Server URL: https://www.justroadmap.io/mcp (Streamable HTTP)

Signing in and permissions

• Your assistant opens a JustRoadmap sign-in page (OAuth 2.1 with PKCE). After you sign in, you choose each workspace it may use: no access, read only, or read and change.
• It can only do what your own role allows, and it can't delete roadmaps, lanes, items or anything else.
• Changes it makes are recorded with the assistant's name, and owners and admins of team workspaces can review them in workspace settings.
• Disconnect an assistant any time from the account menu, under Connected assistants. Its next request is refused.
• For clients without OAuth, create a personal access token in Connected assistants and send it as Authorization: Bearer <token>.

Connect your client

{
  "mcpServers": {
    "justroadmap": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.justroadmap.io/mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "justroadmap": {
      "url": "https://www.justroadmap.io/mcp"
    }
  }
}

{
  "servers": {
    "justroadmap": {
      "type": "http",
      "url": "https://www.justroadmap.io/mcp"
    }
  }
}

Other MCP clients that support remote servers and OAuth work the same way: use the server URL above.

Tools

• list_workspaces (read): Workspaces the connection can use, with your role.
• list_roadmaps (read): Roadmaps you can see, newest first, optionally in one workspace.
• get_roadmap (read): A roadmap's lanes, items, milestones, checklists, progress and dependencies.
• export_roadmap_summary (read): A short Markdown summary of a roadmap.
• create_roadmap (change): Create a roadmap in a workspace.
• create_lane (change): Add a lane to a roadmap.
• update_lane (change): Rename, recolor or reorder a lane.
• create_item (change): Add an item (a bar with start and end dates) to a lane.
• create_milestone (change): Add a milestone (a single date) to a lane.
• update_item (change): Change an item's or milestone's name, dates, notes or link.
• move_item (change): Move an item to another lane or to new dates.
• set_progress (change): Set an item's percent complete, or mark a milestone done.
• add_dependency (change): Make one item start after another finishes.
• add_checklist_item (change): Add a checklist entry to an item.
• update_checklist_item (change): Tick, untick or edit a checklist entry.

Read tools are marked read-only for your client, and tools that change existing things are marked so clients can ask you first.

Example prompts

• “List my JustRoadmap roadmaps and summarize the one I updated last.”
• “In the Launch plan roadmap, add a Mobile lane with a two-week item called Beta testing starting March 2.”
• “Move the Website redesign item to start a week later and set it to 40% done.”
• “Add a milestone called Public launch on April 15 and make it depend on Beta testing.”
• “Tick off Design review on the checklist of the Onboarding item.”

Limits

• Up to 120 requests and 60 changes a minute per connection.
• Sign-in tokens last 1 hour and renew automatically for up to 30 days of inactivity.
• Dates are YYYY-MM-DD and must fall inside the roadmap's date range. The same roadmap size limits as the web app apply.

Terms and privacy

Using the MCP server is covered by the Terms of Service and the Privacy Policy. Your assistant's own provider handles what you send it under its own terms. Questions: Contact.