Skip to main content
Glama
Hermes Atlas MCP Server

Hermes Atlas MCP Server

by bkuri

πŸ—ΊοΈ Hermes Atlas MCP Server

MCP server for the Hermes Atlas ecosystem directory β€” gives AI agents instant access to 169+ quality-filtered tools, skills, plugins, and integrations for Hermes Agent.

Why?

Hermes Agent has a massive and growing ecosystem. This MCP server turns that ecosystem into instant expandability β€” agents can discover, compare, and recommend tools without leaving their conversation.

Related MCP server: Sylex Search

Quick Start

Add to your MCP client config:

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

Or with Docker/stdio:

{
  "mcpServers": {
    "hermes-atlas": {
      "command": "node",
      "args": ["/path/to/hermes-atlas-mcp/dist/index.js"]
    }
  }
}

Tools

Tool

Description

Example

search_repos

Full-text search across 169 repos

search_repos("memory persistence")

list_categories

Browse 12 ecosystem categories

list_categories()

get_repo

Detailed repo info + AI summary

get_repo("NousResearch/hermes-agent")

recommend

Match tools to your use case

recommend("I need to deploy on K8s")

get_featured

Trending/rising repos this week

get_featured()

get_lists

Curated lists overview

get_lists()

get_list

Specific curated list with per-repo descriptions

get_list("best-memory-providers")

ecosystem_stats

Aggregate stats, category breakdown, latest version

ecosystem_stats()

ask_atlas

RAG over research knowledge base (requires embeddings)

ask_atlas("How do skills work?")

Optional: Local Embeddings

The ask_atlas tool provides RAG-powered answers grounded in 27 research files (6,500+ chunks) covering Hermes Agent installation, architecture, skills system, deployment, and best practices.

Install the embeddings (~70MB) separately:

npx hermes-atlas-mcp install-embeddings
# or equivalently:
npx hermes-atlas-install

The server auto-detects the embeddings at startup and adds the ask_atlas tool when available. Without embeddings, all other tools work perfectly using the summaries index.

How It Works

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚           hermes-atlas-mcp                β”‚
β”‚                                            β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”           β”‚
β”‚  β”‚ repos    β”‚  β”‚ summaries    β”‚           β”‚
β”‚  β”‚ (169)    β”‚  β”‚ (AI-generatedβ”‚  ← bundled β”‚
β”‚  β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜  β”‚  per-repo)  β”‚  or fetchedβ”‚
β”‚       β”‚        β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜           β”‚
β”‚  β”Œβ”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”             β”‚
β”‚  β”‚ lists, featured, stats   β”‚ ← cached    β”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜   (4hr TTL) β”‚
β”‚                                            β”‚
β”‚  β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”  optional   β”‚
β”‚  β”‚ chunks.json (70MB)        β”‚ ← install   β”‚
β”‚  β”‚ RAG knowledge base        β”‚   separatelyβ”‚
β”‚  β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜             β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
          β”‚
    stdio (MCP)
  • Zero-config: Works immediately with no API keys needed

  • Offline-capable: Bundled data works without network; fresh data fetched in background

  • Light: Core data is ~300KB; embeddings are opt-in at 70MB

  • Fast: Full-text search and recommendations complete in <50ms

Data Sources

All data sourced from ksimback/hermes-ecosystem β€” a community-curated directory security-reviewed before inclusion.

File

Size

Content

repos.json

60KB

169 repos β€” owner, name, description, stars, category, official flag

summaries.json

189KB

AI-generated summaries + highlights per repo

lists.json

2KB

6 curated lists (best memory, top skills, deployment, etc.)

list-summaries.json

26KB

Per-repo descriptions within each curated list

featured.json

241B

Currently featured/trending repos

latest-release.json

374B

Latest Hermes Agent version

chunks.json

70MB

6,554 research chunks with pre-computed embeddings (optional)

Development

git clone https://github.com/your-user/hermes-atlas-mcp.git
cd hermes-atlas-mcp
npm install
npm run build

# Test interactively
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0.1"}}}' | npm start

# Watch mode
npm run dev

License

MIT. Data sourced from hermes-ecosystem (MIT/CC BY 4.0).

Available Tools

8 tools
ecosystem_statsA

Get aggregate ecosystem statistics β€” total repos, total stars, category breakdown, latest Hermes version.

Inputs: no named parameters.

get_listB

Get a specific curated list with per-repo descriptions and recommendations.

Inputs: slug (required).

get_listsA

Get curated lists (best memory providers, top skills, deployment options, etc.). Each list has a title, description, and per-repo descriptions.

Inputs: no named parameters.

get_repoA

Get detailed information about a specific repo including its AI-generated summary, highlights, and category. Use owner/repo format (e.g. 'NousResearch/hermes-agent').

Inputs: slug (required).

list_categoriesA

List all ecosystem categories with repo counts. Useful for discovering what types of tools exist in the Hermes ecosystem.

Inputs: no named parameters.

recommendA

Get personalized recommendations for Hermes ecosystem tools based on a use case description. Matches repos using AI-generated summaries and highlights. Great for answering 'what should I use for X?' questions.

Inputs: use_case (required), limit.

search_reposA

Search the Hermes Atlas ecosystem for repos matching a query. Searches across repo names, descriptions, categories, and owners. Returns ranked results with star counts and official badges.

Inputs: query (required), category, official_only, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinct function: stats, featured repos, curated lists, single repo details, categories, personalized recommendations, and search. No two tools have overlapping purposes, minimizing agent confusion.

    Naming Consistency3/5

    Most tools follow a verb_noun pattern with underscores (get_featured, get_list, search_repos), but ecosystem_stats uses noun_verb and recommend lacks an underscore, creating mild inconsistency.

    Tool Count5/5

    Eight tools are appropriate for an ecosystem explorer, covering search, browsing, recommendations, and stats without being overwhelming or sparse.

    Completeness4/5

    The set covers key exploration tasks: searching, filtering by category or list, getting details, and recommendations. Missing is a bulk listing of all repos, but search_repos can substitute, so only minor gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Search and discover 500+ tools, APIs, and services for AI agents. Browse 15 categories, get recommendations, and access structured metadata including auth methods, free tiers, and example calls.
      1
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to discover and recommend other agents through a searchable directory of over 50 agents across 10 categories.
      5
      6 npm
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Exposes the Hermes Atlas ecosystem catalog of 100+ community-built tools, skills, and plugins for Nous Research's Hermes Agent to any MCP-aware client, enabling natural language queries and searches.
      5
      145 npm
      16
      MIT