# Hermes Atlas Mcp

> MCP server exposing the Hermes Atlas ecosystem catalog — 100+ Hermes Agent tools, skills, plugins, and integrations — to any MCP-aware client (Claude Desktop, Cursor, Continue).

- **Type:** MCP server
- **Install:** `agentstack add mcp-ksimback-hermes-atlas-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ksimback](https://agentstack.voostack.com/s/ksimback)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ksimback](https://github.com/ksimback)
- **Source:** https://github.com/ksimback/hermes-atlas-mcp
- **Website:** https://hermesatlas.com

## Install

```sh
agentstack add mcp-ksimback-hermes-atlas-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# hermes-atlas-mcp

MCP 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.).

Ask your AI assistant things like:

- "Search Hermes Atlas for memory providers"
- "What does the hermes-atlas catalog say about the hermes-agent project?"
- "List the top skills for Hermes Agent"
- "Get the Hermes beginner's guide"
- "Ask the atlas: what's the difference between Hermes Agent and Claude Code?"

All 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.

> **Status:** 0.x, experimental. Breaking changes may happen before 1.0. Batch releases weekly.

## Install

### Recommended — one command

```bash
npx -y hermes-atlas-mcp install --client claude-desktop
```

Replace `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.

Other flags:
- `--print` — dry-run (shows the diff, writes nothing)
- `--force` — overwrite an existing `hermes-atlas` entry without prompting

To remove:

```bash
npx -y hermes-atlas-mcp uninstall --client claude-desktop
```

Fully quit and reopen the client after either command (closing the window isn't enough — the process needs to restart).

### Manual install (if the installer won't work)

#### Claude Desktop

Find the config file:

- **Easiest:** open Claude Desktop, go to **Settings → Developer → Edit Config**. The file opens in your default editor.
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
- **Linux:** `~/.config/Claude/claude_desktop_config.json`

Paste this (if the file is empty or doesn't exist) or merge the `hermes-atlas` entry into your existing `mcpServers` object:

```json
{
  "mcpServers": {
    "hermes-atlas": {
      "command": "npx",
      "args": ["-y", "hermes-atlas-mcp"]
    }
  }
}
```

Save. Fully quit Claude Desktop and reopen. The five tools appear in the tool picker.

#### Cursor

File: `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per-project). Same JSON snippet as above.

#### Claude Code

Either use the installer above, or run `/mcp` inside Claude Code and add through its UI, or hand-edit `~/.claude.json`.

### From source

```bash
git clone https://github.com/ksimback/hermes-atlas-mcp.git
cd hermes-atlas-mcp
npm install
npm run build
node dist/index.js    # stdio server, pipe JSON-RPC to test
```

## Tools

| Tool | What it does |
|---|---|
| `search_projects` | Ranked keyword search over the catalog. Optional `category` filter. |
| `get_project` | Full summary + metadata + URL for one `owner/repo`. |
| `list_by_category` | Ranked projects in one of the six curated lists. |
| `get_guide` | Full text of the beginner's guide, install guide, or vs-Claude-Code comparison. |
| `ask_atlas` | Free-form RAG question routed to the site's `/api/chat` endpoint. |

## Resources

| URI | Content |
|---|---|
| `hermes-atlas://repos` | Full catalog JSON |
| `hermes-atlas://summaries` | AI-generated summaries JSON |
| `hermes-atlas://lists` | Curated lists JSON |
| `hermes-atlas://ecosystem` | `ECOSYSTEM.md` overview (markdown) |

## Development

```bash
npm install
npm run dev     # tsc --watch
npm run build   # tsc
npm start       # runs dist/index.js on stdio
```

## License

MIT © Kevin Simback. Catalog data is CC0.

## Related

- [hermesatlas.com](https://hermesatlas.com) — the live site
- [ksimback/hermes-ecosystem](https://github.com/ksimback/hermes-ecosystem) — the source repo behind the site
- [Hermes Agent](https://github.com/NousResearch/hermes-agent) — the agent this ecosystem is built around

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ksimback](https://github.com/ksimback)
- **Source:** [ksimback/hermes-atlas-mcp](https://github.com/ksimback/hermes-atlas-mcp)
- **License:** MIT
- **Homepage:** https://hermesatlas.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ksimback-hermes-atlas-mcp
- Seller: https://agentstack.voostack.com/s/ksimback
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.