Skip to main content

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​

ToolPurpose
list_accountsFind connected account IDs and reconnect status
list_postsCheck pending, scheduled, publishing, posted, and failed posts
schedule_postCreate a post that publishes on schedule, or waits for approval when that is on
approve_postApprove your own agent's post group for publishing
cancel_postDelete an unpublished post group
get_analyticsRead available published-post metrics
get_x_allowanceCheck 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.