Connect an AI agent
UniPost runs a hosted MCP server for scheduling, approval, publishing, and available analytics. Connect an agent to one workspace, then ask it to schedule posts that publish on time, or wait for your approval if you've turned that on.
Server URL
https://mcp.unipost.ai/mcp
Add it as a remote HTTP MCP server or custom connector. Use OAuth sign-in when your client supports it; no manually supplied headers are needed for that flow.
The first connection opens UniPost in your browser. Sign in, choose the workspace the agent may use, review the access, and select Allow. Only workspace owners and admins can authorize agent connections.
Choose your client
Client menus and custom-connector availability can vary by version and account plan. Use its remote MCP configuration with the server URL above. Each client also has a four-step guide: Claude, Claude Code, ChatGPT, Codex, Cursor, Grok Bot, and Gemini CLI.
Grok and Grok Bot
In Grok, open its connectors settings and add a custom connector. In Grok Bot, add a custom MCP server under Plugins. Paste the server URL and complete UniPost's authorization flow when offered.
Connecting UniPost does not connect or authorize a payment wallet. See agent payments if you also want the agent to help purchase a subscription.
Claude
For Claude web, desktop, or mobile, open UniPost in Claude's connector directory and select Connect. You can also add it yourself under Customize → Connectors as a custom connector using the server URL.
For Claude Code:
claude mcp add --transport http unipost https://mcp.unipost.ai/mcp
Then run /mcp and choose UniPost to sign in.
ChatGPT
Open UniPost in ChatGPT's plugin directory and select Install plugin, then sign in. You can also create a custom MCP app with the server URL after enabling developer mode under Settings → Apps → Advanced settings.
Codex
Add this server to ~/.codex/config.toml:
[mcp_servers.unipost]
url = "https://mcp.unipost.ai/mcp"
Then authorize it:
codex mcp login unipost
Cursor and other MCP clients
Add an HTTP MCP server with the server URL and use browser authorization. If the client cannot complete OAuth, use the API key fallback.
Markdown skills
Agents that read Markdown skills instead of MCP configuration, such as OpenClaw and Hermes, and any agent supported by the skills CLI, can install the UniPost skill. It documents the server, when posts publish on schedule or wait for approval, and every tool.
For OpenClaw:
npx skills add ajhous44/unipost-agent -g -a openclaw -y
# or: openclaw skills install git:ajhous44/unipost-agent
For other agents (Hermes, the skills CLI, and similar):
npx skills add ajhous44/unipost-agent
Source: github.com/ajhous44/unipost-agent.
Try your first request
Ask: “List the social accounts in this workspace.” Confirm that the accounts belong to the intended workspace.
Then ask: “Prepare a post for tomorrow at 9 a.m., including my timezone. Show me the full text and destination accounts before you schedule it.”
schedule_post publishes on schedule by default. When approval is on (or the post includes TikTok), it creates a pending post and returns an approval link. Review pending posts in the chat, through the link, or under Overview → Needs attention. See scheduling and approval.
Available tools
| Tool | Purpose |
|---|---|
list_accounts | Find connected account IDs and reconnect status |
list_posts | Check pending, scheduled, publishing, posted, and failed posts |
schedule_post | Create a post that publishes on schedule, or waits for approval when that is on |
approve_post | Approve your own agent's post group for publishing |
cancel_post | Delete an unpublished post group |
get_analytics | Read available published-post metrics |
get_x_allowance | Check remaining X credits and posting limits |
Read the tool reference for parameters and publishing behavior. The server does not expose billing tools or an MPP payment endpoint.
Usage and access
The 2 free accounts include 500 agent tool calls each month. Paid plans include 1,000 per account of purchased capacity. Requests are limited to 60 per minute per workspace. Check usage in Billing.
OAuth uses PKCE, and access tokens expire after 24 hours. Clients supporting refresh tokens can renew their access. Review or revoke agents under API keys. See credentials and security and limits.