Hermes

Before you start

• A running server. Examples use staging, https://dev.nexara.ac; replace it with your own origin. Production will be https://app.nexara.ac.
• An agent key: in the app open Agents, New agent, then Create agent and key. Copy the nxc_ key (shown once) and export it: export NEXARA_KEY=nxc_....
• The MCP URL is https://dev.nexara.ac/mcp. https://dev.nexara.ac/w/<workspace>/mcp also works and refuses keys from other workspaces.

Configure

Put the key in ~/.hermes/.env:

NEXARA_KEY=nxc_...

and add the server to ~/.hermes/config.yaml:

mcp_servers:
  nexara:
    url: "https://dev.nexara.ac/mcp"
    headers: { Authorization: "Bearer ${NEXARA_KEY}" }
    tools: { exclude: ["context_write", "context_archive"] }

Write tools are excluded by default so Hermes proposes rather than commits. Tools register as mcp_nexara_context_bundle and so on.

Recipe: daily brief

Give a cron job a script that fetches, and let the model only write:

curl -s https://dev.nexara.ac/api/v1/bundle -H "Authorization: Bearer $NEXARA_KEY" \
  -H 'Content-Type: application/json' -H 'Accept: text/markdown' \
  -d '{"intent":"open commitments, deadlines this week, active clients","scope":"hafez","budget_tokens":6000}'

Verify

Ask the agent to call context_whoami. It returns the agent name, workspace and grants. Or run:

curl -s https://dev.nexara.ac/mcp \
  -H "Authorization: Bearer $NEXARA_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"context_whoami","arguments":{}}}'

Troubleshooting