twitter

X (formerly Twitter): X (formerly Twitter) public and private data API for search, posts (Tweets).

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
83%
Naming quality
71%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (31)

  • LOWTool 'get_AutoComplete' doesn't follow camelCase/snake_casein get_AutoComplete
  • LOWTool 'get_Search' doesn't follow camelCase/snake_casein get_Search
  • LOWTool 'get_v1_1_Trends' doesn't follow camelCase/snake_casein get_v1_1_Trends
  • LOWTool 'get_v1_1_Locations' doesn't follow camelCase/snake_casein get_v1_1_Locations
  • LOWTool 'get_v2_TweetDetail' doesn't follow camelCase/snake_casein get_v2_TweetDetail
  • LOWTool 'get_v2_Tweet' doesn't follow camelCase/snake_casein get_v2_Tweet
  • LOWTool 'get_v2_Favoriters' doesn't follow camelCase/snake_casein get_v2_Favoriters
  • LOWTool 'get_v2_Retweeters' doesn't follow camelCase/snake_casein get_v2_Retweeters
  • LOWTool 'get_v1_1_TranslateTweet' doesn't follow camelCase/snake_casein get_v1_1_TranslateTweet
  • LOWTool 'get_v1_1_Users' doesn't follow camelCase/snake_casein get_v1_1_Users

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~3,982Tokens (tool definitions)
~933 BTypical response size
Significant attention impact (3.11% of 128k context)

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-http

What it can do

Tool inventory

Tools (32)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded32 tools
verifiedversion not recorded32 tools