Profiles and preferences
See every connected profile, and save the tone, hashtag style, and emoji rules you like so each session starts on brand.
- list_profiles
- get_user_preferences
- save_user_preferences
MCP server
Give your AI
a publish button.
Connect PublishBuddy to Claude, Cursor, or any MCP client. Ask for your top posts, draft next week's content, and schedule it, all without leaving the chat.
Endpoint: https://api.publishbuddy.com/mcp
Your AI client
publishbuddy · 22 tools
What were my top 3 posts last month? Draft something in the same style for Thursday evening and schedule it.
- get_top_postscount: 3, last month
- get_user_preferences
- create_postprofile: Instagram
- schedule_postThu 7:00 pm
Your top three were all short videos posted between 6 and 8 pm. I drafted a post in that style and scheduled it for Thursday at 7 pm on your Instagram profile. Want a first comment with hashtags on it?
How it works
Same tools.
Your choice of AI.
MCP (Model Context Protocol) is the open standard AI assistants use to call tools in other apps. PublishBuddy hosts an MCP server, the same one our in-app AI Agent runs on. Connect your own client and it gets the same 22 tools.
- 01
Create a key
In the app, open User Settings, then Login & Security, and generate an API key with MCP access. You see the value once, so store it somewhere safe.
- 02
Add the server
Point your client at the PublishBuddy MCP endpoint and send the key as a Bearer token. Copy-paste configs for Claude Code, Cursor, VS Code, Windsurf, and Claude Desktop are in the docs.
- 03
Ask
“What should I post this week?” “Schedule my best format for Thursday at 7 pm.” The assistant picks the right tools, and your client asks before it runs one.
Works withClaude CodeClaude DesktopCursorVS CodeWindsurfAny MCP client
What it can do
22 tools. Zero tab-switching.
Every tool respects the same permissions you have in the app. Read what you can read, change what you can change.
Posts
Create drafts with captions, media from your library, and labels. Update or delete them, and list what is drafted or already scheduled.
- create_post
- update_post
- delete_post
- get_draft_posts
- get_scheduled_posts
Scheduling
Schedule a draft for an exact date and time, or drop it into the profile's queue and let the next free slot take it.
- schedule_post
- add_post_to_queue
Analytics
Engagement summaries for a profile or the whole workspace, top or worst posts by any metric, best times to post, and hashtag performance.
- get_engagement_summary
- get_top_posts
- get_best_posting_times
- get_hashtag_performance
AI images
Generate an image for a post, edit it with a prompt, and check on the job. Finished images land in your media library.
- generate_image
- edit_image
- check_image_generation_status
Visual insights
Find out what drove a post's performance, search your library by colors, objects, or on-screen text, and turn reference posts into a creative brief.
- analyze_post_drivers
- analyze_post_visuals
- search_library
- build_creative_brief
- reextract_visuals
Use cases
Things people
actually do with it.
The dashboard is still there. MCP is for the moments when typing a sentence beats clicking through four screens.
Plan a week in one conversation
“Look at last month, tell me what worked, draft five posts in that style, and queue them.” One prompt, five scheduled posts.
Reporting where you already write
Pull August engagement for a client while your assistant drafts the monthly update, so the numbers land in the document without a copy-paste.
Post from your editor
In Cursor or Claude Code, publish the release note or the changelog post as the last step of shipping, from the same window you shipped in.
Ask the odd questions
“Which hashtags did best on my worst-performing month?” Chain the analytics tools together and let the assistant do the cross-referencing.
# Claude Code, one line
claude mcp add --transport http publishbuddy https://api.publishbuddy.com/mcp \
--header "Authorization: Bearer $PUBLISHBUDDY_TOKEN"
# Then, in the chat
> List my profiles and tell me which one has the most scheduled posts.
Guardrails and plans
Useful, not reckless.
MCP access is included on Pro and Business, and nothing about it loosens the rules your workspace already has.
- Scoped to one workspace. A key only reaches the workspace it belongs to, and only the profiles you can access in the app.
- Drafts first. Creating a post makes a draft. Scheduling it is a separate, explicit step, so nothing goes live by accident.
- Your client asks first. Claude Code, Cursor, and the rest ask before running a tool unless you switch that off. Revoke the key any time from User Settings.
- Credits only where it costs us. Analytics, drafting, and scheduling never use AI credits. Generating or editing an AI image draws from the same monthly credits as the in-app agent.
Want raw HTTP instead?
The public REST API covers posts, media, and analytics with the same personal access tokens. Use both: MCP for the conversation, the API for the pipeline.
Setup steps, per-client configs, and the tool reference live at docs.publishbuddy.com.
FAQs
Quick answers to the questions we get asked most. Can't find what you're looking for? Reach out to our support team and we'll get back to you promptly.
Model Context Protocol is an open standard that lets AI assistants call tools inside other apps. PublishBuddy hosts an MCP server, so any compatible assistant can read your data and take actions on your behalf, with your permission for each step.
Your social media.
One platform.
See what's working. Do more of it.
Join creators, agencies, and businesses who manage their social media smarter. Start for Free, no credit card, no commitment.
