Twitter / X

Live

OAUTH 2.0

SOCIAL MEDIA

Media

Every tweet, mention, and DM your brand manages lives on Twitter / X. Twitter / X MCP gives your agent authenticated access to social data scoped to the user who authorized it.

  • Acts as the user: Access and write actions stay tied to the Twitter / X account that authorized the agent.
  • Credentials stay vaulted: AES-256, resolved at request time, never in LLM context.
  • Scoped before every call: Permissions enforced. 90-day audit trail.
Twitter / X
agent · Acme Q3
Run
Find all mentions of [brand] in the last 24 hours and summarize sentiment.
S
twitter_tweets_search
520ms
Social media agent
47 mentions in the last 24 hours. Sentiment: 62% positive, 28% neutral, 10% negative. Top positive: new feature launch praise. Top negative: 3 complaints about API rate limits. 2 influencer mentions with 50K+ followers.
Sources: Twitter search, last 24 hours
twitterxmcp
47 tweets
18:29
Message Claude...

Tools your social media agent reaches for on Twitter / X, scoped per user.

CALL ANY TOOL
Search tweets by keyword or hashtag, post from the authorized account, retrieve user profiles, and read the timeline.
twitter_activity_subscription_create
Create activity subscription
Creates a subscription for an X activity event. Use when you need to monitor specific user activities like profile updates, follows, or spaces events.
Parameters
Name
Type
Required
Description
event_types
array
Required
List of event types to subscribe to, e.g. profile.updated, follows, spaces
user_id
string
Required
Twitter user ID to subscribe to activities for
twitter_activity_subscription_delete
Delete activity subscription
twitter_activity_subscriptions_list
List activity subscriptions
twitter_article_publish
Publish article
twitter_blocked_users_get
Get blocked users
twitter_bookmark_add
Add bookmark
twitter_bookmark_remove
Remove bookmark
twitter_communities_search
Search communities
twitter_dm_block
Dm block
twitter_dm_conversation_send
Send dm conversation
twitter_dm_event_get
Get dm event
twitter_likes_compliance_stream
Likes compliance stream
twitter_list_delete
Delete list
twitter_list_lookup
List lookup
twitter_list_members_get
Get list members
twitter_list_unfollow
List unfollow
twitter_media_metadata_create
Create media metadata
twitter_media_upload
Upload media
twitter_muted_users_get
Get muted users
twitter_post_delete
Delete post
twitter_post_retweet
Post retweet
twitter_post_retweets_get
Get post retweets
twitter_posts_lookup
Posts lookup
twitter_recent_search
Search recent
twitter_reply_visibility_set
Set reply visibility
twitter_spaces_get
Get spaces
twitter_user_follow
User follow
twitter_user_me
User me
twitter_user_mentions_get
Get user mentions
twitter_user_unmute
User unmute

For more tools, view docs.

Build your Agent
Drop the toolkit in, point it at the user, and your social media agent can use Twitter / X from the first run.
Python · LlamaIndex
import { ScalekitClient } from "@scalekit-sdk/node";
import { DynamicStructuredTool } from "@langchain/core/tools";
import { createReactAgent } from "@langchain/langgraph/prebuilt";
import { z } from "zod";

const sk = new ScalekitClient(envUrl, clientId, clientSecret);

const { tools } = await sk.tools.listScopedTools("user_123", {
filter: { connectionNames: ["twitterx"], toolNames: ["twitter_tweets_search", "twitter_tweet_get", "twitter_tweet_create"] },
pageSize: 100,
});

const lcTools = tools.map((t) => new DynamicStructuredTool({
name: t.tool.definition.name,
description: t.tool.definition.description,
schema: z.object({}).passthrough(),
func: async (args) => {
const { data } = await sk.tools.executeTool({
toolName: t.tool.definition.name,
identifier: "user_123",
params: args,
});
return JSON.stringify(data);
},
}));

const agent = createReactAgent({ llm, tools: lcTools });
import { ScalekitClient } from "@scalekit-sdk/node";
import OpenAI from "openai";

const sk = new ScalekitClient(envUrl, clientId, clientSecret);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
filter: { connectionNames: ["twitterx"], toolNames: ["twitter_tweets_search", "twitter_tweet_get", "twitter_tweet_create"] },
pageSize: 100,
});

const llmTools = tools.map((t) => ({
type: "function",
function: {
name: t.tool.definition.name,
description: t.tool.definition.description,
parameters: t.tool.definition.input_schema,
},
}));

const resp = await openai.responses.create({
model: "gpt-4o", input: prompt, tools: llmTools,
});
import { ScalekitClient } from "@scalekit-sdk/node";
import Anthropic from "@anthropic-ai/sdk";

const sk = new ScalekitClient(envUrl, clientId, clientSecret);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
filter: { connectionNames: ["twitterx"], toolNames: ["twitter_tweets_search", "twitter_tweet_get", "twitter_tweet_create"] },
pageSize: 100,
});

const llmTools = tools.map((t) => ({
name: t.tool.definition.name,
description: t.tool.definition.description,
input_schema: t.tool.definition.input_schema,
}));

const msg = await anthropic.messages.create({
model: "claude-sonnet-4-6", max_tokens: 1024,
tools: llmTools,
messages: [{ role: "user", content: prompt }],
});
import { Agent } from "@google/adk/agents";
import {
MCPToolset, StreamableHTTPConnectionParams,
} from "@google/adk/tools/mcp";

const toolset = new MCPToolset({
connectionParams: new StreamableHTTPConnectionParams({
url: "https://mcp.scalekit.com/twitterx",
headers: { Authorization: `Bearer ${userScopedToken}` },
}),
});

