mp-mcp

MCP server for Mountain Project — search routes and areas, run route-finder filters, and query your personal tick list live from MP.

Built for Cursor and any MCP-compatible agent.

Disclaimer

This project is not affiliated with, endorsed by, or connected to Mountain Project or onX Maps, Inc. Mountain Project is a trademark of onX Maps, Inc.

• Personal use only. This tool is intended for individual climbers to access their own tick data and browse public route information — not for bulk scraping, republishing MP content, or building a competing database.

• Terms of service. Users are responsible for complying with Mountain Project's terms of service. Automated access may be restricted or blocked by MP at any time.

• Session security. Your ap_session cookie is a login credential. Do not commit ~/.mp-mcp/session.json, paste cookies into public chats, or store cookies in shared config files. The session file is written with restrictive permissions (0600), but treat it like a password.

• No warranty. This software is provided as-is under the MIT license. Route data accuracy remains the responsibility of Mountain Project and its community contributors.

Related MCP server: ripgrep-mcp

Features

• Public route discovery — search, route/area details, route-finder filters (no auth)

• Personal logbook — list, filter, and aggregate your ticks pulled live from MP

• Browser login — one-time npm run login captures your session automatically (no CSV export, no DevTools)

• Polite by default — rate limiting between requests

Quick start (humans)

1. Install

git clone https://github.com/defevan/mp-mcp.git
cd mp-mcp
npm install
npm run build
npx playwright install chromium   # first time only, for login

2. Log in to Mountain Project

npm run login

A browser opens to Mountain Project. Sign in normally — the script detects when you're logged in and saves ~/.mp-mcp/session.json. The login tab will not reload while you sign in.

Re-run when the session expires (~30 days).

3. Add to Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "mountainproject": {
      "command": "node",
      "args": ["/absolute/path/to/mp-mcp/dist/server.js"]
    }
  }
}

Restart Cursor or reload MCP servers.

4. Try it

Ask in chat:

• "Search trad 5.10 routes in Yosemite Valley"

• "Get beta on The Nose"

• "List my ticks from 2024"

• "How many days out did I have this summer?"

For agents

This section is for LLM agents using the MCP tools directly.

Server

• Name: mountainproject

• Transport: stdio

• Entry: node dist/server.js (run npm run build first)

Auth model

Tick tools call GET /user/{id}/{username}/tick-export with the session cookie. Ticks are parsed in memory and cached (default 15 min). Never ask the user to export a CSV manually.

If auth fails, tell the user to run npm run login in the project directory or use mp_set_session.

Tool reference

Public (no auth)

Authenticated

Agent workflow examples

Trip planning (no auth):

mp_search → mp_resolve_id → mp_find_routes / mp_get_route

Logbook analysis (auth required):

mp_auth_status → mp_list_ticks / mp_tick_stats

Area deep-dive:

mp_search(query, types=["areas"]) → mp_get_area → mp_find_routes(areaId, gradeMin, gradeMax)

Grade filters for mp_find_routes

Use YDS strings: 5.8, 5.10a, 5.11d, etc. The server maps these to MP's internal route-finder rank codes.

Rate limiting

Default 500 ms between MP requests (MP_RATE_LIMIT_MS). Prefer fewer, broader tool calls over many narrow ones.

Data source notes

• Public data: MP /api/v2/* and /route-finder-export

• Ticks: authenticated /user/{id}/{username}/tick-export

• MP's official Data API is deprecated; this server uses the same endpoints the website uses

• Respect MP's terms of service; this tool is for personal use

Environment variables

Development

npm run build      # compile TypeScript → dist/
npm run dev        # run server via tsx (stdio)
npm run login      # browser auth flow

Smoke test:

node -e "import('./dist/mp-client.js').then(m => m.getRoute(105924807).then(console.log))"

Session refresh

When tools return auth errors:

npm run login

Or call mp_set_session with a fresh ap_session cookie value.

License

MIT — Copyright (c) 2026 Evan Jones. See LICENSE.