X MCP & Agent Tooling

Appearance

Endpoint Groups Fresh ​

The X API v2 is organized into resource groups. XMCP turns the operations in each group into MCP tools (excluding streaming and webhook operations). This page maps the groups to the tools they produce, so you can decide what to allow-list.

For the flat, copy-paste list of every tool name, see the Tool Catalog.

The X API v2 resource groups ​

The platform documentation organizes endpoints into these groups:

Account Activity · Activity · Bookmarks · Chat · Communities · Community Notes · Compliance · Connections · Direct Messages · Fundamentals · Lists · Marketplace · Media · News · Posts · Spaces · Stream · Trends · Usage · Users · Webhooks

Not everything becomes a tool

Operations tagged Stream or Webhooks, or marked x-twitter-streaming: true, are excluded from XMCP because they need persistent connections. See Limitations.

Group-to-tool map ​

Posts ​

Create, delete, look up, search, and analyze posts and their engagement.

createPosts · deletePosts · getPostsById · getPostsByIds · getPostsAnalytics · getPostsCountsAll · getPostsCountsRecent · getPostsLikingUsers · getPostsQuotedPosts · getPostsRepostedBy · getPostsReposts · searchPostsAll · searchPostsRecent · searchEligiblePosts · hidePostsReply · likePost · unlikePost · repostPost · unrepostPost

Users ​

Look up users, manage relationships, and read user timelines.

getUsersByUsername · getUsersByUsernames · getUsersById · getUsersByIds · getUsersMe · getUsersFollowers · getUsersFollowing · followUser · unfollowUser · getUsersMuting · muteUser · unmuteUser · getUsersBlocking · getUsersPosts · getUsersMentions · getUsersTimeline · getUsersLikedPosts · getUsersRepostsOfMe · getUsersAffiliates · searchUsers

Lists ​

Create and manage lists and their members.

createLists · updateLists · deleteLists · getListsById · getListsFollowers · getListsMembers · getListsPosts · addListsMember · removeListsMemberByUserId · followList · unfollowList · pinList · unpinList · getUsersFollowedLists · getUsersOwnedLists · getUsersPinnedLists · getUsersListMemberships

Bookmarks ​

getUsersBookmarks · getUsersBookmarkFolders · getUsersBookmarksByFolderId · createUsersBookmark · deleteUsersBookmark

Direct Messages & Chat ​

createDirectMessagesByConversationId · createDirectMessagesByParticipantId · createDirectMessagesConversation · getDirectMessagesEvents · getDirectMessagesEventsById · getDirectMessagesEventsByConversationId · getDirectMessagesEventsByParticipantId · deleteDirectMessagesEvents · blockUsersDms · unblockUsersDms · getChatConversation · getChatConversations · sendChatMessage

Media ​

Upload media and manage its metadata, subtitles, and analytics.

mediaUpload · initializeMediaUpload · appendMediaUpload · finalizeMediaUpload · getMediaUploadStatus · getMediaByMediaKey · getMediaByMediaKeys · createMediaMetadata · createMediaSubtitles · deleteMediaSubtitles · getMediaAnalytics

Spaces ​

getSpacesById · getSpacesByIds · getSpacesByCreatorIds · getSpacesBuyers · getSpacesPosts · searchSpaces

Communities & Community Notes ​

getCommunitiesById · searchCommunities · createCommunityNotes · deleteCommunityNotes · evaluateCommunityNotes · searchCommunityNotesWritten

getTrendsByWoeid · getTrendsPersonalizedTrends · getNews · searchNews

Compliance, Usage & Insights ​

createComplianceJobs · getComplianceJobs · getComplianceJobsById · getUsage · getInsights28Hr · getInsightsHistorical

Connections & Account Activity ​

getActivitySubscriptions · updateActivitySubscription · deleteActivitySubscription · getAccountActivitySubscriptionCount · getConnectionHistory · deleteAllConnections · deleteConnectionsByEndpoint · deleteConnectionsByUuids

Keys, Marketplace & Spec ​

addUserPublicKey · getUserPublicKeys · getMarketplaceHandleAvailability · getOpenApiSpec

Choosing what to expose ​

flowchart TD
    Goal{Agent's job?} -->|Research| R[Posts + Users read tools]
    Goal -->|Posting| P[createPosts + engagement tools]
    Goal -->|List curation| L[Lists tools]
    Goal -->|DM automation| D[Direct Messages + Chat tools]
    R --> AL[Set X_API_TOOL_ALLOWLIST]
    P --> AL
    L --> AL
    D --> AL

Pick the groups your agent needs, copy the matching tool names into X_API_TOOL_ALLOWLIST, and restart XMCP. See Tool Allow-Listing.

See also ​