← Back to directory

Hermes Atlas MCP Server

Community

Bring the Hermes Atlas ecosystem catalog to any MCP client.

GitHub source repository ↗

★ 134 Stars Category · Other Popular Source revision 1e587c70e7a4

43FMRS · D

Reliability

6/20

Security and permissions

10/20

Maintenance

8/20

Documentation

7/20

Setup experience

12/20

This server provides a clean and practical way to access the Hermes Agent ecosystem catalog, with intuitive tools and installation. The live data nature is a strength, but the experimental status and third-party API dependency are potential considerations.

Read the FMRS scoring method →

The Hermes Atlas MCP server provides live catalog data from hermesatlas.com, offering 100+ community-built tools, skills, plugins, memory providers, workspaces, and integrations for Nous Research's Hermes Agent. It includes search, project details, category listings, guides, and RAG-based Q&A functionality. Caching is in-memory (1-hour TTL) with optional Redis persistence (when REDIS_URL is set). The server is maintained by Kevin Simback and released under the MIT license.

Tools

health_check

Check server status and optional Redis connectivity.

search_projects

Ranked keyword search over the catalog, with optional category filter.

get_project

Fetch full summary, metadata, and URL for a single 'owner/repo'.

list_by_category

Get ranked projects from one of the six curated lists.

get_guide

Fetch the full text of the beginner's guide, install guide, or vs-Claude Code comparison.

ask_atlas

Route a free-form RAG question to the site's /api/chat endpoint.

Setup

Recommended one-command install: npx -y hermes-atlas-mcp install --client claude-desktop (replace claude-desktop with cursor or claude-code). The installer finds the right config file for your OS and merges the hermes-atlas entry. Alternatively, manually edit the config file: for Claude Desktop, config is at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), %APPDATA%\Claude\claude_desktop_config.json (Windows), or ~/.config/Claude/claude_desktop_config.json (Linux); for Cursor, at ~/.cursor/mcp.json or .cursor/mcp.json. After adding the config, fully quit and reopen the client. For Claude Code, use the installer or run /mcp.

claude_desktop_config.json

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

Generate and validate client config

Fit and risk

Best for

Developers and teams using Hermes Agent who want to discover community tools and integrations.
Users who want to access live catalog information through MCP clients like Claude Desktop, Cursor, etc.
Users who need up-to-date ecosystem data, as data is fetched live and cached briefly.

Not for

Users needing offline catalog access independent of the internet (data is fetched live from hermesatlas.com).
Users who want long-term caching or to avoid external API dependencies (optional Redis provides longer caching, but default is in-memory only).
Users needing official oversight or support, as this server is maintained by a contributor, not the official Hermes project.

Required permissions

Network access: fetch live catalog data and API requests from hermesatlas.com.
File system access: for the installer, read and write client config files (e.g., claude_desktop_config.json).
Optional: access to Redis if REDIS_URL is set.

Risks and side effects

Data is sourced from a third-party API (hermesatlas.com), which could affect reliability if the site or API changes.
The installer modifies client config files, which could break existing MCP setups if done incorrectly; use --print for a dry run.
Since the server is experimental (0.x), breaking changes may occur.

Troubleshooting

Ensure Node.js and npx are installed.
If tools don't appear in the client, fully quit and reopen the client (closing the window isn't enough).
Use the health_check tool to verify server status and Redis connectivity (if configured).
Check the client config file for correct command and arguments, ensuring the mcpServers object is merged properly.
If facing network issues, check firewall or proxy settings.

Use cases

Search Hermes Atlas for tools, skills, or plugins.

Get summaries and metadata for projects in the Hermes Agent ecosystem.

List top skills or projects in a specific category.

Get the Hermes beginner's guide or compare Hermes Agent and Claude Code.

Ask the Atlas natural language questions about the ecosystem.

Supported clients

Claude DesktopFull support

CursorFull support

ContinueFull support

WindsurfFull support

Related MCP servers

Compare with other MCP servers