Hermes · xai-oauth · Native MCP · v0.2 alpha

Incorporate every agent — from Hermes with Grok

Wire Agentico as a native Hermes MCP server alongside xai-oauth for Grok inference. Hermes runs your operator stack; Agentico exposes ten Wyoming Series LLC formation tools with human_approval on every material step.

Get AGENTICO_KEY → BYOK overview
10 MCP tools xai-oauth Native MCP human_approval

TL;DR

Hermes is the recommended operator stack for Agentico on WSL/macOS. Run ./setup-byok-grok.sh to chain Hermes OAuth → bridge init → .cursor/mcp.json → Hermes native MCP → Grok CLI connector. Tools: establish_master, incorporate_agent, sign_contract, spawn_subsidiary, wind_down, plus account read/configure verbs. xai-oauth powers Grok inference; AGENTICO_KEY authenticates formation verbs. Not an LLM host.

Quick start (setup-byok-grok.sh)

  1. Run setup script

    ./setup-byok-grok.sh — builds MCP server, wires Hermes OAuth, writes configs.

  2. Export key

    export AGENTICO_KEY=agk_… — authenticate formation verbs to Agentico.

  3. Verify auth

    ./hermes auth status xai-oauth — confirm Grok inference is connected.

  4. Chat

    ./hermes chat -q "Call get_account_summary via Agentico MCP" — tools appear in native MCP namespace.

one-liner
cd /path/to/Agentico
./setup-byok-grok.sh
export AGENTICO_KEY=agk_…
./hermes doctor

Manual Hermes MCP wiring

  1. Add native MCP

    ./hermes mcp add agentico --command ./bin/agentico-mcp --args stdio -e AGENTICO_KEY=$AGENTICO_KEY

  2. Confirm listing

    ./hermes mcp list | rg agentico — expect 10 tools registered.

  3. OAuth (WSL fallback)

    If callback fails: ./hermes auth add xai-oauth --manual-paste

two-key model
Hermes/Grok  ──BYOK──►  xAI API (xai-oauth or XAI_API_KEY)
     │
     │ MCP (AGENTICO_KEY)
     ▼
@agentico/mcp-server  →  formation verbs + human_approval

Tools Hermes discovers

ToolWhat Hermes can doGate
establish_masterStand up master Wyoming Series LLChuman_approval
incorporate_agentAdopt agent as segregated series + docs[]human_approval
sign_contractRecord hashed terms between serieshuman_approval
spawn_subsidiaryChild series under parenthuman_approval
wind_downRetire a serieshuman_approval
get_account_summaryAccount status & formation progress
list_seriesInventory adopted series
get_guided_setup_stateOnboarding flow position
update_account_preferencesAdjust account preferencessoft confirm
advance_guided_setupMove guided setup forwardsoft confirm

In Hermes, tools appear under the agentico native MCP server — same verbs as Grok CLI and Cursor.

Example prompts

"Call get_account_summary via Agentico MCP, then explain guided setup step 1."
"Use list_series to inventory my Wyoming agent fleet."
"Spawn a subsidiary under ser_ops named ser_research — human_approval from Jane Doe."
"What's my account summary and which series are active?"

FAQ

Does Hermes file with Wyoming automatically?

No. Agentico returns illustrative docs[]. You engage counsel and complete customer-led filing. Material verbs require named human_approval.

Do I need both xai-oauth and AGENTICO_KEY?

Yes. xai-oauth (or XAI_API_KEY) powers Grok inference via Hermes. AGENTICO_KEY authenticates formation verbs to Agentico — two keys, one workflow.

MCP tools not listed in Hermes?

Re-run ./hermes mcp add agentico …. Confirm ./bin/agentico-mcp exists after setup-byok-grok.sh.

OAuth callback fails on WSL?

Use ./hermes auth add xai-oauth --manual-paste to complete authentication without a browser redirect.

Get AGENTICO_KEY Developer docs Bring your own AI