posterly

MCP connector

X (Twitter) MCP server

Schedule X posts, polls, and threads from Claude or ChatGPT.

This is the posterly MCP server, used for X (Twitter). The same connection works from Claude, ChatGPT, Cursor, and other MCP clients. It is not a separate X (Twitter)-only download.

Get Starter + API · $10/moHow to connect the MCP server

What you can do on X (Twitter)

Your AI client can publish to X with text, up to 4 images or one video (images and video cannot share a post), plus polls and multi-post threads. Give Claude the posts in order and it publishes them as one thread at the time you pick.

The default limit is 280 characters. Verified and premium accounts can use 4,000 characters and organization accounts 25,000, and posterly applies the limit that matches the connected account.

You can control who can reply, label a post as AI-generated or as a paid partnership, and mention another account by typing its @username. One current limit matters: X charges API callers for every post that contains a link, so posterly blocks X posts with URLs for now and asks you to remove them. get_x_posting_quota shows your workspace quota and whether URLs are blocked. The same connection reads your X analytics, so Claude can tell you which posts did best last week.

  • Text posts
  • Images
  • Video
  • Multi-image
  • Threads
  • Polls
  • Audience controls
  • Analytics

Post types: text, image, video, carousel, thread. Analytics can be read for this platform.

Tools

These are the tools your AI client uses for X (Twitter). Ask it to call list_platforms with view=schema and the account_id before it sets anything specific to X (Twitter).

Account and connection

  • whoamiWho am I

  • list_accountsConnected accounts

  • list_platformsPlatforms

  • create_connect_sessionStart a connect session

Posts

  • validate_postValidate a post

  • create_postCreate a post

    Show the caption, account, and time, then wait for confirmation before confirm=true.

  • create_posts_batchCreate posts in bulk

    1 to 25 posts in one confirmed request.

  • update_postEdit a post

    Show the caption, account, and time, then wait for confirmation before confirm=true.

  • list_postsPosts

  • get_postOne post

  • delete_postDelete posts

    Live removal needs an eligible connection and confirm_published. A refusal keeps the posterly record.

  • find_available_slotFind a free slot

  • generate_captionsGenerate captions

Media

  • upload_mediaUpload media

    Hosted requests are about 4MB, so this path is for small files. Large files use create_signed_upload or create_media_drop.

  • create_signed_uploadSigned upload link

  • create_media_dropMedia drop link

  • list_mediaMedia library

Analytics

  • list_analyticsAnalytics

    Includes: Account analytics, Post analytics, Post insights.

Platform helpers

  • trigger_platform_helperRun a platform helper

X quota

  • get_x_posting_quotaX posting quota

Helpers for trigger_platform_helper

  • x.quotaReturn managed X posting quota for the account workspace.

How to connect

  1. Add the hosted server in Claude, ChatGPT, Cursor, or another MCP client. Server URL: https://www.poster.ly/api/mcp. Sign in with posterly OAuth and press Allow. Use the www host. In ChatGPT, write actions need a Business, Enterprise, or Edu plan.
  2. Or, in a client that can run a local process (Cursor, Claude Code, Windsurf, and similar), use npx -y posterly-mcp-server@latest with a POSTERLY_API_KEY placeholder in that client's MCP config.
  3. Call whoami and list_accounts so you know which workspace the client is using.
  4. Connect X (Twitter) with the method below, then call list_platforms with view=schema and the account_id.

X (Twitter)

Ask your AI client to start a connection, open the link it gives you, and approve access on the platform.

Connect X (Twitter) in the dashboard

Example prompts

  • Schedule this 5 post thread on X for tomorrow at 3pm, and keep each post under 280 characters.
  • Post a poll on X asking which feature we should ship next, with three options, open for 24 hours.
  • Check my X posting quota, then tell me how many posts I can still schedule this month.

X (Twitter) limits

Caption or text
280 characters.
Media count
Up to 4 media items. Up to 4 images. Up to 1 video.
Platform rule
Default caption cap is 280 characters. Verified and premium accounts can use 4,000. Organization accounts can use 25,000.

Request rates depend on your plan. The posterly MCP page lists them.

Pricing

API and MCP access is an add-on to any posterly plan. Starter plus API is $10 a month, charged now with no free trial on this checkout.

Get Starter + API · $10/moSee every plan

FAQ

What is the X (Twitter) MCP server?

It is the posterly MCP server, not a separate product. Connect it once and the same connection covers X (Twitter) and 17 other platforms, from Claude, ChatGPT, Cursor, and other MCP clients.

How do I connect X (Twitter)?

Add the hosted server at https://www.poster.ly/api/mcp and sign in with posterly, or run npx -y posterly-mcp-server@latest in a client that can start a local process. X (Twitter): Ask your AI client to start a connection, open the link it gives you, and approve access on the platform.

Can Claude post a thread on X?

Yes. Give it the posts in order and it publishes them as one thread at the time you choose. Each post follows the same character cap as a normal post, which depends on the connected account.

Can I include links in X posts from the MCP server?

Not right now. X charges API callers for every post that contains a URL, so posterly blocks X posts with links for now and asks you to remove them. get_x_posting_quota reports the current URL-blocking status for your workspace.

Keep reading

MCP

posterly MCP server

Hosted OAuth setup, the local npm package, and the full tool list.

Scheduler

X (Twitter) scheduler

Schedule X (Twitter) from the posterly calendar and composer.

Guide

X (Twitter) guide

Read the long X (Twitter) guide, then come back to connect it.

Pricing

posterly pricing

Compare plans, then add API and MCP at checkout.

Other platform MCP servers