MCP tools reference

The OpenTweet MCP server exposes 43 tools so an AI agent can post, schedule, recycle, and analyze content on X (Twitter) with one API key. This page lists every tool grouped by what it does. For install steps see the MCP setup guide.

One key, all agents

These tools work in any MCP client. Claude Code, Codex, Cursor, Windsurf, ChatGPT, OpenClaw, Hermes, and any other MCP or REST client can call them once you connect the server below.

Connect the server

Hosted endpoint (nothing to install, paste into any MCP client):

mcp config

{
  "mcpServers": {
    "opentweet": {
      "type": "streamable-http",
      "url": "https://mcp.opentweet.io/mcp",
      "headers": { "Authorization": "Bearer ot_your_key" }
    }
  }
}

Or run it locally over npm with your key in the environment:

mcp config (local)

{
  "mcpServers": {
    "opentweet": {
      "command": "npx",
      "args": ["-y", "@opentweet/mcp-server"],
      "env": { "OPENTWEET_API_KEY": "ot_your_key" }
    }
  }
}

Get an ot_ key in your developer dashboard. New to OpenTweet? Start with the quickstart.

The 43 tools

Every tool name is prefixed with opentweet_. Jump to a group:

Posting10 Articles6 Evergreen8 Media3 Analytics6 Discovery1 Accounts3 DM campaigns6

Posting10 tools

Create, read, update, publish, and schedule single tweets and threads.

Tool	Purpose
opentweet_create_tweet	Create a single post as a draft, scheduled, or published now.
opentweet_create_thread	Create a multi-tweet thread with optional per-tweet media.
opentweet_list_tweets	List your posts, filterable by status (scheduled, posted, draft, failed).
opentweet_get_tweet	Fetch a single post by its ID.
opentweet_update_tweet	Edit the text, media, or schedule of a draft or scheduled post.
opentweet_delete_tweet	Delete a post, optionally removing it from X too.
opentweet_publish_tweet	Publish an existing draft or scheduled post to X right now.
opentweet_schedule_tweet	Set or change the scheduled publish time of a post.
opentweet_batch_schedule	Schedule up to 50 existing posts at once.
opentweet_repurpose_tweet	Rewrite an existing tweet into fresh variations.

Articles6 tools

Draft, schedule, and publish long-form X Articles from markdown.

Tool	Purpose
opentweet_create_article	Create a long-form X Article from markdown as draft, scheduled, or published.
opentweet_get_article	Fetch a single article by its ID.
opentweet_list_articles	List your articles, filterable by status.
opentweet_update_article	Edit a draft, scheduled, or failed article.
opentweet_publish_article	Publish an article to X right now.
opentweet_delete_article	Delete an article.

Evergreen8 tools

Manage the recycling queue that re-posts your best content on a cooldown.

Tool	Purpose
opentweet_add_to_evergreen	Add a post to the evergreen recycling pool.
opentweet_remove_from_evergreen	Remove a post from the evergreen pool.
opentweet_list_evergreen_posts	List the posts currently in your evergreen pool.
opentweet_get_evergreen_post	Fetch a single evergreen post by its ID.
opentweet_update_evergreen_post	Change an evergreen post cooldown or pause state.
opentweet_get_evergreen_settings	Read your evergreen config: posts per day, times, cooldown.
opentweet_update_evergreen_settings	Update your evergreen config.
opentweet_get_evergreen_history	See what evergreen posts were recycled and when.

Media3 tools

Upload files and generate images or video to attach to posts.

Tool	Purpose
opentweet_upload_media	Upload an image or video and get a URL to attach to a post.
opentweet_generate_image	Generate an image from a prompt for use in a post.
opentweet_generate_video	Generate a video from a prompt for use in a post.

Analytics6 tools

Read posting stats, engagement, growth, best times, and content gaps.

Tool	Purpose
opentweet_get_analytics	Get account-level stats: posting rate, streaks, trends, categories.
opentweet_get_top_posts	Get your best-performing published posts by engagement.
opentweet_get_profile_growth	Get profile growth metrics over time.
opentweet_get_best_times	Get suggested posting times from your recent activity.
opentweet_analyze_best_times	Run a deeper analysis of your best posting windows.
opentweet_get_content_gaps	Find topics and formats you have not covered recently.

Discovery1 tools

Find reference tweets to inform new content.

Tool	Purpose
opentweet_search_inspiration	Search saved and public tweets for inspiration on a topic.

Accounts3 tools

Read the accounts connected to your OpenTweet workspace, and where a post would go.

Tool	Purpose
opentweet_get_account	Get details for a single connected X account.
opentweet_list_accounts	List every X account connected to your workspace.
opentweet_list_platforms	Show cross-posting state: which networks are connected, whether auto cross-post is on, and where a post that omits the platforms parameter would go.

DM campaigns6 tools

Run compliant outbound X DM campaigns. Every send is approved by a human first, and nothing goes out through a scripted browser session. Advanced and Agency plans.

Tool	Purpose
dm_campaign_create	Create a campaign and kick off lead discovery, qualification, and message drafting.
dm_campaign_list	List your campaigns with their status and funnel stats.
dm_campaign_report	Get the full discovery-to-reply funnel and reply rate for one campaign.
dm_leads_list	List leads in a campaign, filterable by state such as qualified or sent.
dm_lead_approve	Approve a qualified lead so its DM is queued. This is the human-in-the-loop step.
dm_inbox_list	List reply conversations for a campaign, grouped by lead, with reply classification.

43 tools total

Posting (10), Articles (6), Evergreen (8), Media (3), Analytics (6), Discovery (1), Accounts (3), and DM campaigns (6) add up to 43. Prefer HTTP? Everything here maps to the REST API too. See the REST API reference.

Next steps

• MCP setup: per-client install for Claude Code, Cursor, Windsurf, and more.
• Quickstart: post to X in 3 minutes with REST, MCP, or the CLI.
• REST API reference: the same actions over plain HTTP.