# The Cartographer MCP server

> Ask which agent skills fit a task before starting it, chosen from a bundled and local SKILL.md catalogue.

- Listing: https://mcp.tc/i/the-cartographer
- Connect: this is a local (stdio) server; install it on your machine (see Install). The listing link is a page, not an MCP endpoint.
- Type: local (stdio)
- Auth: no API key needed
- Category: [Developer Tools](https://mcp.tc/c/developer-tools)
- Vendor: sheepk95
- Repository: <https://github.com/sheepk95/The-Cartographer>
- Package: pypi `the-cartographer`

## About

The Cartographer reads a short brief of your task against your whole library of SKILL.md skills, plus 193 bundled ones, in a single model call. It returns the few skills worth reading first, with maybe-picks, grep hints and notes on gaps. "None" is a valid answer. Every name and path in the answer is checked against the catalogue. It also ships a CLI that can search skills.sh for skills you lack.

It runs locally over stdio from the PyPI package the-cartographer, started with uvx, and needs Python 3.9 or later. It needs a way to reach a model: a Claude Code or Codex login, an ANTHROPIC\_API\_KEY, or a local command that reads stdin. No hosted endpoint is used.

## What it can do

- Pick relevant agent skills for a task brief from the full catalogue
- Include your own skill folders alongside 193 bundled skills
- Return PICKS, MAYBE, ALSO GREP and NOTE sections
- Validate returned skill names and paths against the catalogue
- Use Claude API, Claude Code, Codex or a custom command as backend
- Search skills.sh for skills missing from the catalogue

## Example prompts

- "Which skills should I read before adding property-based tests to our Python date parser?"
- "Ask the cartographer which skills fit building a Three.js scene with bloom."
- "Find the best skills for reviewing a Terraform module for security issues."
- "Which of my skills apply to writing a database migration?"

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport stdio the-cartographer -- uvx the-cartographer mcp
```

2. Start Claude Code and type `/mcp`. **the-cartographer** should show as connected.

Add `--scope user` to make it available in every project.

### Claude Desktop

1. Open **Settings → Developer → Edit Config**. It opens `claude_desktop_config.json`. Add:

`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "the-cartographer": {
      "command": "uvx",
      "args": [
        "the-cartographer",
        "mcp"
      ]
    }
  }
}
```

2. Save the file and restart Claude Desktop.

Needs uv (Python) on your computer. The file lives in `~/Library/Application Support/Claude/` on macOS and `%APPDATA%\Claude\` on Windows.

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=the-cartographer&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJ0aGUtY2FydG9ncmFwaGVyIiwibWNwIl19>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "the-cartographer": {
      "command": "uvx",
      "args": [
        "the-cartographer",
        "mcp"
      ]
    }
  }
}
```

Needs uv (Python) on your computer.

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=the-cartographer&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22the-cartographer%22%2C%22mcp%22%5D%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"the-cartographer","type":"stdio","command":"uvx","args":["the-cartographer","mcp"]}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "the-cartographer": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "the-cartographer",
        "mcp"
      ]
    }
  }
}
```

Needs uv (Python) on your computer.

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "the-cartographer": {
      "command": "uvx",
      "args": [
        "the-cartographer",
        "mcp"
      ]
    }
  }
}
```

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf.

### Codex

```bash
codex mcp add the-cartographer -- uvx the-cartographer mcp
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.the-cartographer]
command = "uvx"
args = ["the-cartographer", "mcp"]
```

Needs uv (Python) on your computer.

### Gemini CLI

```bash
gemini mcp add the-cartographer uvx the-cartographer mcp
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients that start local servers accept this shape:

```json
{
  "mcpServers": {
    "the-cartographer": {
      "command": "uvx",
      "args": [
        "the-cartographer",
        "mcp"
      ]
    }
  }
}
```

Zed puts servers under `context_servers` in its settings, with the same `command`, `args` and `env` fields.

Needs uv (Python) on your computer.

## Recent changes

- 2026-10-29 11:22 UTC: Tracking started: version 0.1.1. Source: automatic check.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/the-cartographer#history (Atom feed: https://mcp.tc/i/the-cartographer/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 0.1.1
- Last checked: 2026-10-29
- Listed: 2026-10-29
- Updated: 2026-10-29

---
Source: https://mcp.tc/i/the-cartographer (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
