# Connect Hermes Agent to SocialPoster

Hermes Agent (Nous Research) connects to SocialPoster over REST — not MCP. Same Agent API as OpenClaw and custom scripts.

Human hub: https://socialposter.pro/agents
How-to: https://socialposter.pro/blog/connect-hermes-to-socialposter
Agent API contract: https://socialposter.pro/pages/agent-docs.md
Comparison: https://socialposter.pro/blog/grok-bot-vs-hermes

## Auth

- Create key at https://socialposter.pro/dashboard/account?tab=api-keys (format `sp_live_…`)
- Store in `~/.hermes/.env` or Hermes config — never in chat
- Header: `Authorization: Bearer sp_live_…`

## REST base URL

`https://zqfnpnlzynhugeivtrka.supabase.co/functions/v1/agent-api`

## Startup workflow

1. `GET /me` — verify key
2. `GET /projects` — own one named project
3. `GET /projects/:id/connections` — empty = draft in chat only
4. `GET /projects/:id/generation-context` — brand voice
5. Draft caption; show human; wait for approval
6. `POST /posts` after approval. Read `main_platform`, `timezone`, `posting_slots` from project — do not invent times.

## Draft-then-approve

Default: show draft and wait unless the human already approved. One project per Hermes instance.

## MCP alternative

Grok Bot and Cursor should use remote MCP at https://socialposter.pro/mcp instead of REST.