posterly
Grok Bot + hosted HTTP MCP + skills

Schedule social posts from Grok Bot

Connect xAI's Grok Bot to posterly through the hosted HTTP MCP endpoint (Grok Bot supports remote MCP only), REST API calls, or a reusable skill file. Then let your cloud agent create, schedule, and analyse posts across 18 platforms.

Start plan, then add APICreate API keyMCP guide

Same posterly access layer as Claude, ChatGPT, Cursor, OpenClaw, Hermes, and custom automations.

Get Grok Bot connected in three steps

Start with an API key, add the hosted MCP endpoint as a connector, then let Grok Bot do the scheduling.

1

Enable API & MCP access

Open Dashboard → API & MCP, activate the API add-on (from $3/month; Agency API is $29/month), then create a posterly API key.

Open API dashboard
2

Add posterly as a custom connector

In Grok Bot open Settings, then Plugins / Connectors / MCPs, and add a custom connector with the Server URL https://www.poster.ly/api/mcp and your key as the bearer token. Grok Bot only talks to remote MCP servers, so use the hosted endpoint.

Read the hosted MCP guide
3

Ask Grok Bot to schedule

Once connected, Grok Bot can list accounts, find available slots, upload media, generate images, and create posts.

Read API reference

Connect Grok Bot to the hosted MCP endpoint

Grok Bot runs on a persistent cloud computer and only supports remote MCP servers over HTTP or SSE on the public internet. It cannot launch local stdio servers, so point it at the hosted posterly endpoint instead of the npm package.

Grok Bot connector (hosted HTTP MCP)

In Grok Bot open Settings (or Customize), then Plugins / Connectors / MCPs, and add a custom connector. Paste the Server URL below and send your posterly key as the bearer token. This is the same flow as grok.com/connectors, New Connector, Custom.

POST https://www.poster.ly/api/mcp
Authorization: Bearer pst_live_your_key_here
Content-Type: application/json

{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }

Grok Bot does not support local stdio MCP (npx ...), localhost, or private IPs. Use the hosted endpoint above; once the connector is saved the posterly tools appear in Grok Bot, often namespaced under the connector name.

Discovery metadata lives at /.well-known/mcp/server-card.json and auth metadata at /.well-known/oauth-protected-resource. See the full MCP setup guide for the hosted HTTP section.

Grok Build (CLI) and grok.com

Grok Build, the local terminal agent, supports both remote and local stdio MCP. Add posterly either way with the same key.

# remote (hosted HTTP MCP)
grok mcp add --transport http posterly https://www.poster.ly/api/mcp

# local stdio alternative
POSTERLY_API_KEY=pst_live_your_key_here \
  grok mcp add posterly -- npx -y posterly-mcp-server@latest

You can also edit ~/.grok/config.toml directly, and use /mcps and /plugins inside the Grok Build TUI. Set POSTERLY_API_KEY in the server environment for the stdio route.

For regular Grok chat on grok.com, open grok.com/connectors, choose New Connector, then Custom, and paste the same hosted MCP URL.

The posterly skill also works as a Grok Bot skill

Grok Bot stores skills as folders on the Bot's computer, and a skill is just a Markdown instruction file. The same SKILL.md that OpenClaw and Hermes use can teach Grok Bot when to use posterly MCP, when to fall back to REST, and what safety checks to apply before publishing.

Minimal reusable SKILL.md

Put this in a Grok Bot skill folder, or adapt the public posterly agent skill from GitHub.

Show SKILL.md example
---
name: posterly-social-manager
description: Schedule and manage social posts through posterly. Prefer MCP when available, fall back to REST with the same POSTERLY_API_KEY.
---

# posterly social manager

Use posterly to create, schedule, inspect, and analyse social posts.

Connection order:
1. Prefer the posterly MCP server when available.
2. Use REST API endpoints when MCP is not available.
3. Never publish immediately without showing the user the account, caption, media, and schedule first.

Auth:
- Environment variable: POSTERLY_API_KEY
- Base URL: https://www.poster.ly
- MCP npm package: posterly-mcp-server

Core actions:
- list accounts and brands
- find available slots
- upload media
- create, update, delete, and inspect posts
- get account and post analytics

Install or adapt the skill

Three routes: copy the skill folder onto the Bot's computer (the same way a marketplace plugin is installed), give the Bot the GitHub URL and ask it to clone and install it, or ask the Bot to create the skill for you. Then use @ to attach the plugin to a task and / for saved skills. Skills and plugins are shared across your bots.

