Setup guide · MCP

Set up seenpaid in Hermes

Hermes is Nous Research’s open-source agent that lives in your terminal and in Telegram, Discord and Slack. Hermes speaks MCP natively, so you can drive seenpaid from a chat thread: “post this tomorrow at 9” from your phone, and it schedules it. On its own it has no social accounts to post to — seenpaid is that connection.

Start your 7-day trial →Jump to the setup

Card required, no charge until day 8. MCP access is on every plan.

Hermes$
Endpoint
api.seenpaid.com/mcp
Transport
Streamable HTTP
Auth
Bearer sp_…
Tools
50

Four steps

How to connect Hermes to seenpaid

You need a seenpaid API key and one paste.

  1. 1

    Create an API key

    In seenpaid, open Settings → API keys and create a key. It starts with sp_ and is shown once, so copy it straight into the next step. You can revoke it at any time.

    Open Settings → API keys
  2. 2

    Add seenpaid to Hermes

    Add this block under mcp_servers in ~/.hermes/config.yaml. Hermes also expands ${SEENPAID_API_KEY}-style variables in headers if you would rather keep the key in your environment.

    ~/.hermes/config.yaml
    mcp_servers:
  seenpaid:
    url: "https://api.seenpaid.com/mcp"
    headers:
      Authorization: "Bearer sp_your_api_key"

    Replace sp_your_api_key with your key.

    Checked against the official docs: github.com/NousResearch/hermes-agent — website/docs/reference/mcp-config-reference.md: url, headers, auth: oauth, /reload-mcp.

  3. 3

    Restart and verify

    Type /reload-mcp in Hermes (or restart it). Ask it which tools it has from seenpaid — it should list them.

  4. 4

    Ask for your first post

    Start with “Which of my social accounts are connected?” — Hermes calls list_accounts and names your channels. If none are connected yet, ask for a connect link: that one step needs you in a browser.

Another way

Prefer to sign in instead of pasting a key?

Hermes supports OAuth 2.1 for HTTP servers: replace the headers block with auth: oauth. On first connect it opens a browser window, and you sign in to seenpaid there.

~/.hermes/config.yaml
mcp_servers:
  seenpaid:
    url: "https://api.seenpaid.com/mcp"
    auth: oauth

Try asking

First things to ask Hermes

Plain requests. Under each one, the seenpaid tools Hermes calls to answer it.

  • Which of my social accounts are connected?

    Callslist_accounts

  • Post this to X and Threads tomorrow at 9am.

    Callsschedule_post

  • Every weekday at 8, suggest a post from my best-performing ones and wait for my OK.

    Callsconfigure_autopilotlist_suggestionsapprove_suggestion

  • Which posts made money this week?

    Callsget_money_feed needs revenue tracking

Revenue tracking is optional and off by default. Scheduling works without it. Every tool →

Troubleshooting

If it does not connect

401 Unauthorized

The request reached seenpaid but no valid credential came with it. Check the key starts with sp_, was not revoked, and is sent as “Authorization: Bearer sp_…” with the word Bearer and one space. seenpaid also answers 401 when the workspace has no active trial or plan, even with a correct key.

Wrong URL, or the server never connects

The endpoint is exactly https://api.seenpaid.com/mcp — not seenpaid.com, and not an /sse URL. seenpaid speaks Streamable HTTP only; a client set to SSE will not connect. Opening the URL in a browser shows a short explainer page, which is expected.

OAuth or API key — which one?

Config files and command-line clients send the sp_ key as a header. Connector screens in apps (claude.ai, Claude Desktop, ChatGPT, Grok) have no key field: they sign in to seenpaid with OAuth instead. Never paste your key into an OAuth client ID or secret field.

FAQ

Hermes and seenpaid, answered

Not on its own — it has no credentials for your accounts. Connected to seenpaid’s MCP server it can schedule and publish to the 21 platforms seenpaid supports, and report back per platform what went out.

Create an API key in seenpaid under Settings → API keys, then add https://api.seenpaid.com/mcp as a remote MCP server with the key sent as an Authorization: Bearer header. Add this block under mcp_servers in ~/.hermes/config.yaml. Hermes also expands ${SEENPAID_API_KEY}-style variables in headers if you would rather keep the key in your environment.

Use all 50 seenpaid tools: schedule, edit and cancel posts, check each platform’s limits before publishing, generate images and carousels, and read what published. Revenue tools (which post made money) work only if you switch on revenue tracking, which is optional and off by default.

No. MCP access is included on every seenpaid plan and in the 7-day trial.

It acts through a key or sign-in scoped to one seenpaid workspace; an API key can be revoked in Settings at any time. No tool returns your social passwords or platform tokens, and it cannot connect a new account on its own: it hands you a link and you sign in.

Also works with

Every other setup guide

Same server, same tools. Pick your client for its exact setup.

How the agent works MCP server reference