MCP server for AI agents
Connect any AI agent to your social media
Claude, ChatGPT, Cursor, Claude Code and any MCP client can draft, schedule, publish and analyze posts on 15+ networks through Onlypult — drafts first, and you decide what goes live.
What failed to publish overnight? Fix what you can, then draft tomorrow's posts for LinkedIn and Telegram.
Two posts failed overnight on a network timeout — both re-sent and published. Tomorrow's drafts are in your calendar for review:
- DraftLinkedIn — product update with the new pricing table
- DraftTelegram — weekly digest, 5 links
How it works
Onlypult sits between your agent and your social accounts. The agent works with posts and profiles — never with network passwords.
- 1
You ask
Describe the job in plain words — in Claude, ChatGPT, your IDE or your terminal.
- 2
The agent calls Onlypult
Over MCP it reads your profiles, timezone and plan limits, then creates or edits posts.
- 3
Posts land in your calendar
As drafts or scheduled posts, next to everything your team already planned.
- 4
Onlypult publishes
To 15+ networks through official APIs — with retries for failures and analytics afterwards.
Connect in under five minutes
Every agent uses the same server address. Chat apps sign in with OAuth; coding agents use an API key.
https://mcp.onlypult.com/mcp - 1
Start a trial and connect your accounts
Create an Onlypult account and link the social profiles your agent may post to. 7 days free, no card.
- 2
Add the server to your agent
Paste the URL above as a custom connector in Claude or ChatGPT, or add it to your coding agent's MCP config with an op_ API key from Settings → API Keys.
- 3
Start with something small
Ask “Show my connected profiles”, then “Draft a LinkedIn post about our launch” — and open your Onlypult calendar to see the draft.
Want the agent to upload files straight from your disk? Run the local package (npx -y @onlypult/mcp@latest) instead of the hosted URL — it adds media_upload_file for Cursor, Claude Desktop, Codex, Windsurf and other stdio clients.
Setup guides for every AI agent
Step-by-step instructions, ready-to-paste config and prompts that work — for the agent you already use.
Claude.ai and Claude Desktop. Add a custom connector, sign in with Onlypult — no API key to paste.
Setup guideCustom connector on Plus and Pro, or Developer mode on any plan. OAuth sign-in, then mention @Onlypult.
Setup guideOne command in the terminal. Turn a changelog, a release or a repo into posts without leaving the CLI.
Setup guideAdd Onlypult to .cursor/mcp.json — hosted, or the local package that uploads files straight from disk.
Setup guideAdd Onlypult to the Codex CLI or IDE extension via config.toml or codex mcp add.
Setup guideAdd Onlypult to Cascade in Windsurf via mcp_config.json — hosted or local package.
Setup guideGemini CLI, Antigravity, VS Code, Cline, Zed, n8n — anything that speaks MCP works with the same URL and an API key, or with the local package.
Open the MCP docsWhat your agent can do with Onlypult
Real jobs, not demos. Each one is a single request in plain language.
Plan a content week
The agent checks your timezone and plan, then fills the calendar with drafts for each network.
“Draft five LinkedIn posts for next week about our new feature — one per weekday. Drafts only.”
account_getprofiles_listposts_create Repurpose one piece everywhere
One article becomes a LinkedIn post, an X post, a Telegram announcement and an Instagram caption — each within that network's limits.
“Turn this article into posts for LinkedIn, X, Telegram and Instagram. Stay within each network's limits.”
posts_limitsposts_create Reels, Shorts and Stories
Send one vertical video as an Instagram Reel and a YouTube Short, with title and category filled in.
“Post this video as a Reel on Instagram and a Short on YouTube tomorrow at 18:00, titled “3 tips in 30 seconds”.”
posts_create_reelsposts_create_shortsprofiles_get_youtube_categories Fix what failed
The agent finds failed posts, explains why, and re-sends everything that can be retried — in one call.
“What failed to publish this week? Retry what can be retried and tell me what needs my attention.”
posts_list_failedposts_retry_all_failed Weekly performance report
Reach, followers and top posts for a period, compared with the previous one — with data gaps called out, not hidden.
“Compare this month with last month for Instagram and LinkedIn. Which posts drove the difference?”
analytics_compare_periodsanalytics_top_posts Post at the best time
The agent reads your weekday × hour engagement heatmap and schedules for the hours your audience is actually online.
“When is my Instagram audience most active? Schedule tomorrow's post for the best slot.”
analytics_best_timeposts_create Your agent gets hands, not the publish button
Most "AI posting" setups are all-or-nothing. Onlypult lets you hand an agent the busywork and keep the final say — on every post.
Drafts by default
Ask for a draft and the agent sends is_draft: true. The post is saved to your calendar and goes nowhere until a person — or an explicit "publish now" — says so.
Per-tool permissions
In Claude, ChatGPT, Cursor and most MCP clients you approve tools one by one. Keep reads and drafts on "Always allow", leave publishing and deleting on "Ask every time".
Everything lands in your calendar
Every post an agent creates shows up in the Onlypult calendar next to your team’s posts. Edit it, reschedule it, or send it through approval before it goes live.
OAuth for chat apps, keys for code
Claude and ChatGPT connect with OAuth 2.1 — you sign in on onlypult.com and the chat app never sees your password. Coding agents use an op_ API key from Settings → API Keys.
Errors an agent can act on
Validation errors come back with a code and a retryable flag. The agent explains "your plan ends on the 5th, pick an earlier date" instead of retrying in a loop.
Prompt-injection aware
Captions and comments pulled in by analytics are marked as untrusted external content, so the agent summarizes them instead of following instructions hidden inside.
Every tool your agent gets
One MCP server covers the whole post lifecycle — context, publishing, media, hashtags, repair and analytics. 37 tools.
Posts & scheduling
14Draft, schedule, publish, cross-post, edit, delete and repair.
-
posts_createDraft, schedule or publish to one or many profiles -
posts_create_storyStories for Instagram, Facebook, VK -
posts_create_reelsInstagram and Facebook Reels -
posts_create_shortsYouTube Shorts -
posts_publish_nowPublish immediately -
posts_cross_postSame content to 2+ profiles -
posts_listFind posts by status, profile, date, type -
posts_list_failedWhat failed to publish -
posts_getOne post with its status -
posts_updateEdit a draft or scheduled post -
posts_deleteRemove a draft or scheduled post -
posts_retryRe-send one failed post -
posts_retry_all_failedRe-send every failed post at once -
posts_limitsCharacter, hashtag and media limits per network
Analytics (read-only)
8Reach, followers, top posts, best time, period over period.
-
analytics_profiles_listProfiles connected to analytics -
analytics_metrics_listMetric catalog with formulas -
analytics_overviewHeadline numbers for a period -
analytics_audienceFollowers over time and demographics -
analytics_postsPost, story and profile metrics over time -
analytics_top_postsRank posts by any metric -
analytics_best_timeWeekday × hour engagement heatmap -
analytics_compare_periodsThis period vs the previous one
Account & profiles
6Timezone, plan limits, connected profiles, boards and categories.
-
account_getTimezone, plan end date, date format -
profiles_listConnected profiles with IDs -
profiles_getOne profile’s details -
profiles_platforms_listSupported networks -
profiles_get_pinterest_boardsBoards to pin to -
profiles_get_youtube_categoriesCategories for a video
Hashtag sets
6Reuse saved hashtag groups per profile instead of retyping them.
-
hashtags_listSaved hashtag sets for a profile -
hashtags_createAdd a tag to a set -
hashtags_deleteRemove a tag -
hashtag_groups_createCreate a hashtag set -
hashtag_groups_updateRename a set -
hashtag_groups_deleteDelete a set
Media
3Public URLs, browser upload, or direct upload from disk.
-
media_get_upload_urlOne-time browser upload page -
media_check_statusGet file IDs after upload -
media_upload_fileUpload a file from a local path local package
Publish to 15+ networks from one chat
The agent picks profiles from your Onlypult workspace — every account you connected over official OAuth is available, with per-network options like Reels, Shorts, Stories, boards and first comments.
Building your own agent?
The same capabilities are available over REST. Your backend, an n8n or Make flow, or a custom LLM agent can call the Onlypult API with a Bearer key.
- REST API with an OpenAPI spec
- Same data as MCP: profiles, media, posts, analytics
- Stable error codes with a retryable flag
- AI-readable docs in llms.txt and mcp.md
AI agents and Onlypult: FAQ
Is there an MCP server for social media?
Yes. Onlypult runs a hosted MCP server at https://mcp.onlypult.com/mcp. Any MCP-compatible agent can use it to draft, schedule, publish, retry and analyze posts across 15+ networks — 37 tools in total. Nothing to install or host.
Which AI agents work with Onlypult?
Claude (web and desktop), ChatGPT, Claude Code, Cursor, Codex and Windsurf have step-by-step guides on this page. Any other MCP client — Gemini CLI, Antigravity, VS Code, Cline, Zed, n8n — works with the same server URL.
Do I need an API key, or can I sign in with OAuth?
Claude and ChatGPT connect with OAuth 2.1: you sign in to Onlypult in the browser and approve access, no key to paste. Coding agents and the local package use an op_ API key created in Settings → API Keys. The key is shown once, so store it in a password manager or environment variable.
Will the agent publish without my approval?
Only if you let it. Ask for drafts and the agent saves posts with is_draft: true — they wait in your calendar. In most MCP clients you can also keep publishing and deleting on “ask every time” while reads and drafts are always allowed.
Can the agent post to Instagram, LinkedIn and TikTok?
Yes — and to Facebook, YouTube, Pinterest, Threads, X, Bluesky, Telegram, WordPress, Google Business and more. Network-specific formats are supported: Reels, Shorts, Stories, Pinterest boards, YouTube categories and first comments.
How does the agent attach images and videos?
Three ways. Pass up to 10 public URLs and Onlypult downloads the files itself. Or the agent gives you a one-time upload page to drag files into. Or, with the local package, it uploads files straight from a path on your disk.
What happens if a post fails to publish?
The agent can list failed posts with posts_list_failed and re-send them with posts_retry or posts_retry_all_failed. Errors carry a code and a retryable flag, so the agent knows when to retry and when to ask you — for example, to reconnect an account.
Can the agent read my analytics?
Yes, read-only, for Instagram, Facebook, LinkedIn, TikTok and X profiles connected to Onlypult Analytics: overview, audience, post metrics, top posts, best time to post and period-over-period comparison.
How is this different from Zapier or n8n?
Zapier and n8n run workflows you design in advance. An agent works out the steps from a plain-language request — and can still hand off to your workflows. If you want a fixed pipeline, use the Onlypult REST API from n8n or Make; if you want to delegate, use MCP.
Is MCP included in my plan?
Yes. MCP and the REST API are included on every Onlypult plan, including the 7-day free trial. There is no separate developer tier and no per-profile API fee.
Should I use the hosted server or the local package?
Use the hosted server for zero setup and for chat apps like Claude and ChatGPT. Use the local package (npx -y @onlypult/mcp@latest, Node.js 18+) when your agent runs on your machine and should upload files from disk.
MCP is included on every plan
- Works on the 7-day free trial
- No credit card to start
- No separate developer tier
- No per-profile API fee
Let your agent handle the busywork
Start the free trial, connect your accounts, and have your agent draft the first week of posts tonight. You approve what goes live.
7-day free trial · No credit card · MCP and API on every plan
