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.

Start for FreeSetup guide

Endpoint: https://api.publishbuddy.com/mcp

Your AI client
publishbuddy · 42 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 42 tools.

  1. 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.

  2. 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.

  3. 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

42 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.

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

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
Full tool reference

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 your access. A key acts as you: it reaches only the workspaces you belong to and the profiles you can access in the app. Clients use your active workspace unless they name another.
  • 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 for AI work. Drafting, scheduling and most reads are free. A few tools use AI credits: get_top_posts (1), image generation and edits (17 each), and AI Studio media at the model's price.
Try Pro free for 14 daysCompare plans

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.

Explore the API

Setup steps, per-client configs, and the tool reference live at docs.publishbuddy.com. Coding agents can read the whole site as Markdown from its llms.txt.

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.

What is MCP?

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.

Which clients work with it?

Claude Code, Cursor, VS Code, and Windsurf connect directly. Claude Desktop connects through the mcp-remote bridge. In general, anything that supports remote MCP servers with a Bearer token works. Clients that only support OAuth sign-in are not supported yet.

Is this the same as the in-app AI Agent?

Same server, same tools. The in-app AI Agent adds a chat interface, conversation history, and confirmation cards. MCP lets you use the assistant you already have, with the same access to your accounts.

Can the AI publish without asking me?

Your client asks before it runs a tool unless you turn that off. On top of that, creating a post only makes a draft. Scheduling or queueing it is a separate call, so publishing is always a deliberate step.

Does it use my AI credits?

A few tools do. get_top_posts costs 1 credit, generate_image and edit_image cost 17 each, and generate_media and animate_image charge the model's AI Studio price, which quote_media tells you first. Every other tool is free. Credits come from the same monthly pool as the in-app agent (500 on Pro, 2,500 on Business), and calls that fail aren't charged.

Which plans include MCP access?

Pro and Business. The Free plan does not include it. During a 14-day trial of either paid plan you can connect an MCP client, no credit card required.

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.

Start for Free