Home / AI agents / Cursor
MCP

Schedule social media posts with Cursor

Add Postozo to Cursor with a few lines of JSON. Then let Cursor's agent write launch posts from your code, docs and release notes, and schedule them.

Works in: the Cursor editor and its agent. Connects with: an API key header. Setup steps follow Cursor's own docs, checked on 29 September 2026.

How to connect Postozo to Cursor

You need a Postozo account with at least 1 connected channel. Cursor connects to Postozo's MCP server at https://app.postozo.com/mcp using an API key header.

  1. In Postozo, open Settings, Developers and copy your API key. It starts with pz_live_. Treat it like a password.
  2. Open ~/.cursor/mcp.json to use Postozo in every project, or .cursor/mcp.json in a project to use it there only. Create the file if it does not exist.
  3. Add Postozo:
{
  "mcpServers": {
    "postozo": {
      "url": "https://app.postozo.com/mcp",
      "headers": { "Authorization": "Bearer ${env:POSTOZO_API_KEY}" }
    }
  }
}
  1. Set the environment variable POSTOZO_API_KEY to your key, or paste the key in place of ${env:POSTOZO_API_KEY} if the file is not shared.
  2. Save the file, reload Cursor, and ask the agent: "List my Postozo channels".

Cursor also supports OAuth for remote servers. We document the API key header because it is the method Cursor's docs show for headers and it needs no browser step.

Check it works

Ask the Cursor agent: "List my Postozo channels."

What Cursor can do with Postozo

Postozo gives Cursor 20 tools. A normal flow is: list your channels, read the rules of each network, check the post, find a free slot, then schedule it once you say yes.

ToolWhat it doesChanges data
list_channelsList the connected social channels (accounts, pages) with their id, network, name and status. Call this first to get channel ids.No
list_networksList every network this server supports and whether it can be connected. Useful to explain what is possible.No
list_customersList customers. A customer groups channels (agencies use 1 per client).No
get_channel_rulesGet the posting rules for 1 channel: max length, media needs, whether comments are supported, and the settings schema (some settings are required, for example a title on YouTube or a board on Pinterest). Read before scheduling to that channel.No
find_free_slotFind the next free posting time for these channels, using each channel's preferred posting times.No
check_postCheck a post against every channel's rules without saving it. Returns a list of problems (empty means it is fine).No
schedule_postCreate or edit a post for 1 or more channels. Supports drafts, scheduling, posting now, client review, threads with delays, per-channel text, network settings, tags and repeats. Returns the post id, its status and a preview link.Yes
list_postsList posts on the calendar between 2 dates (default: last 7 days to next 30 days).No
get_postGet 1 post with its text per channel, state per channel (queued, published, error...), links to the live posts, errors with a fix, comments and history.No
change_post_dateMove a post to a new date and time.Yes
retry_postRetry the channels of a post that failed or could not be confirmed. Only use after the user confirms the post is not already live.Yes
delete_postDelete a post from the calendar. Posts already live on a network stay live there.Yes
upload_media_from_urlImport an image or video from a public URL into the media library. Returns a media id to use in schedule_post.Yes
list_mediaList files in the media library.No
list_tagsList tags used to label posts.No
get_analyticsGet account statistics for 1 channel from its network (7, 30 or 90 days). Some networks do not share statistics.No
get_post_analyticsGet statistics for 1 published post on 1 channel. Use the per-channel post id from get_post (channels[].root.id).No
get_workspace_statsCounts from this workspace: posts by state, published posts per channel, and short link clicks.No
run_channel_toolRun a network helper for 1 channel, for example list Pinterest boards, Reddit flairs or YouTube playlists, to fill a setting. get_channel_rules lists the tools for each channel.No
generate_imageCreate an image with AI from a description and save it to the media library. Uses 1 image credit. Returns a media id. Only when AI images are turned on for your workspace.Yes

The server also offers 2 ready prompts: plan_week (plan 5 posts for the next 7 days about a topic) and repurpose (turn a link or text into 1 post per channel).

Example prompts

  • "Read the README and write an X thread that explains what this project does. Check it with check_post, then save it as a draft."
  • "Turn the last 5 commits into a short changelog post for LinkedIn and Discord."
  • "Schedule the launch post for Tuesday 9:00 in my timezone on every channel."
  • "Show me the Instagram rules, then write a caption for docs/hero.png."
  • "What did we post last week, and which posts failed?"
  • "Draft a Google Business Profile update about the new feature with a Learn more button to our docs."

Safety and control

  • 14 of the 20 tools only read. The 6 that change data (schedule_post, change_post_date, retry_post, delete_post, upload_media_from_url and generate_image) are marked as write tools, so Cursor can ask you before it runs them.
  • The server tells the AI to confirm the text, channels and time with you before it schedules or publishes.
  • Ask for drafts ("save as drafts") or for client review ("send for approval") when you want a human to check first.
  • A post is never sent twice. If Postozo cannot confirm a post went live, it marks it "could not confirm" instead of retrying on its own.
  • Remove access any time in Postozo under Settings, Approved Apps, or by creating a new API key.

Sources

Setup steps checked on 29 September 2026 against: cursor.com/docs/context/mcp. Cursor is a trademark of its owner. Postozo is not affiliated with it. Menus change; if a step looks different, follow the linked docs.

FAQ

Questions

Can Cursor schedule posts with Postozo?

Yes. After you add Postozo's MCP server, Cursor can list your channels, check each network's rules, find free times and create drafts, scheduled posts or posts for client approval.

Should I commit .cursor/mcp.json?

Only with the key in an environment variable, never with the key itself.

Can Cursor post without asking?

The server asks the AI to confirm text, channels and time first. Ask for drafts if you want to review in Postozo.

Does it work with Cursor's background agents?

Cursor's docs describe MCP servers for its agent. We have not tested every Cursor mode, so start with the editor agent.

Does it cost extra?

No. The API and MCP server are included in every Postozo plan. Cursor has its own plans and limits.

Connect Cursor to Postozo

Start a 7-day free trial, connect your channels, then add the server.

Create your free account