echoia®
Echoia

Connect Hermes Agent to your social media accounts

Hermes Agent, from Nous Research, runs on your machine or a server and talks to you on Telegram, Discord, Slack and other apps. With Echoia connected, it reads your comments across platforms, drafts and schedules posts, and can run checks on a schedule.

Works today
Works onFree and open source
Connects withKey in a header
Setup timeAbout 3 minutes

Works today.

What you can ask Hermes Agent

“Summarise this week's comments by topic, with one example each.
“Draft next week: one post a day, alternating product and behind the scenes.
“Every evening, tell me if any post got more negative comments than usual.

Hermes Agent gets six tools from Echoia (accounts, posts, stats, creating a post, reading comments, replying) across Instagram, Facebook, TikTok, YouTube, X, LinkedIn, Threads, Bluesky, Pinterest and Google Business, limited to what your key allows.

Before you start

Hermes Agent installed and running.
Your Echoia key, stored in ~/.hermes/.env.

STEP 1 OF 2

Create your Echoia key

Hermes Agent connects with a key you create and can revoke at any time. It takes a minute.

  1. 1
    Open the Developers settings

    Sign in to Echoia, open Settings, then Developers.

  2. 2
    Create a key and choose what it may do

    Name it after the assistant so you recognise it later, and tick its permissions (explained further down). If you have several workspaces, choose which ones it can reach.

  3. 3
    Copy the key now

    It starts with eko_ and is shown only once: Echoia keeps only a fingerprint of it. If you lose it, revoke it and create a new one.

STEP 2 OF 2

Connect Hermes Agent

Hermes Agent

For Hermes on your computer or on a server, including through its messaging gateway.

  1. 1
    Store your key

    Add the key to ~/.hermes/.env. Hermes reads its secrets from there, so the key never has to appear in config.yaml.

    ~/.hermes/.env
    ECHOIA_API_KEY=eko_your_key
  2. 2
    Add Echoia to config.yaml

    Add this entry under mcp_servers in ~/.hermes/config.yaml. Hermes replaces ${ECHOIA_API_KEY} with the value from your .env file when it connects.

    ~/.hermes/config.yaml
    mcp_servers:
  echoia:
    url: "https://mcp.echoia.io/mcp"
    headers:
      Authorization: "Bearer ${ECHOIA_API_KEY}"
  3. 3
    Reload

    In a running session, type /reload-mcp and the Echoia tools appear next to the built-in ones. The messaging gateway picks up the change on its own within about a minute.

  4. 4
    Limit the tools (optional)

    Hermes can expose only some of a server's tools. This entry lets it read everything and change nothing, whatever the key allows: a useful second safety for an agent that runs unattended.

    ~/.hermes/config.yaml
    mcp_servers:
  echoia:
    url: "https://mcp.echoia.io/mcp"
    headers:
      Authorization: "Bearer ${ECHOIA_API_KEY}"
    tools:
      include: [list_accounts, list_posts, get_post_stats, list_comments]
  5. 5
    Install the skill (optional)

    The Echoia skill tells the agent when to act, and how to upload a file before attaching it to a post. It contains no secret: it reads the key from ECHOIA_API_KEY.

    Terminal
    mkdir -p ~/.hermes/skills/echoia && curl -s https://app.echoia.io/api/v1/skill > ~/.hermes/skills/echoia/SKILL.md

Which permissions to give Hermes Agent

Read

Accounts, posts, stats and comments. Looks at everything, changes nothing.

Write

Drafts, scheduled posts and media uploads. A scheduled post goes out at its time.

Engage

Replies to comments in public, as your account.

Publish

Posts immediately, with no window to change your mind.

Our advice for Hermes Agent: Hermes is often left running on a server. Give it Read only to start, and add Write once you are happy with what it drafts. The tool filter above adds a second limit on top of the key's scopes.

Limits worth knowing

If ECHOIA_API_KEY is missing from ~/.hermes/.env, Hermes refuses to connect rather than send the placeholder. A connection error right after setup usually means the variable is not set.
Scheduled jobs need the Hermes gateway to be running. If the machine is off, nothing runs.

Questions

Can I use Hermes from Telegram with Echoia?

Yes. The tools Hermes gets from Echoia are available wherever you talk to it, including its messaging gateway on Telegram, Discord or Slack.

What is the difference between the tool filter and the key's scopes?

The scopes are enforced by Echoia on every request, whatever the agent tries. The tool filter is enforced by Hermes and decides which tools the model is shown at all. Using both means a mistake in one is caught by the other.

How do I cut its access?

Revoke the key in Echoia under Settings, Developers. It stops working on the next request. You can also set enabled: false on the echoia entry to switch it off in Hermes only.

Sources, checked on 20 October 2026: Hermes Agent: MCP · Hermes Agent: MCP config reference

Ready to try it with Hermes Agent?

Create a free Echoia account, connect your social accounts, and your key is one click away. No card needed.