Hermes Agent

Connect Hermes Agent

Hermes Agent (by Nous Research) connects natively to Artifactum via Model Context Protocol (MCP). Save durable project decisions, files, and state that survive across sessions and model backends.

What you need

• Your vault address (e.g. https://YOUR-VAULT.mcp.artifactum.ai/).
• Your personal access key. Keep it out of git and out of prompt history.
• Hermes Agent CLI (v0.21.1 or later).

Add the connector

Add the server directly via the Hermes CLI:

hermes mcp add artifactum https://YOUR-VAULT.mcp.artifactum.ai/ --header "Authorization: Bearer YOUR_ACCESS_KEY"

Alternatively, configure it in ~/.hermes/config.yaml:

mcp_servers:
  artifactum:
    url: "https://YOUR-VAULT.mcp.artifactum.ai/"
    headers:
      Authorization: "Bearer ${ARTIFACTUM_MCP_BEARER}"

Verify the connection

Run the built-in MCP diagnostic:

hermes mcp test artifactum

Hermes will verify the SSE handshake and discover the Artifactum control plane tools (store, get_content, list_content, delete_content).

Try it in a session

1. Ask Hermes: "List my recent Content Objects in Artifactum."
2. Ask Hermes to save a project summary or decision artifact to Artifactum.
3. In a fresh session (or another client like Cursor/Claude), retrieve that saved artifact.