Agent setup

Set up Creagency with Hermes Agent

Configure the local Creagency MCP server in Hermes so recurring launch, newsletter, and product update tasks follow one reliable path.

Open landing page Read Creagency skill guide

Quick start

Step 1

Create a scoped Creagency API key

Use a key with post, asset, and integration scopes. The agent should not receive your social platform passwords.

Step 2

Install the local tooling

Install @creagency/agent, export CREAGENCY_API_KEY, and verify the workspace with auth:status and integrations:list.

Step 3

Add the Creagency skill

Give the agent the Creagency API rules so it knows account discovery, media upload, draft creation, and publish confirmation.

Step 4

Run the first draft

Ask for a draft and require the agent to show the connected account and post summary before scheduling or publishing.

Setup surfaces

Skill

Install the Creagency skill so Hermes uses the real API rules instead of inventing endpoints.

Install the skill file in the agent's supported skill directory.

Tell the agent to read the skill before it drafts, uploads media, or prepares publish actions.

Keep API keys outside prompts and chat transcripts.

Install the Creagency skill

Use this for agents that read local skill files.

mkdir -p ~/.agents/skills/creagency-api
curl -fsSL https://creagency.ai/.agents/skills/creagency-api/SKILL.md \
  -o ~/.agents/skills/creagency-api/SKILL.md

Open docs

CLI

Use parseable terminal commands when the agent can run local shell tools.

Install @creagency/agent globally or call it with npx.

Set CREAGENCY_API_KEY and CREAGENCY_API_ORIGIN in the shell or agent environment.

Run auth:status and integrations:list before creating a post.

Creagency CLI baseline

Start every local agent setup with an auth check and account discovery.

npm install -g @creagency/agent
export CREAGENCY_API_KEY=creagency_xxx
export CREAGENCY_API_ORIGIN=https://api.creagency.ai

creagency auth:status --json
creagency integrations:list --json

Open docs

Hermes MCP

Add creagency-mcp under mcp_servers in ~/.hermes/config.yaml. Hosted remote MCP is planned as a separate OAuth-based connector. Use the local CLI and stdio MCP server today.

Add a stdio server with command and args.

Put CREAGENCY_API_KEY in ~/.hermes/.env or the runtime environment.

Start hermes chat and ask Hermes to list Creagency integrations first.

Hermes config.yaml

mcp_servers:
  creagency:
    command: "npx"
    args: ["-y", "-p", "@creagency/agent", "creagency-mcp"]
    env:
      CREAGENCY_API_ORIGIN: "https://api.creagency.ai"

Open docs

Prompt examples

Newsletter repurposing

Hermes turns a newsletter into platform-specific drafts.

Prompt

Use Creagency to create LinkedIn, X, and Threads drafts from this newsletter. Keep each opening line different.

Expected outcome

Three drafts are created from one source without publishing.

Recurring campaign prep

Hermes follows the same sequence for each launch campaign.

Prompt

Prepare a three-post launch campaign in Creagency. List accounts first and keep publish actions gated.

Expected outcome

The campaign is drafted in Creagency with account visibility.

Campaign media

Hermes uploads a campaign image and links it to the relevant posts.

Prompt

Upload ./campaign.png, attach it to the LinkedIn draft, and show me the asset id.

Expected outcome

The asset is uploaded and attached to the draft.

Tool filter check

Hermes verifies the MCP server before using it for social work.

Prompt

Check that Creagency MCP tools are available, then list connected social accounts.

Expected outcome

Hermes confirms the tool surface before drafting.

Safety rules

Read connected accounts before creating or scheduling content.

Keep API keys in environment variables and never print them in chat.

Create drafts first when the user has not explicitly asked to schedule.

Prepare publish and delete actions before execution, then ask for confirmation.

Troubleshooting

Hermes cannot see connected accounts.

Run creagency auth:status --json, then integrations:list --json. If the list is empty, connect social accounts in Creagency first.

A post command fails with a missing scope.

Create or rotate the API key with posts:read, posts:write, assets:read, assets:write, and integrations:read.

The agent tries to publish immediately.

Point it back to the skill rule: create or schedule a draft first unless the user explicitly confirms publish.

Sources

Hermes MCP docsOpen

Creagency Agent READMEOpen

Creagency skill docsOpen