Claude Code MCP
Post to social media from Claude Code
One command adds Onlypult to Claude Code. Turn a changelog, a release or a folder of screenshots into drafts and scheduled posts on 15+ networks — without leaving the terminal.
- One command
- Hosted or local
- Uploads from disk
Read CHANGELOG.md for v2.4 and draft a LinkedIn post and an X post announcing it. Attach ./docs/release.png.
Two drafts created with the screenshot attached:
- DraftLinkedIn — “v2.4 is out: faster exports and SSO”
- DraftX — 3 highlights + link to release notes
How to add Onlypult to Claude Code
Create an API key, run one command, and check the server with /mcp.
https://mcp.onlypult.com/mcp - 1
In Onlypult, open Settings → API Keys and create a key. It starts with
op_and is shown once — copy it somewhere safe. - 2
Run the command below in your terminal. Add
--scope userto make Onlypult available in every project. - 3
Start Claude Code and run
/mcp— onlypult should show as connected.
claude mcp add --transport http onlypult https://mcp.onlypult.com/mcp \
--header "Authorization: Bearer op_your_api_key" Runs the Onlypult MCP server on your machine, so Claude Code can upload images and videos straight from your repo with media_upload_file. Requires Node.js 18+.
- 1
In Onlypult, open Settings → API Keys and create a key. It starts with
op_and is shown once — copy it somewhere safe. - 2
Run the command below. Claude Code starts the package with
npxon first use. - 3
Run
/mcpto check the connection.
claude mcp add onlypult --env ONLYPULT_API_KEY=op_your_api_key \
-- npx -y @onlypult/mcp@latest Share the server with your team through a project file. The key stays in each developer's environment, not in git.
- 1
Add
.mcp.jsonto the project root with the block below and commit it. - 2
Each developer sets
ONLYPULT_API_KEYin their shell profile with their own key. - 3
Claude Code asks each developer to approve project servers the first time.
{
"mcpServers": {
"onlypult": {
"type": "http",
"url": "https://mcp.onlypult.com/mcp",
"headers": {
"Authorization": "Bearer ${ONLYPULT_API_KEY}"
}
}
}
} Check it worked: ask Claude Code “Show my connected social profiles in Onlypult”.
Claude Code prompts that work
Claude Code sees your repo, so it can write posts from real release notes, docs and assets.
Release announcement
“Read the latest entry in CHANGELOG.md and draft posts for LinkedIn, X and our Telegram channel. Drafts only.”
Screenshots to a carousel
“Upload every PNG in ./launch/screens and create an Instagram multi-image post draft with a caption explaining each feature.”
Docs to a tips series
“Go through docs/guides and draft eight short tips for LinkedIn, one per guide, scheduled every Tuesday and Thursday at 10:00.”
Commit log to a weekly update
“Summarize this week's merged commits into a user-facing “What's new” post for Telegram and schedule it for Friday 17:00.”
Fix last night's failures
“List failed Onlypult posts from the last 24 hours, explain the errors and retry the retryable ones.”
Check limits first
“Check posts_limits for our X and Threads profiles and shorten the drafts in ./social/*.md to fit before creating them.”
Skills for Claude Code
Install the Onlypult plugin in Claude Code with two commands
The plugin bundles the Onlypult skills with the MCP connection, so Claude Code knows the house rules for each job: which tool to call, how to format the time, how to read analytics, how to diagnose a failed post before retrying it. Because it can read the files in your repo, the skills that turn existing writing into posts are where it shines.
Install for Claude Code
Add the marketplace, then install the plugin. Two commands in any Claude Code session. Sign in with Onlypult on the first tool call.
/plugin marketplace add onlypult/agent-skills
/plugin install onlypult@onlypult Already added the MCP server by hand? Run claude mcp remove onlypult first, so Claude Code does not hold two connections to the same server.
Schedule a post
Draft, schedule or publish a post in the right timezone, on the right profile, with plan limits and platform options handled.
Cross-post
Send one message to several networks, checking each platform’s text and media limits first.
Reels, Shorts and Stories
Pick the right tool and flags for Instagram and Facebook Reels, YouTube Shorts and Stories.
Upload media
Choose between a public URL, a browser upload and a direct upload from a local file path.
Fix failed posts
Find what failed, explain why, fix the cause and retry only when a retry can work.
Analytics report
Followers, reach, engagement and top posts, read correctly, with coverage gaps and derived metrics explained.
Best time to post
Find the best days and hours from the engagement heatmap and schedule posts into those slots.
Content calendar
Plan a week or a month around what already works, show the plan first, create posts after you approve.
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_createposts_create_storyposts_create_reelsposts_create_shortsposts_publish_nowposts_cross_postposts_listposts_list_failedposts_getposts_updateposts_deleteposts_retryposts_retry_all_failedposts_limits Analytics (read-only)
8Reach, followers, top posts, best time, period over period.
analytics_profiles_listanalytics_metrics_listanalytics_overviewanalytics_audienceanalytics_postsanalytics_top_postsanalytics_best_timeanalytics_compare_periods Account & profiles
6Timezone, plan limits, connected profiles, boards and categories.
account_getprofiles_listprofiles_getprofiles_platforms_listprofiles_get_pinterest_boardsprofiles_get_youtube_categories Hashtag sets
6Reuse saved hashtag groups per profile instead of retyping them.
hashtags_listhashtags_createhashtags_deletehashtag_groups_createhashtag_groups_updatehashtag_groups_delete Media
3Public URLs, browser upload, or direct upload from disk.
media_get_upload_urlmedia_check_statusmedia_upload_file 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.
Claude Code tips and troubleshooting
Hosted vs local
The hosted server is enough for text and public image URLs. Use the local package when Claude Code should upload files from your repo — the hosted server can't read your disk.
Server shows as failed in /mcp
For the hosted server, check that the header is exactly Authorization: Bearer op_…. For the local package, check that Node.js 18+ is installed and npx is on your PATH.
Keep keys out of git
Use ${ONLYPULT_API_KEY} in .mcp.json and keep the real key in your environment. Each key belongs to an Onlypult account — create a separate key per teammate.
Permissions
Claude Code asks before running MCP tools. Allow read and draft tools for the session; keep posts_publish_now and posts_delete on ask.
“Cannot schedule after your plan end date”
Posts can't be scheduled past your plan's end date. The agent reads it from account_get and should pick an earlier date or ask you to renew. This error is marked retryable: false, so a well-behaved agent stops instead of looping.
Claude Code and Onlypult: FAQ
Can Claude Code post to social media?
Yes. With the Onlypult MCP server added, Claude Code can draft, schedule and publish posts to 15+ networks and attach images from your repo.
What's the command to add Onlypult to Claude Code?
claude mcp add --transport http onlypult https://mcp.onlypult.com/mcp --header "Authorization: Bearer op_your_api_key". For local file uploads use: claude mcp add onlypult --env ONLYPULT_API_KEY=op_your_api_key -- npx -y @onlypult/mcp@latest.
Can Claude Code upload images from my project?
Yes, with the local package. It adds media_upload_file, which uploads a file from a local path and returns an ID for posts_create.
Can I use it in CI or scripts?
For fixed pipelines, call the Onlypult REST API directly with the same API key — it's more predictable than an agent. Use Claude Code when you want it to decide what to write.
Is it included in my plan?
Yes. MCP and the API are on every Onlypult plan, including the 7-day free trial.
Connect another AI agent
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 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 guideMCP 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
Ship the release and the posts together
Add Onlypult to Claude Code and let it announce what you just built — as drafts you approve.
7-day free trial · No credit card · MCP and API on every plan
