---
title: Hermes Agent | FLORA API
description: Add FLORA MCP to Nous Research's Hermes Agent via config.yaml.
---

[Hermes Agent](https://hermes-agent.nousresearch.com/) is Nous Research’s local AI agent. It configures MCP servers in `~/.hermes/config.yaml` under the `mcp_servers` key.

## Install

Edit `~/.hermes/config.yaml` and add a `flora` entry under `mcp_servers`:

```
mcp_servers:
  flora:
    command: npx
    args: ["-y", "mcp-remote", "https://agents.flora.ai/mcp"]
    enabled: true
```

Hermes Agent’s HTTP MCP transport only supports static bearer headers, not the OAuth 2.1 + PKCE flow FLORA MCP uses. The [`mcp-remote`](https://www.npmjs.com/package/mcp-remote) shim bridges Hermes’s stdio interface to FLORA’s hosted HTTP transport and handles the browser OAuth handshake. You’ll need Node.js 18+ on the machine.

## Authorize

Reload MCP servers without restarting Hermes:

```
/reload-mcp
```

Then ask:

> List my FLORA Techniques.

`mcp-remote` opens a browser for OAuth on first use. Sign in to FLORA and approve. The token is cached in `~/.mcp-auth/`.

## Verify

Confirm the server is connected:

Terminal window

```
hermes mcp list
hermes mcp test flora
```

You should see `flora` listed and the tools discovered.

## Remove

Delete the `flora` entry from `~/.hermes/config.yaml` and reload:

```
/reload-mcp
```

To clear the cached OAuth token: `rm -rf ~/.mcp-auth/flora`. Revoke server-side in FLORA → Settings → Connected apps.

## Next

- [Authentication details](/mcp/authentication/index.md)
- [Tools reference](/mcp/tools/index.md)
- [Troubleshooting](/mcp/troubleshooting/index.md)