Install the posterly skill from https://github.com/awpthorp/posterly-agent and use it for social scheduling.
View the OpenClaw skill page

Good agent behaviour

  • Confirm account, caption, media, and schedule before public posting.
  • Prefer MCP tools when available because schemas reduce mistakes.
  • Use REST fallback for scripts, cron jobs, and runtimes without MCP.
  • Always run whoami first so posts land in the right workspace.

What Grok Bot can do once connected

The hosted MCP endpoint exposes the same core tools as the API add-on, with structured schemas for safer agent use.

Common tools

get_mcp_statuswhoamicreate_api_keylist_accountslist_brandsget_brand_profilecreate_postlist_postsask_supportfind_available_slotupload_mediagenerate_captionsgenerate_imageget_account_analyticsget_post_analytics
See all MCP tools

Example Grok Bot prompts

  • “Use the posterly connector to list my accounts and tell me which X and LinkedIn profiles are connected.”
  • “Every Monday at 9am, draft three X posts from this week's changelog and ask me to approve before scheduling in posterly.”
  • “Generate an image for this launch, write an Instagram caption, and find the next free slot for it.”
  • “Pull my last 30 days of TikTok and LinkedIn analytics from posterly and recommend what to post next.”

Post to 18 platforms

Grok Bot can schedule through posterly to every supported social platform.

InstagramTikTokLinkedInYouTubeX (Twitter)FacebookThreadsPinterestGoogle Business ProfileBlueskyTelegramDiscordSlackMastodonDev.toHashnodeWordPressLemmy

Related setup guides

Use these pages together. Grok Bot is one route into the same API, MCP, and skill layer.

MCP setup guide

The canonical MCP page with client setup, hosted HTTP connection, OAuth metadata, and tool list.

Hermes integration

The same posterly access layer, connected to Hermes through npm MCP, HTTP MCP, REST, or a skill.

OpenClaw skill

The OpenClaw page includes the reusable SKILL.md pattern. It is Markdown, not OpenClaw-only magic.

Poke integration

Connect posterly to Poke as a custom MCP integration, then text Poke to schedule posts.

API dashboard

Activate the add-on, generate keys, and copy setup snippets from inside posterly.

REST API reference

Use direct HTTP calls from Grok Bot tasks, cron jobs, or custom automations.

Pricing

API & agent access is an add-on to any posterly plan.

API, MCP & Agent Access

$3/month

Add-on to any posterly plan (from $7/mo)

  • Grok Bot + hosted HTTP MCP + REST API
  • Reusable Markdown skill workflows
  • 75 hosted HTTP MCP tools for status checks, scoped API keys, schemas, scheduling, support, media, brands, analytics, webhooks, OAuth, connect sessions, subscription management, and GBP
  • 100 create-post requests/hour plus separate media/read limits
  • All 18 supported platforms
Start plan, then add API

Grok Bot questions

Does Grok Bot support local stdio MCP?+

No. Grok Bot only connects to remote MCP servers over HTTP or SSE that are reachable on the public internet, so npx-style local servers, localhost, and private IPs will not work. Add https://www.poster.ly/api/mcp as a custom connector with your posterly key as the bearer token.

What about Grok Build?+

Grok Build, the local terminal agent, supports both. Use grok mcp add --transport http posterly https://www.poster.ly/api/mcp for the hosted endpoint, or grok mcp add posterly -- npx -y posterly-mcp-server@latest with POSTERLY_API_KEY set for local stdio. You can also edit ~/.grok/config.toml.

Can I use the OpenClaw or Hermes skill with Grok Bot?+

Yes. The useful part is the SKILL.md file. Give Grok Bot the GitHub URL https://github.com/awpthorp/posterly-agent and ask it to install the skill, or copy the folder onto the Bot's computer, then attach it with @ or / when you want repeatable posterly behaviour.

What can Grok Bot schedule?+

All 18 posterly platforms: Instagram, TikTok, LinkedIn, YouTube, X, Facebook, Threads, Pinterest, Google Business Profile, Bluesky, Telegram, Discord, Slack, Mastodon, Dev.to, Hashnode, WordPress, and Lemmy.

Ready to connect Grok Bot?

Start posterly, activate API access, create a key, then add the hosted MCP endpoint as a Grok Bot connector or load the skill.

Start plan, then add APIRead MCP guide