X MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on X: 28 typed functions through one MCP server. No X API key needed.
- Site
- x.com
- Functions
- 28
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for X alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/xOne MCP server for X and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
getConversationThe messages inside one of the signed-in account's DM conversations.Arguments
Name Type Required conversationIdstringFrom listConversations' id.Yes limitnumberNo Returns
XDirectMessageRow[]interface XDirectMessageRow { text: string; createdAt: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/getConversationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.getConversation({ conversationId: "123-456" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.getConversation({"conversationId": "123-456"}))curl -X POST https://api.bowmark.ai/v1/sites/x/getConversation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"conversationId":"123-456"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.getConversation({ conversationId: "123-456" });getListPostsThe posts in an X List, read as the signed-in caller.Arguments
Name Type Required args{ listId: string; limit?: number }Yes Returns
XTweet[]interface XTweet { id: string; text: string; createdAt: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/getListPostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.getListPosts({ listId: "1585430245762441216" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.getListPosts({"listId": "1585430245762441216"}))curl -X POST https://api.bowmark.ai/v1/sites/x/getListPosts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"listId":"1585430245762441216"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.getListPosts({ listId: "1585430245762441216" });getPostRepliesReads the reply thread under a single X post.Arguments
Name Type Required urlstringNo idstringNo limitnumberNo Returns
XTweet[]interface XTweet { id: string; text: string; createdAt: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/getPostRepliesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.getPostReplies({ id: "1585341984679469056", limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.getPostReplies({"id": "1585341984679469056", "limit": 3}))curl -X POST https://api.bowmark.ai/v1/sites/x/getPostReplies \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"1585341984679469056","limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.getPostReplies({ id: "1585341984679469056", limit: 3 });listBookmarksThe signed-in account's saved bookmarks.Arguments
Name Type Required args{ limit?: number }No Returns
XTweet[]interface XTweet { id: string; text: string; createdAt: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/listBookmarksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.listBookmarks({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.listBookmarks({}))curl -X POST https://api.bowmark.ai/v1/sites/x/listBookmarks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.listBookmarks({});listConversationsThe signed-in account's direct-message conversation list.Arguments
Name Type Required args{ limit?: number }No Returns
XConversation[]interface XConversation { id: string; participants: string[]; // handles, no @ lastMessageText: string; lastMessageAt: string | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/listConversationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.listConversations({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.listConversations({}))curl -X POST https://api.bowmark.ai/v1/sites/x/listConversations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.listConversations({});listFollowersA user's followers list.Arguments
Name Type Required handlestringYes limitnumberNo Returns
XUserSummary[]interface XUserSummary { handle: string; // no @ name: string; bio: string; avatarUrl: string | null; verified: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/listFollowersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.listFollowers({ handle: "X" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.listFollowers({"handle": "X"}))curl -X POST https://api.bowmark.ai/v1/sites/x/listFollowers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"X"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.listFollowers({ handle: "X" });listFollowingWho a user follows.Arguments
Name Type Required handlestringYes limitnumberNo Returns
XUserSummary[]interface XUserSummary { handle: string; // no @ name: string; bio: string; avatarUrl: string | null; verified: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/listFollowingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.listFollowing({ handle: "X" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.listFollowing({"handle": "X"}))curl -X POST https://api.bowmark.ai/v1/sites/x/listFollowing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"X"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.listFollowing({ handle: "X" });listHomeFeedThe signed-in account's personalized home timeline, in X's own order.Arguments
Name Type Required args{ limit?: number }No Returns
XTweet[]interface XTweet { id: string; text: string; createdAt: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/listHomeFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.listHomeFeed({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.listHomeFeed({}))curl -X POST https://api.bowmark.ai/v1/sites/x/listHomeFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.listHomeFeed({});listListsThe X Lists an account owns, follows or belongs to, each with the id getListPosts takes.Arguments
Name Type Required args{ handle: string; limit?: number }Yes Returns
XListSummary[]interface XListSummary { id: string; // pass to getListPosts name: string; url: string; memberCount: number | null; ownerHandle: string | null; // no @ description: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/listListsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.listLists({ handle: "NASA" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.listLists({"handle": "NASA"}))curl -X POST https://api.bowmark.ai/v1/sites/x/listLists \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"NASA"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.listLists({ handle: "NASA" });listNotificationsThe signed-in account's notifications.Arguments
Name Type Required args{ limit?: number }No Returns
XNotification[]interface XNotification { type: "like" | "repost" | "follow" | "reply" | "mention" | "quote" | "other"; text: string; actors: string[]; // handles, no @ postId: string | null; postUrl: string | null; createdAt: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/listNotificationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.listNotifications({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.listNotifications({}))curl -X POST https://api.bowmark.ai/v1/sites/x/listNotifications \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.listNotifications({});listTrendingThe site's current trending topics, the /explore page.Arguments
Name Type Required args{ limit?: number }No Returns
XTrend[]interface XTrend { name: string; context: string | null; // e.g. "Trending in Technology", when the site shows one postVolume: string | null; // the site's own rounded string, e.g. "20.1K posts" }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/listTrendingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.listTrending({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.listTrending({}))curl -X POST https://api.bowmark.ai/v1/sites/x/listTrending \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.listTrending({});profileReads an X (Twitter) profile by handle or profile URL.Arguments
Name Type Required args{ handle: string }Yes Returns
XProfileinterface XProfile { handle: string; name: string; bio: string; location: string; url: string; website: string | null; followers: number; following: number; tweets: number; joined: string; verified: boolean; avatarUrl: string; mentions: string[]; // handles the bio @-mentions, without the "@" links: string[]; // every link on the profile, expanded (website first, then bio urls) }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/profileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.profile({ handle: "X" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.profile({"handle": "X"}))curl -X POST https://api.bowmark.ai/v1/sites/x/profile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"X"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.profile({ handle: "X" });searchRuns the site's own search across posts, scrolling until the limit is met or results run out.Arguments
Name Type Required querystringYes limitnumberNo Returns
XTweet[]interface XTweet { id: string; text: string; createdAt: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.search({ query: "bitcoin" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.search({"query": "bitcoin"}))curl -X POST https://api.bowmark.ai/v1/sites/x/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"bitcoin"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.search({ query: "bitcoin" });userTimelineReads a public user account's recent timeline to find posts, scrolling until limit is met or the feed runs out.Arguments
Name Type Required handlestringYes limitnumberNo Returns
XTweet[]interface XTweet { id: string; text: string; createdAt: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/userTimelineCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.userTimeline({ handle: "X" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.userTimeline({"handle": "X"}))curl -X POST https://api.bowmark.ai/v1/sites/x/userTimeline \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"X"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.userTimeline({ handle: "X" });
blockUserBlock or unblock an account as the signed-in account.Arguments
Name Type Required args{ handle: string; block?: boolean }Yes Returns
XRelationResultinterface XRelationResult { handle: string; state: boolean; // true when blocked (blockUser) / muted (muteUser) after the call changed: boolean; // false when it was already in that state }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/blockUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.blockUser({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.blockUser({}))curl -X POST https://api.bowmark.ai/v1/sites/x/blockUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.blockUser({});bookmarkPostBookmark or un-bookmark a post as the signed-in account.Arguments
Name Type Required args{ url?: string; id?: string; bookmark?: boolean }Yes Returns
XToggleResultinterface XToggleResult { postId: string; state: boolean; // the state after the call changed: boolean; // false when it was already in that state }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/bookmarkPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.bookmarkPost({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.bookmarkPost({}))curl -X POST https://api.bowmark.ai/v1/sites/x/bookmarkPost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.bookmarkPost({});createPostPost a new tweet as the signed-in account, optionally with up to four photos. text may be left out when images is set (a photo-only post).Arguments
Name Type Required args{ text?: string; images?: XPostImage[] }Yes /** One photo for a post: an https URL, or the bytes base64-encoded (jpeg/png/webp/gif). */ type XPostImage = { imageUrl: string } | { base64: string; mimeType?: string };Returns
XPostWriteResultinterface XPostWriteResult { posted: true; text: string; url: string | null; // the new post, when X's confirmation toast links it inReplyTo: string | null; // post id }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/createPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.createPost({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.createPost({}))curl -X POST https://api.bowmark.ai/v1/sites/x/createPost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.createPost({});deletePostDelete one of the signed-in account's own posts.Arguments
Name Type Required args{ url?: string; id?: string }Yes Returns
XDeletePostResultinterface XDeletePostResult { postId: string; deleted: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/deletePostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.deletePost({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.deletePost({}))curl -X POST https://api.bowmark.ai/v1/sites/x/deletePost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.deletePost({});followUserFollow or unfollow a user as the signed-in account.Arguments
Name Type Required args{ handle: string; follow?: boolean }Yes Returns
XFollowResultinterface XFollowResult { handle: string; following: boolean; // true when the caller follows the account after the call changed: boolean; // false when it was already in that state }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/followUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.followUser({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.followUser({}))curl -X POST https://api.bowmark.ai/v1/sites/x/followUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.followUser({});likePostLike or unlike a post as the signed-in account.Arguments
Name Type Required args{ url?: string; id?: string; like?: boolean }Yes Returns
XToggleResultinterface XToggleResult { postId: string; state: boolean; // the state after the call changed: boolean; // false when it was already in that state }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/likePostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.likePost({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.likePost({}))curl -X POST https://api.bowmark.ai/v1/sites/x/likePost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.likePost({});muteUserMute or unmute an account as the signed-in account.Arguments
Name Type Required args{ handle: string; mute?: boolean }Yes Returns
XRelationResultinterface XRelationResult { handle: string; state: boolean; // true when blocked (blockUser) / muted (muteUser) after the call changed: boolean; // false when it was already in that state }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/muteUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.muteUser({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.muteUser({}))curl -X POST https://api.bowmark.ai/v1/sites/x/muteUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.muteUser({});postReads detailed engagement metrics and media details for a single X (Twitter) post or tweet by URL or ID.Arguments
Name Type Required args{ url: string } | { id: string }Yes Returns
XPostinterface XPostMedia { type: "photo" | "video" | "gif"; url: string; thumbnailUrl: string | null; width: number | null; height: number | null; durationMs: number | null; } interface XPost { id: string; url: string; text: string; createdAt: string; author: { handle: string; name: string; followers: number }; views: number | null; // null on posts older than X's view counter likes: number; reposts: number; replies: number; quotes: number; bookmarks: number; lang: string | null; replyingTo: string | null; media: XPostMedia[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/postCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.post({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.post({}))curl -X POST https://api.bowmark.ai/v1/sites/x/post \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.post({});quotePostQuote-repost a post with the signed-in account's own added comment.Arguments
Name Type Required args{ url?: string; id?: string; text: string }Yes Returns
XQuotePostResultinterface XQuotePostResult { posted: true; text: string; url: string | null; // the new post, when X's confirmation toast links it quotedPostId: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/quotePostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.quotePost({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.quotePost({}))curl -X POST https://api.bowmark.ai/v1/sites/x/quotePost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.quotePost({});replyToPostReply to another post as the signed-in account, optionally with up to four photos. text may be left out when images is set (a photo-only reply).Arguments
Name Type Required args{ url?: string; id?: string; text?: string; images?: XPostImage[] }Yes /** One photo for a post: an https URL, or the bytes base64-encoded (jpeg/png/webp/gif). */ type XPostImage = { imageUrl: string } | { base64: string; mimeType?: string };Returns
XPostWriteResultinterface XPostWriteResult { posted: true; text: string; url: string | null; // the new post, when X's confirmation toast links it inReplyTo: string | null; // post id }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/replyToPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.replyToPost({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.replyToPost({}))curl -X POST https://api.bowmark.ai/v1/sites/x/replyToPost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.replyToPost({});repostRepost (retweet) or un-repost a post as the signed-in account.Arguments
Name Type Required args{ url?: string; id?: string; repost?: boolean }Yes Returns
XToggleResultinterface XToggleResult { postId: string; state: boolean; // the state after the call changed: boolean; // false when it was already in that state }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/repostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.repost({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.repost({}))curl -X POST https://api.bowmark.ai/v1/sites/x/repost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.repost({});sendDirectMessageSend a direct message (DM) to an X user by handle as the signed-in account, starting a new conversation or continuing an existing one.Arguments
Name Type Required handlestring"@jack", "jack" or a profile URL.Yes textstringYes Returns
XDirectMessageResultinterface XDirectMessageResult { sent: true; to: string; // handle, no @ text: string; conversationUrl: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/sendDirectMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.sendDirectMessage({ handle: "<handle>", text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.sendDirectMessage({"handle": "<handle>", "text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/x/sendDirectMessage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"handle":"<handle>","text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.sendDirectMessage({ handle: "<handle>", text: "<text>" });updateProfileEdit the signed-in account's own profile.Arguments
Name Type Required namestringNo biostringNo locationstringNo websitestringNo Returns
XUpdateProfileResultinterface UpdateProfileArgs { name?: string; bio?: string; location?: string; website?: string; } interface XUpdateProfileResult { updated: true; fields: UpdateProfileArgs; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/updateProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.updateProfile({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.updateProfile({}))curl -X POST https://api.bowmark.ai/v1/sites/x/updateProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.updateProfile({});uploadProfilePictureChange the signed-in account's own profile picture.Arguments
Name Type Required imageUrlstringHttps JPEG/PNG/WebP/GIF.No base64stringNo mimeTypestringNo Returns
XUploadProfilePictureResultinterface XUploadProfilePictureResult { updated: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/x/uploadProfilePictureCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.x.uploadProfilePicture({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.x.uploadProfilePicture({}))curl -X POST https://api.bowmark.ai/v1/sites/x/uploadProfilePicture \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.x.uploadProfilePicture({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/x/<function> - OpenAPI
/v1/sites/x/openapi.json