X (formerly Twitter): X (formerly Twitter) public and private data API for search, posts (Tweets).
Should I use this
Quality & Safety
Findings (31)
- LOWin get_AutoComplete
- LOWin get_Search
- LOWin get_v1_1_Trends
- LOWin get_v1_1_Locations
- LOWin get_v2_TweetDetail
- LOWin get_v2_Tweet
- LOWin get_v2_Favoriters
- LOWin get_v2_Retweeters
- LOWin get_v1_1_TranslateTweet
- LOWin get_v1_1_Users
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"twitter": {
"url": "https://mcp.jojapi.com/twitter"
}
}
}Remote endpoints
https://mcp.jojapi.com/twitterstreamable-httpWhat it can do
Tool inventory
Tools (32)
🟢get_AutoComplete(q)
Auto Complete Group: Explore. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"title": "Search query",
"example": "Elon"
}
},
"additionalProperties": false
}🟢get_Search(q, type, count, cursor)
Search Group: Explore. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"title": "Search query",
"example": "Dogecoin",
"description": "You can use advanced search queries. E.g. dogecoin (from:elonmusk) Check out for more information: https://twitter.com/search-advanced"
},
"type": {
"type": "string",
"enum": [
"Top",
"Latest",
"People",
"Media",
"Lists"
],
"title": "Search type",
"example": "Top",
"description": "Default: Top."
},
"count": {
"type": "integer",
"title": "Count",
"example": 20,
"description": "Number of Tweet results"
},
"cursor": {
"type": "string",
"title": "Cursor token",
"description": "Cursor for other results"
}
},
"additionalProperties": false
}🟢get_v1_1_Trends(location_id, count)
Trends Group: Explore. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"location_id": {
"type": "string",
"title": "Location ID",
"example": "-7608764736147602991",
"description": "You must use the Locations endpoint to find IDs. Currently only countries are supported."
},
"count": {
"type": "string",
"title": "Count",
"example": "20",
"description": "Number of results"
}
},
"additionalProperties": false
}🟢get_v1_1_Locations(q)
Locations Group: Explore. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"title": "Search query",
"description": "Leave blank to get countries"
}
},
"additionalProperties": false
}🟢get_v2_TweetDetail(cursor, id)
Tweet Detail & Conversation Group: Tweet. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"cursor": {
"type": "string",
"title": "Cursor token",
"description": "Cursor for other results"
},
"id": {
"type": "string",
"title": "Tweet ID",
"example": "1485953263040188416"
}
},
"additionalProperties": false
}🟢get_v2_Tweet(id)
Tweet Detail / Alternative Group: Tweet. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"title": "Tweet ID",
"example": "1485953263040188416"
}
},
"additionalProperties": false
}🟢get_v2_Favoriters(count, cursor, id)
Tweet Favoriters Group: Tweet. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"count": {
"type": "string",
"title": "Count",
"example": "20",
"description": "Number of results"
},
"cursor": {
"type": "string",
"title": "Cursor token",
"description": "Cursor for other results"
},
"id": {
"type": "string",
"title": "Tweet ID",
"example": "1485953263040188416"
}
},
"additionalProperties": false
}🟢get_v2_Retweeters(count, cursor, id)
Tweet Retweeters Group: Tweet. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"count": {
"type": "string",
"title": "Count",
"example": "20",
"description": "Number of results"
},
"cursor": {
"type": "string",
"title": "Cursor token",
"description": "Cursor for other results"
},
"id": {
"type": "string",
"title": "Tweet ID",
"example": "1485953263040188416"
}
},
"additionalProperties": false
}🟢get_v1_1_TranslateTweet(id, language)
Translate Tweet Group: Tweet. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"title": "Tweet ID",
"example": "1485953263040188416"
},
"language": {
"type": "string",
"title": "Destination language",
"example": "es",
"description": "Language code"
}
},
"additionalProperties": false
}🟢get_email_search_by_username(username)
Email Search (by username) Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"username": {
"type": "string",
"example": "RickRubin"
}
},
"additionalProperties": false
}🟢get_v1_1_Users(ids, usernames)
Get Users Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"ids": {
"type": "string",
"title": "User IDs",
"example": "44196397",
"description": "A comma separated list of User IDs. Up to 100 are allowed in a single request."
},
"usernames": {
"type": "string",
"title": "User screen names",
"example": "BillGates,Google",
"description": "A comma separated list of Usernames. Up to 100 are allowed in a single request."
}
},
"additionalProperties": false
}🟢get_v2_UserByScreenName(username)
User By Screen Name Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"username": {
"type": "string",
"title": "Username",
"example": "elonmusk"
}
},
"additionalProperties": false
}🟢get_v2_UserByRestId(id)
User By Rest ID Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"title": "User ID",
"example": "44196397"
}
},
"additionalProperties": false
}🟢get_v2_UsersByRestIds(ids)
Users By Rest IDs Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"ids": {
"type": "string",
"title": "Users IDs",
"example": "44196397,155659213",
"description": "you can separate with commas"
}
},
"additionalProperties": false
}🟢get_v2_UserTweets(count, cursor, id)
User Tweets Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"count": {
"type": "string",
"title": "Count",
"example": "40",
"description": "Number of results"
},
"cursor": {
"type": "string",
"title": "Cursor token",
"description": "Cursor for other results"
},
"id": {
"type": "string",
"title": "User ID",
"example": "44196397",
"description": "Use the User By Screen Name endpoint to find the ID from a username."
}
},
"additionalProperties": false
}🟢get_v2_UserTweetsAndReplies(count, cursor, id)
User Tweets & Replies Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"count": {
"type": "string",
"title": "Count",
"example": "40",
"description": "Number of results"
},
"cursor": {
"type": "string",
"title": "Cursor token",
"description": "Cursor for other results"
},
"id": {
"type": "string",
"title": "User ID",
"example": "44196397",
"description": "Use the User By Screen Name endpoint to find the ID from a username."
}
},
"additionalProperties": false
}🟢get_v2_UserMedia(count, cursor, id)
User Media Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"count": {
"type": "string",
"title": "Count",
"example": "20",
"description": "Number of results"
},
"cursor": {
"type": "string",
"title": "Cursor token",
"description": "Cursor for other results"
},
"id": {
"type": "string",
"title": "User ID",
"example": "44196397",
"description": "Use the User By Screen Name endpoint to find the ID from a username."
}
},
"additionalProperties": false
}🟢get_v2_Likes(count, cursor, id)
User Likes Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"count": {
"type": "string",
"title": "Count",
"example": "20",
"description": "Number of results"
},
"cursor": {
"type": "string",
"title": "Cursor token",
"description": "Cursor for other results"
},
"id": {
"type": "string",
"title": "User ID",
"example": "44196397",
"description": "Use the User By Screen Name endpoint to find the ID from a username."
}
},
"additionalProperties": false
}🟢get_v2_Followers(count, cursor, id)
User Followers Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"count": {
"type": "string",
"title": "Count",
"example": "20",
"description": "Number of results"
},
"cursor": {
"type": "string",
"title": "Cursor token",
"description": "Cursor for other results"
},
"id": {
"type": "string",
"title": "User ID",
"example": "44196397",
"description": "Use the User By Screen Name endpoint to find the ID from a username."
}
},
"additionalProperties": false
}🟢get_v1_1_Followers(count, cursor, id, username)
User Followers / Light Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"count": {
"type": "string",
"title": "Count",
"example": "20",
"description": "Number of results. Max: 200"
},
"cursor": {
"type": "string",
"title": "Cursor token"
},
"id": {
"type": "string",
"title": "User ID",
"description": "Exactly one of User ID or Username must be provided."
},
"username": {
"type": "string",
"title": "Username",
"example": "elonmusk",
"description": "Exactly one of User ID or Username must be provided."
}
},
"additionalProperties": false
}🟢get_v1_1_FollowersIds(id, username, count, cursor)
User Followers IDs Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"title": "User ID",
"description": "Exactly one of User ID or Username must be provided."
},
"username": {
"type": "string",
"title": "Username",
"example": "elonmusk",
"description": "Exactly one of User ID or Username must be provided."
},
"count": {
"type": "string",
"title": "Count",
"example": "500",
"description": "Number of results. Max: 5000"
},
"cursor": {
"type": "string",
"title": "Cursor token"
}
},
"additionalProperties": false
}🟢get_v2_VerifiedFollowers(id, count, cursor)
User Verified Followers Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"title": "User ID",
"example": "44196397",
"description": "Use the User By Screen Name endpoint to find the ID from a username."
},
"count": {
"type": "string",
"title": "Count",
"example": "20",
"description": "Number of results"
},
"cursor": {
"type": "string",
"title": "Cursor token",
"description": "Cursor for other results"
}
},
"additionalProperties": false
}🟢get_v2_Following(count, cursor, id)
User Following Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"count": {
"type": "string",
"title": "Count",
"example": "20",
"description": "Number of results"
},
"cursor": {
"type": "string",
"title": "Cursor token",
"description": "Cursor for other results"
},
"id": {
"type": "string",
"title": "User ID",
"example": "44196397",
"description": "Use the User By Screen Name endpoint to find the ID from a username."
}
},
"additionalProperties": false
}🟢get_v1_1_Following(count, cursor, id, username)
User Following / Light Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"count": {
"type": "string",
"title": "Count",
"example": "20",
"description": "Number of results. Max: 200"
},
"cursor": {
"type": "string",
"title": "Cursor token"
},
"id": {
"type": "string",
"title": "User ID",
"description": "Exactly one of User ID or Username must be provided."
},
"username": {
"type": "string",
"title": "Username",
"example": "elonmusk",
"description": "Exactly one of User ID or Username must be provided."
}
},
"additionalProperties": false
}🟢get_v1_1_FollowingIds(count, cursor, id, username)
User Following IDs Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"count": {
"type": "string",
"title": "Count",
"example": "500",
"description": "Number of results. Max: 5000"
},
"cursor": {
"type": "string",
"title": "Cursor token"
},
"id": {
"type": "string",
"title": "User ID",
"description": "Exactly one of User ID or Username must be provided."
},
"username": {
"type": "string",
"title": "Username",
"example": "elonmusk",
"description": "Exactly one of User ID or Username must be provided."
}
},
"additionalProperties": false
}🟢get_v2_Subscriptions(id, count, cursor)
User Subscriptions Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"title": "User ID",
"example": "44196397",
"description": "Use the User By Screen Name endpoint to find the ID from a username."
},
"count": {
"type": "string",
"title": "Count",
"example": "20",
"description": "Number of results"
},
"cursor": {
"type": "string",
"title": "Cursor token",
"description": "Cursor for other results"
}
},
"additionalProperties": false
}🟢get_v2_UserAffiliates(count, cursor, id)
User Affiliates Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"count": {
"type": "string",
"title": "Count",
"example": "20",
"description": "Number of results"
},
"cursor": {
"type": "string",
"title": "Cursor token",
"description": "Cursor for other results"
},
"id": {
"type": "string",
"title": "User ID",
"example": "34743251",
"description": "Use the User By Screen Name endpoint to find the ID from a username."
}
},
"additionalProperties": false
}🟢get_v2_UserHighlights(id, count, cursor)
User Highlights Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"title": "User ID",
"example": "44196397",
"description": "Use the User By Screen Name endpoint to find the ID from a username."
},
"count": {
"type": "string",
"title": "Count",
"example": "20",
"description": "Number of results"
},
"cursor": {
"type": "string",
"title": "Cursor token",
"description": "Cursor for other results"
}
},
"additionalProperties": false
}🟢get_v1_1_TranslateProfile(id, language)
Translate Profile Group: User. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"title": "User ID",
"example": "50393960"
},
"language": {
"type": "string",
"title": "Destination language",
"example": "es",
"description": "Language code"
}
},
"additionalProperties": false
}🟢get_ShortUrl(url)
Twitter URL shortening service Group: Misc. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"title": "Long URL",
"example": "https://jojapi.com/api/twitter",
"description": "The URL you want shortened"
}
},
"additionalProperties": false
}🟢get_v1_1_Hashflags
Hashflags Group: Misc. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}🟢get_v2_ListTimeline(id, count, cursor)
List Timeline Group: List. Billing per call: 1 Credits. Agents can pay per call ($0.01 via x402/MPP, no API key).
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"title": "List ID",
"example": "875371355570487296"
},
"count": {
"type": "string",
"title": "Count",
"example": "20",
"description": "Number of results"
},
"cursor": {
"type": "string",
"title": "Cursor token",
"description": "Cursor for other results"
}
},
"additionalProperties": false
}Community
Evidence