# Surp Hermes X402 Llm: Hermes Agent plugin

> Marketplace-aware LLM routing for Surp — live prices for all models, provider TPS and trusted flags, mid-chat seller switching, secret masking, and approval-gated paid chat.

Canonical: https://hermeswatcher.com/plugins/surp-hermes-x402-llm  
Tier: Community  
Official page (Nous Research): https://hermes-agent.nousresearch.com/docs/plugins/surp-hermes-x402-llm  
Last updated in catalog: 2026-10-23

Marketplace-aware LLM routing for Surp — live prices for all models, provider TPS and trusted flags, mid-chat seller switching, secret masking, and approval-gated paid chat.

## Good to know before installing

The messages passed to surp_chat and SURP_API_KEY go to the surp.ivc.lol gateway, run by the individual developer ivcained (operator page https://surp.ivc.lol/operator, terms https://surp.ivc.lol/terms; not affiliated with Surplus Intelligence), which forwards them to third-party sellers on the Surplus Intelligence marketplace, including sellers not flagged trusted unless trusted_only is set; paid surp_chat calls spend from the user's prepaid Surp balance (USDC on Base, 5 % gateway markup), each behind a per-model Hermes approval prompt (denied in cron and other unattended runs by default) plus a per-request ceiling (max_spend_usd, default $0.05); the price, provider, quote, combo and cache tools call the same gateway without a key; routing preferences are stored under HERMES_HOME/cache/surp-hermes-x402-llm/.

From the plugin's catalog listing.

## How to install

1. Install it. Hermes asks for any API keys it needs (this one needs `SURP_API_KEY`), then asks whether to turn it on.

```bash
hermes plugins install surp-hermes-x402-llm
```

2. Said no? Turn it on later:

```bash
hermes plugins enable surp-hermes-x402-llm
```

3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see the official page. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/plugins

## Facts

- Category: Security & privacy, AI models & providers
- Maintained by: ivcained (Community)
- Needs: `SURP_API_KEY` (API key)
- Adds tools: `surp_models`, `surp_markets`, `surp_providers`, `surp_route_prefs`, `surp_quote`, `surp_cache_status`, `surp_chat`, `surp_usage`, `surp_jev_stats`, `surp_combo_create`, `surp_combo_list`, `surp_combo_get`
- Requires Hermes: `>=0.21.5`
- Version: 0.5.0
- In the catalog since: 2026-10-23

## Links

- [Full setup and settings (official page)](https://hermes-agent.nousresearch.com/docs/plugins/surp-hermes-x402-llm)
- [Source code](https://github.com/ivcained/surp-hermes-x402-llm)
- [All plugins](https://hermeswatcher.com/plugins.md)

---

HermesWatcher is an independent guide. It is not affiliated with or endorsed by Nous Research. The [official Hermes Agent documentation](https://hermes-agent.nousresearch.com/docs) and [repository](https://github.com/NousResearch/hermes-agent) from Nous Research are the authority; each page here lists the official sources it was written from. If this site and the official docs disagree, trust the official docs. Index for agents: https://hermeswatcher.com/llms.txt