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 --url https://YOUR-VAULT.mcp.artifactum.ai/ --auth header

Hermes prompts for the bearer token and stores it locally in its profile environment file. Do not paste a real key into a shared config or commit it. Alternatively, configure the server in ~/.hermes/config.yaml with a locally set variable:

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 check connectivity and discover the configured Artifactum 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.