{
  "markdown": "# hermes-atlas-mcp\n\nMCP server exposing the [Hermes Atlas](https://hermesatlas.com) ecosystem catalog — 100+ community-built tools, skills, plugins, memory providers, workspaces, and integrations for [Nous Research's Hermes Agent](https://github.com/NousResearch/hermes-agent) — to any MCP-aware client (Claude Desktop, Cursor, Continue, Windsurf, etc.).\n\nAsk your AI assistant things like:\n\n- \"Search Hermes Atlas for memory providers\"\n- \"What does the hermes-atlas catalog say about the hermes-agent project?\"\n- \"List the top skills for Hermes Agent\"\n- \"Get the Hermes beginner's guide\"\n- \"Ask the atlas: what's the difference between Hermes Agent and Claude Code?\"\n\nAll catalog data is fetched live from hermesatlas.com (cached in-memory for 1 hour), so tool answers reflect the current ecosystem, not a stale snapshot.\n\n> **Status:** 0.x, experimental. Breaking changes may happen before 1.0. Batch releases weekly.\n\n## Install\n\n### Recommended — one command\n\n```bash\nnpx -y hermes-atlas-mcp install --client claude-desktop\n```\n\nReplace `claude-desktop` with `cursor` or `claude-code` as needed. The installer finds the right config file for your OS, merges in the `hermes-atlas` entry without touching your other MCP servers, and tells you what to do next.\n\nOther flags:\n- `--print` — dry-run (shows the diff, writes nothing)\n- `--force` — overwrite an existing `hermes-atlas` entry without prompting\n\nTo remove:\n\n```bash\nnpx -y hermes-atlas-mcp uninstall --client claude-desktop\n```\n\nFully quit and reopen the client after either command (closing the window isn't enough — the process needs to restart).\n\n### Manual install (if the installer won't work)\n\n#### Claude Desktop\n\nFind the config file:\n\n- **Easiest:** open Claude Desktop, go to **Settings → Developer → Edit Config**. The file opens in your default editor.\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n- **Linux:** `~/.config/Claude/claude_desktop_config.json`\n\nPaste this (if the file is empty or doesn't exist) or merge the `hermes-atlas` entry into your existing `mcpServers` object:\n\n```json\n{\n  \"mcpServers\": {\n    \"hermes-atlas\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"hermes-atlas-mcp\"]\n    }\n  }\n}\n```\n\nSave. Fully quit Claude Desktop and reopen. The five tools appear in the tool picker.\n\n#### Cursor\n\nFile: `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per-project). Same JSON snippet as above.\n\n#### Claude Code\n\nEither use the installer above, or run `/mcp` inside Claude Code and add through its UI, or hand-edit `~/.claude.json`.\n\n### From source\n\n```bash\ngit clone https://github.com/ksimback/hermes-atlas-mcp.git\ncd hermes-atlas-mcp\nnpm install\nnpm run build\nnode dist/index.js    # stdio server, pipe JSON-RPC to test\n```\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `search_projects` | Ranked keyword search over the catalog. Optional `category` filter. |\n| `get_project` | Full summary + metadata + URL for one `owner/repo`. |\n| `list_by_category` | Ranked projects in one of the six curated lists. |\n| `get_guide` | Full text of the beginner's guide, install guide, or vs-Claude-Code comparison. |\n| `ask_atlas` | Free-form RAG question routed to the site's `/api/chat` endpoint. |\n\n## Resources\n\n| URI | Content |\n|---|---|\n| `hermes-atlas://repos` | Full catalog JSON |\n| `hermes-atlas://summaries` | AI-generated summaries JSON |\n| `hermes-atlas://lists` | Curated lists JSON |\n| `hermes-atlas://ecosystem` | `ECOSYSTEM.md` overview (markdown) |\n\n## Development\n\n```bash\nnpm install\nnpm run dev     # tsc --watch\nnpm run build   # tsc\nnpm start       # runs dist/index.js on stdio\n```\n\n## License\n\nMIT © Kevin Simback. Catalog data is CC0.\n\n## Related\n\n- [hermesatlas.com](https://hermesatlas.com) — the live site\n- [ksimback/hermes-ecosystem](https://github.com/ksimback/hermes-ecosystem) — the source repo behind the site\n- [Hermes Agent](https://github.com/NousResearch/hermes-agent) — the agent this ecosystem is built around\n",
  "bytes": 4035,
  "sha": "4fdd4f11224397ff6dcd5c2d6f8fc0b5cb4de8aee46e37c7758211766b817639",
  "repo_slug": "ksimback/hermes-atlas-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ksimback_hermes_atlas_mcp_0ae94c63/readme"
}