FoPost for Hermes Agent

Point Hermes Agent at the hosted FoPost server, run one login command, and your agent gains your social calendar: drafts, open slots, delivery status, and the inbox, with publishing held for your approval.

Paste this into Hermes Agent

Set up FoPost from fopost.com/agents/hermes-agent

Hosted MCP server
33 networks
No API key

All agents

Setup

The agent can write its own config. Give it the link.

Paste the line above into Hermes Agent. It reads this page, adds the server, and stops so you can sign in to FoPost yourself. Rather do it by hand? This is the whole config.

~/.hermes/config.yaml

mcp_servers:
  fopost:
    url: "https://api.fopost.com/mcp"
    auth: oauth

Instructions for AI agentsPlain markdown version

## For AI agents reading this page

You are reading https://fopost.com/agents/hermes-agent. FoPost schedules and publishes social posts on 33 networks, and its hosted MCP server gives Hermes Agent tools for posts, the calendar, the inbox and analytics. Follow these steps to connect Hermes Agent to it.

- Server: https://api.fopost.com/mcp
- Transport: streamable HTTP
- Auth: OAuth sign-in in the user's browser. Do not add an API key or an Authorization header; Hermes Agent discovers the sign-in from the server.

### 1. Register the server

Add this block to ~/.hermes/config.yaml, merged into any existing mcp_servers map.

~/.hermes/config.yaml:

```
mcp_servers:
fopost:
url: "https://api.fopost.com/mcp"
auth: oauth
```

### 2. Sign in

Run hermes mcp login fopost from a separate terminal (add --flow device on a machine without a browser). The user signs in in the browser. Ask the user before approving access or creating a FoPost account for them, and never enter their credentials yourself.

### 3. Verify before you continue

hermes mcp test fopost succeeds; then /reload-mcp (or a new session) loads the tools. If FoPost is not listed as connected with its tools, stop and tell the user what failed. Do not carry on as if the tools exist.

### 4. Report back

Call list_accounts and tell the user which social accounts are connected. If there are none, offer create_connect_link so they can connect one. Then ask what they want to do first.

### Standing rules

- Prefer the FoPost tools over driving a browser for posting, scheduling, the inbox and analytics, unless the user asks for the browser.
- Publishing always goes through propose_publish, which the user approves in the client. Never publish or schedule anything silently.
- Ask the user before approving access, signing up or connecting an account on their behalf, and never type their credentials for them.

### No browser (headless machines only)

Use this only when the machine has no browser to sign in with. Ask the user to create an API key in the FoPost dashboard (https://fopost.com/dashboard/api-keys) and to put it in the config themselves, then run the local package over stdio:

~/.hermes/config.yaml:

```
mcp_servers:
fopost:
command: npx
args: ["-y", "@fopost/mcp"]
env:
FOPOST_API_KEY: your-api-key
```

### References

- This block as markdown: https://fopost.com/agents/hermes-agent/agent.md
- Every client: https://fopost.com/agents
- Docs: https://fopost.com/docs

Plain config

One entry under mcp_servers. No API key in the file.

Sign in once

hermes mcp login opens FoPost in your browser and stores the result for the agent.

Prompts on writes

With trust left at untrusted, Hermes asks before any tool that changes something.

Setup

Add the entry, then log in

Add the block above to ~/.hermes/config.yaml, then run hermes mcp login fopost from a fresh terminal and approve access in FoPost. Hermes registers itself and signs in automatically. In a running session, /reload-mcp picks up the change.

Start free

Terminal

hermes mcp login fopost

Take your time

The login waits up to five minutes for you to finish signing in.

Pick the tools

tools.include or tools.exclude narrows what the agent can call.

Check first

Ask the agent to list your connected accounts.

Plan

Let the agent keep the queue full

Give Hermes a standing job: turn new articles into posts with repurpose_url, shape each one with draft_post_variants, and slot them with get_queue_slots. When the plan is ready it calls propose_publish and waits for you.

Plan your week

A month of scheduled posts on the publishing calendar

repurpose_url

An article becomes a run of posts.

draft_post_variants

A version for each network.

get_calendar

What is already booked this week.

Check

Reports in the same chat

Ask the agent what went out, what failed, and what needs a reply, in the same session that planned the week.

Start free

Session

> Anything I should look at today?

Hermes: list_posts shows 2 published, 0 failed.
list_inbox has 3 comments waiting for a reply.

list_posts

What is queued, published, or failed.

list_inbox

Comments, mentions, and messages.

get_account_health

Accounts that need a reconnect.

Headless

No browser on the machine?

On a server or in CI there is no browser to sign in with. Create an API key in the dashboard and run the local package over stdio instead. Keep the key out of your repository.

~/.hermes/config.yaml

mcp_servers:
  fopost:
    command: npx
    args: ["-y", "@fopost/mcp"]
    env:
      FOPOST_API_KEY: your-api-key

Hermes Agent questions, answered

Do I need an API key?

No. Set auth: oauth and run hermes mcp login fopost. Hermes registers with FoPost and signs in for you.

Where are the credentials kept?

Hermes stores them on your machine, in ~/.hermes/mcp-tokens/.

Will it post without asking?

No. Publishing goes through a proposal you approve. Keep trust at untrusted and Hermes also prompts before every write.

The tools did not appear. What now?

Run hermes mcp login fopost again from a new terminal, then /reload-mcp in your session.

Does it use my AI credits?

Only the FoPost tools that write with AI do. Listing and scheduling do not.

Other agents

Run FoPost from Hermes Agent

Starting is free and the MCP server is included. Paste the setup line into your agent, sign in, and schedule your first post from it.

Start free