const agent = new Agent({
name: "agent", model: "gemini-2.0-flash",
tools: await toolset.getTools(),
});
Try these prompts
Paste any prompt into your agent to start using Twitter / X.
Search & monitor
Copy the prompt
Copied
Find all mentions of [brand] in the last 24 hours.
Copy the prompt
Copied
Search for [hashtag] tweets today.
Copy the prompt
Copied
Find tweets from [username] this week.
Copy the prompt
Copied
Search for [competitor] mentions with negative sentiment.
Post & engage
Copy the prompt
Copied
Post a tweet: [text].
Copy the prompt
Copied
Reply to tweet [id]: [text].
Copy the prompt
Copied
Get my home timeline.
Copy the prompt
Copied
Get profile for @[username].
Analytics
Copy the prompt
Copied
Which of my tweets got the most engagement this week?
Copy the prompt
Copied
Get metrics for tweet [id].
Copy the prompt
Copied
Find influencer mentions of [brand] this month.
Copy the prompt
Copied
How many times was [hashtag] used today?
SEE HOW AUTH WORKS
Users authorize Twitter / X once. Their credentials stay vaulted, every call is checked, and every action is logged.
1
Authorize
Your user connects
Twitter / X
once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access
Who:
user ‘A’
when:
Once per user
access:
Limited to user
2
Store
Their
Twitter / X
token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection
vault:
encrypted
scope:
per-user
tokens:
auto-refreshed
3
Resolve
When your agent calls a
Twitter / X
tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs
speed:
~40ms
check:
before every call
seen by:
nobody
4
Audit
Every
Twitter / X
tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it
history:
90 days
export:
SIEM-ready
logged:
every call
Test other agents
Same per-user auth pattern across other social media agents and MCP connectors. Working code, live demos, fork what fits.
GTM and RevOps Teams
Competitive intelligence briefing agent
Scans Gong calls for competitor mentions, matches each one to its Notion battlecard, and DMs every affected rep a single Slack digest per cycle. Every call runs as the PMM who owns the briefing, never a shared bot.
GTM and RevOps Teams
Outbound prospecting agent
Searches Apollo for prospects matching your ICP, scores and ranks them, drafts personalized outreach in Gmail, and logs every send to Google Sheets. Mail goes out as the rep, not from a shared inbox.
GTM and RevOps Teams
CRM AI agent
Reads the Granola transcript after every call, extracts next steps and updates the HubSpot record, drafts the follow-up in Gmail, and confirms in Slack, all on the rep's own delegated OAuth.
Support and Ops Teams
Meeting prep
Pulls agenda, participant context, and open action items before every meeting.
Test other agents
Same per-user auth pattern across other social media agents and MCP connectors. Working code, live demos, fork what fits.
SALES
Outbound prospecting agent
Search Apollo for ICP matches, rank them, draft personalised Gmail outreach, and log every send to Google Sheets.
GTM
Competitive intelligence briefing agent
Scan Gong calls for competitor mentions, match each one to its Notion battlecard, and DM every affected rep a single Slack digest.
GTM
CRM AI agent
Turn each Granola call transcript into a HubSpot record update, a drafted Gmail follow-up, and a Slack recap.
OPS
Meeting prep agent
Assemble the agenda, HubSpot attendee history, and open action items from Gmail before every meeting on the calendar.
Why Scalekit
Secure your agent's access. Connectors ship in minutes
01.
Shared tokens break per-user analytics
A shared token looks fine in a demo. In production every call looks like a service account. Scalekit resolves the real user credential so attribution, audit, and scope stay accurate.
// shared token
 audit → bot_service_account
 user_filter → broken

 // scalekit
 audit → user_abc
 scope → enforced ✓
02.
Authentication is not authorization
03.
Multi-tenancy is architectural
04.
Twitter / X today. Others tomorrow.
“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”
Venu Madhav Kattagoni
Head of Engineering / Von
FAQs
Frequently Asked Questions
Does the agent access Twitter / X as the user or as a shared key?
As the user. Each workspace member authorizes once and Scalekit resolves their credential at request time. Audit logs attribute every action to that user, not a shared service account.
Where is the Twitter / X oauth 2.0 stored?
In Scalekit's managed AES-256 token vault, namespaced per tenant. Refresh is automatic. Revocation is a single dashboard action. Tokens never appear in prompts, logs, or LLM context.
Can I limit what the agent is allowed to do in Twitter / X?
Yes. Pass a tool name filter to listScopedTools so the social media agent only sees the subset you authorize. Pre-API-call scope checks block out-of-policy actions before the request reaches Twitter / X.
What happens when a user revokes Twitter / X access?
The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.
Does the agent post as the user or as a bot account?
As the authorizing user. All tweets post from that user's Twitter handle. The authorized user's account, API tier, and rate limits apply. Audit logs attribute each post to that user's connected account.
Start in your coding agent
Up and running in one command
Install the Scalekit skill in your editor of choice. Connector, auth, tools, prompt, all wired up
Claude Code REPL
/plugin marketplace add scalekit-inc/claude-code-authstack
/plugin install agentkit@scalekit-auth-stack
Cursor Code REPL
# ~/.cursor/mcp.json
{
""mcpServers"": {
""twitterx"": {
""url"": ""https://mcp.scalekit.com/twitterx"",
""headers"": { ""Authorization"": ""Bearer $SCALEKIT_TOKEN"" }
}
}
}
Codex Code REPL
# ~/.codex/config.toml
[mcp_servers.twitterx]
url = ""https://mcp.scalekit.com/twitterx""
auth_env = ""SCALEKIT_TOKEN""
Copilot Code REPL
# .vscode/mcp.json
{
""servers"": {
""twitterx"": {
""url"": ""https://mcp.scalekit.com/twitterx"",
""type"": ""http""
}
}
}