KreatorMesh Agent Mode

Give your AI agent the ability to draft, check and schedule social posts — and, more usefully, to find out what has actually worked on your audience before it writes anything.

Supports: TikTok, Instagram, YouTube, X (Twitter), LinkedIn, Facebook, Threads, Pinterest, Bluesky, Google Business Profile.

Built on KreatorMesh.

Two skills, and one of them is free

Skill	Needs an account?	What it does
hook-testing-method	No	How to work out which opening lines hold attention on your audience, instead of following generic hook advice. Method only — a spreadsheet is enough.
kreatormesh	Yes	Draft, check against your learned rules, schedule, and review — through KreatorMesh.

The first is free and standalone on purpose. Most hook advice is an average taken across audiences that are not yours, and the fix is measurement rather than better advice. That skill explains how to do it by hand. It is genuinely useful without paying anyone.

Install

As skills (Claude Code, Cursor, Windsurf, Codex and others)

npx skills add orkuma-alex/kreatormesh-agent-mode

Install just one:

npx skills add orkuma-alex/kreatormesh-agent-mode --skill hook-testing-method

As an agent plugin

The repo root is a portable Agent Plugin (spec 1.0.0): plugin.json + mcp.json + skills/. Claude Code additionally reads .claude-plugin/. Both layouts sit side by side, so the same repo works either way.

CLI only

npx kreatormesh-cli setup --key km_live_...
npx kreatormesh-cli accounts

Node 18+. No dependencies.

Connecting

You need a KreatorMesh account on the Creator plan or above and an API key from https://kreatormesh.com/api-keys. Keys are shown once.

MCP — point your client at https://api.kreatormesh.com/api/mcp with the key as a bearer token, or set KREATORMESH_API_KEY and use the bundled mcp.json.

CLI — npx kreatormesh-cli setup --key km_live_..., or set KREATORMESH_API_KEY in the environment (preferred in CI and agent sandboxes, since it leaves nothing on disk).

Tools

Tool	Use it for
list_connections	account ids, handles and platforms — call this first
list_hook_rules	rules learned from this account's completed hook tests
check_draft	check a caption against those rules before publishing
list_posts	drafts, scheduled, posted and failed
get_performance	cross-platform results for recent posts
list_evergreen	posts that already performed and are being recycled
schedule_text_post	save a draft, or schedule a text post

The ordering is the point. check_draft between writing and scheduling is what makes this different from a cross-poster: it tells you which of your measured rules a draft breaks, and by how much.

Known limits, stated up front

• Text posts only through these tools. Video and images need the REST API and a real upload.
• check_draft returns nothing until a hook test has completed in the app. An empty result means "no rules learned yet", not "the draft is fine". The free hook-testing-method skill explains the method meanwhile.
• API keys cannot manage API keys. Listing, creating and revoking need a signed-in session, so a leaked key cannot mint more or revoke the one you are using to investigate it.
• A key acts as its owner. Anything these tools can do, that person could do.

Security

Keys are stored hashed server-side — the plaintext is shown once and cannot be retrieved, so a lost key is replaced rather than recovered. Revoke at https://kreatormesh.com/api-keys; revocation takes effect on the next request.

The CLI saves a key to ~/.kreatormesh/config.json with owner-only permissions where the platform supports it. KREATORMESH_API_KEY takes precedence and writes nothing to disk.

Registry listing

server.json is the official MCP Registry entry; see PUBLISHING.md.

Licence

MIT. See LICENSE.