AIR Agent KYA

From its catalog listing

Know-Your-Agent with AIR (Moca Network): you delegate your AIR identity to Hermes once in the AIR Console (`hermes air login`, device code, P-256 agent key, credentials.verify scope, no wallet signing); the kya_visit tool then enters KYA stores that publish /.well-known/air-kya, gets a one-time SD-JWT presentation from AIR that discloses only the claims the store requests (e.g. membership tier), and returns the catalog that credential unlocks; agents that aren't delegated get the store's public catalog.

Good to know before installing

network calls to the AIR Console (sandbox.agents.air3.com, during login only), the AIR API (air.api.sandbox.air3.com) and AIR credential API (credential-testnet.api.sandbox.air3.com), and to each KYA site the agent visits (https only, public addresses only, checked and pinned per connection; localhost only in mock mode or with the allow_local_sites setting); stores a P-256 agent private key and the AIR delegation bundle in its own plugin-data directory with mode 0600, removed by `hermes air logout`; on first run after the rename it reads the old air-kya plugin-data directory once to carry a delegation over; a live kya_visit asks for approval through Hermes's approval gate before any claim is disclosed and sends the presentation only to the origin that issued the nonce; the model never sees the presentation, key or tokens; endpoints are plugin settings, no secrets or env vars read; no shell, subprocess, background thread or telemetry.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install air-agent-kya
  2. Said no? Turn it on later:
    hermes plugins enable air-agent-kya
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Automation & multi-agent
Maintained by
MocaNetwork (Community)
Needs
No API keys declared
Adds tools
air_whoami kya_visit
Adds hooks
pre_tool_call
Needs Hermes
0.23.0 or newer
Version
0.1.0
In the catalog
2026-11-17

Known issues (from its catalog listing)

  • Defaults point at the AIR sandbox; production needs the endpoint settings.
  • `hermes air login` runs in a terminal only and waits for approval until the device code expires.
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in automation & multi-agent

All automation & multi-agent plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins