Skip to content

Connect Hermes Agent to TypeSafe

Connect Hermes Agent to TypeSafe: 1. Sign in to ApexGenius and connect TypeSafe. 2. Add the ApexGenius MCP server. 3. Start using TypeSafe in Hermes Agent.

1,000 free credits · No card required

How to connect TypeSafe to Hermes Agent

  1. 1Sign in to ApexGenius and connect TypeSafe
  2. 2Add the ApexGenius MCP server to Hermes Agent
  3. 3Start using TypeSafe in Hermes Agent
  1. 1ApexGenius

    Connect TypeSafe to ApexGenius

    Paste it into ApexGenius

    Paste your TypeSafe key into ApexGenius once.

  2. 2ApexGenius

    Connect ApexGenius to Hermes Agent

    Copy the MCP address

    On Start, pick API key, open Manual setup, and copy the MCP address.

  3. 3ApexGenius

     

    Approve access

    ApexGenius opens its approval page. Review the access, then approve.

Add the ApexGenius MCP server to Hermes Agent

Hermes Agent reads MCP servers from ~/.hermes/config.yaml, under mcp_servers.

  1. Add the apexgenius entry under mcp_servers and save the file.
  2. In a new terminal, run hermes mcp login apexgenius. Hermes prints an authorize URL and opens your browser when it can.
  3. Sign in to ApexGenius and approve access.
  4. Start Hermes with hermes chat, or run /reload-mcp in a session that is already open.
Add to ~/.hermes/config.yaml
mcp_servers:
  apexgenius:
    url: "https://server.autom8.pro/mcp"
    auth: oauth

Check it. Run hermes mcp test apexgenius. It connects, lists the tools it found and exits 0 when the connection completes.

Steps follow Hermes Agent documentation, MCP (Model Context Protocol) (opens in a new tab), read November 12, 2026.

Then ask Hermes Agent

List the TypeSafe models available to my connection. Do not evaluate anything yet.

Start free
Written setup, step by stepShow

Before you start

  • A TypeSafe account at console.typesafe.ai.
  • An API key created in the TypeSafe console.

1. Connect TypeSafe to ApexGenius

  1. Open TypeSafe in Connections. Choose Connect or Add connection.
  2. Enter the API key. Paste the key from console.typesafe.ai. ApexGenius supplies the API address and checks the key against the model list.
    The Connect TypeSafe dialog in ApexGenius with the empty TypeSafe API key field, the How to get it link and the Connect button.
    Paste the API key from console.typesafe.ai and choose Connect. ApexGenius checks it against the model list before saving.Open full-size image (opens in a new tab)
  3. Check the saved connection. Save after validation succeeds. Review the Tools tab. Evaluations are reads that bill input tokens to your account.
Connect TypeSafe →

2. Connect ApexGenius to Hermes Agent

Use this server address when adding the connection:

https://server.autom8.pro/mcp

The steps are above, under Add the ApexGenius MCP server to Hermes Agent. These notes apply to Hermes Agent only.

  • On a server with no browser. Hermes prints “Or paste the redirect URL here” beside the authorize URL. Open the URL on your own machine, approve, and paste the full URL the browser lands on. That page shows a connection error, which is expected.
  • Use a new terminal for the sign-in. Editing config.yaml inside a running session reloads MCP with a 30 second limit, too short for a browser sign-in. hermes mcp login waits five minutes.
  • Where the sign-in is kept. Hermes caches the tokens at ~/.hermes/mcp-tokens/apexgenius.json and reuses them until a refresh fails. Run hermes mcp login apexgenius again if that happens.
  • Tool names. Hermes prefixes each MCP tool with the server name, so the ApexGenius tools carry apexgenius in their names.
  • Access. When ApexGenius asks what Hermes Agent may use, choose Read only for the first test, or Custom to limit it to the tools you need.

3. Try your first question

List the TypeSafe models available to my connection. Do not evaluate anything yet.

List the TypeSafe models available to my connection. Do not evaluate anything yet.

Confirm jev-latest appears in the list. Listing models bills nothing; evaluations bill input tokens.

Full guide: the TypeSafe setup guide.

What it looks like in Hermes Agent

Example workflow
Hermes Agent
Hermes AgentApexGenius MCP route
List the TypeSafe models available to my connection. Do not evaluate anything yet.
ApexGenius
Working with ApexGenius1 tool search · 1 read
RequestCheck the models
Account scopeAuthorized connections checked
apex_search_toolsTypeSafe models · Find the TypeSafe read routeComplete
apex_call_read_toollist_models · List the modelsComplete
Hermes Agent

The key can use jev-latest, the default. Listing models bills nothing.

Read-only route
Hermes Agent

What to ask Hermes Agent about TypeSafe

  • Check the models

    List the TypeSafe models available to my connection. Do not evaluate anything yet.

    Runs list_models (read).

  • Search term negatives

    Score these ten search terms for whether the searcher wants to hire a Salesforce consultant, and tell me which ones to add as negatives.

    Runs evaluate (read).

  • Qualify a lead

    Is this inbound lead a fit for a Salesforce consulting engagement? Give me a yes or no with the probability.

    Runs evaluate (read).

These 3 questions use 2 of TypeSafe’s 2 operations. The full list is below.

  • Rate each of these three headlines from weak to strong for a paid search ad, and pick the best one. (read)

What Hermes Agent can do in TypeSafe

2 operations: 2 read. Every operation looks things up and changes nothing, so Hermes Agent cannot change TypeSafe through ApexGenius.

Models

1 read
  • list_modelsread

Typed answers

1 read
  • evaluateread

You choose the access. When you approve Hermes Agent, pick Full access, Read only, or Custom.

One connection covers one TypeSafe account and its API key.

Both operations are reads. Nothing at TypeSafe changes, so an AI agent set to Read only can use them.

Each evaluation bills input tokens to the connected TypeSafe account. Listing models bills nothing.

The key goes only to api.typesafe.ai, as a bearer token. ApexGenius encrypts it.

Start free

Questions about connecting Hermes Agent to TypeSafe

Updated November 12, 2026.

How do I connect Hermes Agent to TypeSafe?

Sign in to ApexGenius and connect TypeSafe. In Hermes Agent, add an apexgenius entry with the ApexGenius MCP address and auth: oauth under mcp_servers in ~/.hermes/config.yaml, then run hermes mcp login apexgenius. Then ask Hermes Agent: “List the TypeSafe models available to my connection. Do not evaluate anything yet.” Start with a read, so nothing changes.

How do I check that Hermes Agent can use TypeSafe?

Run hermes mcp test apexgenius. It connects, lists the tools it found and exits 0 when the connection completes. In a session that is already open, /reload-mcp picks up a config change. If the sign-in has expired, run hermes mcp login apexgenius again. Then ask: “List the TypeSafe models available to my connection. Do not evaluate anything yet.”

What does Jev return?

Typed answers, not text. A yes/no question returns a probability, a score returns a number with confidence, and a choice returns the pick with confidence and probabilities.

Does it cost anything?

Each evaluation bills input tokens to your TypeSafe account. Listing models bills nothing. ApexGenius does not add a TypeSafe charge.

Can my AI change anything at TypeSafe?

No. Both operations are reads. Evaluations compute and return answers, and nothing at TypeSafe changes.

What can I score with it?

Any text or record: search terms, ad copy, inbound leads or support tickets. Put the business definition inside the question so Jev knows who counts as a fit.

Connect TypeSafe to Hermes Agent today

Start free

1,000 free credits. No card required. Disconnect any time.