Threads MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Threads: 31 typed functions through one MCP server. No Threads API key needed.
- Site
- threads.com
- Functions
- 31
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Threads 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/threadsOne MCP server for Threads 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.
getActivityReads the CALLER's activity.Arguments
None.
Returns
ThreadsActivity// getActivity: the signed-in caller's own notifications interface ThreadsActivityItem { id: string; kind: string | null; // Meta's own name for the activity kind, as the site spells it text: string | null; // the line Threads shows, e.g. "liked your thread" at: string; // ISO time username: string | null; // the other account, when named postCode: string | null; // the post it is about: the code getPost takes } interface ThreadsActivity { notifications: ThreadsActivityItem[]; // newest first; [] when there is none }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/getActivityCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.getActivity();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.getActivity())curl -X POST https://api.bowmark.ai/v1/sites/threads/getActivity \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.getActivity();getCustomFeedReads the posts in one of the CALLER's custom feeds.Arguments
Name Type Required idstringFrom listCustomFeeds (a /custom_feed/<id>/ url also works).Yes Returns
ThreadsCustomFeedPostsinterface ThreadsPost { id: string; /** The short code in the post URL. */ code: string; url: string; username: string; isVerified: boolean; text: string | null; /** ISO 8601. */ postedAt: string | null; likeCount: number | null; replyCount: number | null; repostCount: number | null; quoteCount: number | null; media: { type: "image" | "video"; url: string }[]; isReply: boolean; } interface ThreadsCustomFeedPosts { id: string; posts: ThreadsPost[]; // first server-rendered page }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/getCustomFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.getCustomFeed({ id: "0" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.getCustomFeed({"id": "0"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/getCustomFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"id":"0"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.getCustomFeed({ id: "0" });getHomeFeedReads the CALLER's home feed, either For You or Following.Arguments
Name Type Required feed"for_you" | "following"Default "for_you".No Returns
ThreadsHomeFeedinterface ThreadsPost { id: string; /** The short code in the post URL. */ code: string; url: string; username: string; isVerified: boolean; text: string | null; /** ISO 8601. */ postedAt: string | null; likeCount: number | null; replyCount: number | null; repostCount: number | null; quoteCount: number | null; media: { type: "image" | "video"; url: string }[]; isReply: boolean; } interface ThreadsHomeFeed { feed: "for_you" | "following"; posts: ThreadsPost[]; // first server-rendered page, in feed order }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/getHomeFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.getHomeFeed();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.getHomeFeed())curl -X POST https://api.bowmark.ai/v1/sites/threads/getHomeFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.getHomeFeed();getMeReads the CALLER's own Threads account.Arguments
None.
Returns
ThreadsMe// getMe: the signed-in caller's own account interface ThreadsMe { id: string; username: string; // the handle every profile function takes fullName: string | null; profilePicUrl: string | null; isVerified: boolean; followerCount: number | null; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/getMeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.getMe();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.getMe())curl -X POST https://api.bowmark.ai/v1/sites/threads/getMe \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.getMe();getPostReads one Threads post from its URL or username and code.Arguments
Name Type Required urlstringA threads.com post URL, or pass username + code instead.No usernamestringNo codestringThe short code after /post/ in the URL.No Returns
ThreadsPostThreadinterface ThreadsPost { id: string; /** The short code in the post URL. */ code: string; url: string; username: string; isVerified: boolean; text: string | null; /** ISO 8601. */ postedAt: string | null; likeCount: number | null; replyCount: number | null; repostCount: number | null; quoteCount: number | null; media: { type: "image" | "video"; url: string }[]; isReply: boolean; } interface ThreadsPostThread { post: ThreadsPost; /** The posts this one replies to, oldest first. */ parents: ThreadsPost[]; /** The author's own continuation posts. */ selfThread: ThreadsPost[]; /** Direct replies, first page, each reply's chain flattened in order. */ replies: ThreadsPost[]; hasMoreReplies: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/getPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.getPost({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.getPost({}))curl -X POST https://api.bowmark.ai/v1/sites/threads/getPost \ -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.threads.getPost({});getProfileReads a public Threads profile by username.Arguments
Name Type Required usernamestringThe handle, with or without "@", or a threads.com profile URL.Yes Returns
ThreadsProfileinterface ThreadsProfile { id: string; username: string; fullName: string | null; biography: string | null; isVerified: boolean; isPrivate: boolean; followerCount: number | null; profilePicUrl: string | null; links: { url: string; title: string | null }[]; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/getProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.getProfile({ username: "nasa" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.getProfile({"username": "nasa"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/getProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"username":"nasa"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.getProfile({ username: "nasa" });getProfileMediaLists a profile's posts that carry photos or video (its Media tab).Arguments
Name Type Required usernamestringYes limitnumberKeep at most this many posts of the first page.No Returns
ThreadsProfilePostsinterface ThreadsPost { id: string; /** The short code in the post URL. */ code: string; url: string; username: string; isVerified: boolean; text: string | null; /** ISO 8601. */ postedAt: string | null; likeCount: number | null; replyCount: number | null; repostCount: number | null; quoteCount: number | null; media: { type: "image" | "video"; url: string }[]; isReply: boolean; } interface ThreadsProfilePosts { username: string; posts: ThreadsPost[]; /** True when the profile has older posts than this first page. */ hasMore: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/getProfileMediaCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.getProfileMedia({ username: "nasa" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.getProfileMedia({"username": "nasa"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/getProfileMedia \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"username":"nasa"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.getProfileMedia({ username: "nasa" });getProfilePostsLists a profile's own threads, newest first, with text, media, like, reply, repost and quote counts and each post's code.Arguments
Name Type Required usernamestringYes limitnumberKeep at most this many posts of the first page.No Returns
ThreadsProfilePostsinterface ThreadsPost { id: string; /** The short code in the post URL. */ code: string; url: string; username: string; isVerified: boolean; text: string | null; /** ISO 8601. */ postedAt: string | null; likeCount: number | null; replyCount: number | null; repostCount: number | null; quoteCount: number | null; media: { type: "image" | "video"; url: string }[]; isReply: boolean; } interface ThreadsProfilePosts { username: string; posts: ThreadsPost[]; /** True when the profile has older posts than this first page. */ hasMore: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/getProfilePostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.getProfilePosts({ username: "nasa" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.getProfilePosts({"username": "nasa"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/getProfilePosts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"username":"nasa"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.getProfilePosts({ username: "nasa" });getProfileRepliesLists the replies a profile has posted (its Replies tab), each with the post it answered.Arguments
Name Type Required usernamestringYes limitnumberKeep at most this many posts of the first page.No Returns
ThreadsProfilePostsinterface ThreadsPost { id: string; /** The short code in the post URL. */ code: string; url: string; username: string; isVerified: boolean; text: string | null; /** ISO 8601. */ postedAt: string | null; likeCount: number | null; replyCount: number | null; repostCount: number | null; quoteCount: number | null; media: { type: "image" | "video"; url: string }[]; isReply: boolean; } interface ThreadsProfilePosts { username: string; posts: ThreadsPost[]; /** True when the profile has older posts than this first page. */ hasMore: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/getProfileRepliesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.getProfileReplies({ username: "nasa" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.getProfileReplies({"username": "nasa"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/getProfileReplies \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"username":"nasa"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.getProfileReplies({ username: "nasa" });getProfileRepostsLists the posts a profile has reposted (its Reposts tab).Arguments
Name Type Required usernamestringYes limitnumberKeep at most this many posts of the first page.No Returns
ThreadsProfilePostsinterface ThreadsPost { id: string; /** The short code in the post URL. */ code: string; url: string; username: string; isVerified: boolean; text: string | null; /** ISO 8601. */ postedAt: string | null; likeCount: number | null; replyCount: number | null; repostCount: number | null; quoteCount: number | null; media: { type: "image" | "video"; url: string }[]; isReply: boolean; } interface ThreadsProfilePosts { username: string; posts: ThreadsPost[]; /** True when the profile has older posts than this first page. */ hasMore: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/getProfileRepostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.getProfileReposts({ username: "nasa" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.getProfileReposts({"username": "nasa"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/getProfileReposts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"username":"nasa"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.getProfileReposts({ username: "nasa" });getRelatedPostsLists the posts Threads suggests beside one post to a logged-out reader ("related threads").Arguments
Name Type Required urlstringA threads.com post URL, or pass username + code instead.No usernamestringNo codestringThe short code after /post/ in the URL.No Returns
ThreadsRelatedPostsinterface ThreadsPost { id: string; /** The short code in the post URL. */ code: string; url: string; username: string; isVerified: boolean; text: string | null; /** ISO 8601. */ postedAt: string | null; likeCount: number | null; replyCount: number | null; repostCount: number | null; quoteCount: number | null; media: { type: "image" | "video"; url: string }[]; isReply: boolean; } interface ThreadsRelatedPosts { username: string; code: string; posts: ThreadsPost[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/getRelatedPostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.getRelatedPosts({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.getRelatedPosts({}))curl -X POST https://api.bowmark.ai/v1/sites/threads/getRelatedPosts \ -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.threads.getRelatedPosts({});getSavedPostsLists the posts the CALLER has saved.Arguments
None.
Returns
ThreadsSavedPostsinterface ThreadsPost { id: string; /** The short code in the post URL. */ code: string; url: string; username: string; isVerified: boolean; text: string | null; /** ISO 8601. */ postedAt: string | null; likeCount: number | null; replyCount: number | null; repostCount: number | null; quoteCount: number | null; media: { type: "image" | "video"; url: string }[]; isReply: boolean; } // getSavedPosts: the signed-in caller's own saved posts interface ThreadsSavedPosts { posts: ThreadsPost[]; // first server-rendered page, as /saved lists them }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/getSavedPostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.getSavedPosts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.getSavedPosts())curl -X POST https://api.bowmark.ai/v1/sites/threads/getSavedPosts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.getSavedPosts();listCustomFeedsLists the custom feeds the CALLER has built or pinned, with their ids.Arguments
None.
Returns
ThreadsCustomFeeds// listCustomFeeds: the signed-in caller's own custom feeds interface ThreadsCustomFeed { id: string; // what getCustomFeed takes name: string | null; type: string | null; // Meta's own feed_type, as the site spells it url: string; } interface ThreadsCustomFeeds { feeds: ThreadsCustomFeed[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/listCustomFeedsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.listCustomFeeds();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.listCustomFeeds())curl -X POST https://api.bowmark.ai/v1/sites/threads/listCustomFeeds \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.listCustomFeeds();searchAccountsSearches Threads accounts by name or username, logged out.Arguments
Name Type Required querystringA person's or brand's name, or part of a username.Yes limitnumberKeep at most this many accounts; Threads answers up to ~50.No Returns
ThreadsAccountSearchinterface ThreadsAccount { /** Threads' numeric user id. */ id: string; /** The handle every profile function takes, without the "@". */ username: string; fullName: string | null; biography: string | null; isVerified: boolean; profilePicUrl: string | null; url: string; } interface ThreadsAccountSearch { query: string; accounts: ThreadsAccount[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/searchAccountsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.searchAccounts({ query: "nasa" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.searchAccounts({"query": "nasa"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/searchAccounts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"nasa"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.searchAccounts({ query: "nasa" });searchPostsSearches Threads posts by keyword and returns the top results with author, text and counts.Arguments
Name Type Required querystringWords, a phrase or a #topic.Yes limitnumberNo Returns
ThreadsPostSearchinterface ThreadsPost { id: string; /** The short code in the post URL. */ code: string; url: string; username: string; isVerified: boolean; text: string | null; /** ISO 8601. */ postedAt: string | null; likeCount: number | null; replyCount: number | null; repostCount: number | null; quoteCount: number | null; media: { type: "image" | "video"; url: string }[]; isReply: boolean; } interface ThreadsPostSearch { query: string; posts: ThreadsPost[]; hasMore: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/searchPostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.searchPosts({ query: "nasa" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.searchPosts({"query": "nasa"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/searchPosts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"nasa"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.searchPosts({ query: "nasa" });searchTopicsFinds Threads topic tags by keyword and lists the public posts filed under them, logged out.Arguments
Name Type Required querystringA topic word, with or without the leading #.Yes tagIdstringA topic id from a previous result's topics.No limitnumberNo Returns
ThreadsTopicSearchinterface ThreadsPost { id: string; /** The short code in the post URL. */ code: string; url: string; username: string; isVerified: boolean; text: string | null; /** ISO 8601. */ postedAt: string | null; likeCount: number | null; replyCount: number | null; repostCount: number | null; quoteCount: number | null; media: { type: "image" | "video"; url: string }[]; isReply: boolean; } interface ThreadsTopic { id: string; name: string; isCommunity: boolean; url: string; } interface ThreadsTopicSearch { query: string; tagId: string | null; topics: ThreadsTopic[]; posts: (ThreadsPost & { topic: ThreadsTopic | null })[]; hasMore: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/searchTopicsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.searchTopics({ query: "basketball" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.searchTopics({"query": "basketball"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/searchTopics \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"basketball"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.searchTopics({ query: "basketball" });
blockUserBlocks an account for the CALLER.Arguments
Name Type Required userIdstringThe account's numeric id (ThreadsProfile.id).Yes Returns
ThreadsUserActionResultinterface ThreadsUserActionResult { userId: string; done: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/blockUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.blockUser({ userId: "<userId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.blockUser({"userId": "<userId>"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/blockUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"userId":"<userId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.blockUser({ userId: "<userId>" });createPostPublishes a new thread as the CALLER.Arguments
Name Type Required textstringUp to 500 characters.Yes Returns
ThreadsPublishedinterface ThreadsPublished { id: string; // the new post's numeric id code: string | null; // its short code, when Threads returns one url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/createPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.createPost({ text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.createPost({"text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/createPost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.createPost({ text: "<text>" });deletePostDeletes one of the CALLER's own posts or replies.Arguments
Name Type Required postIdstringThe post's numeric id (ThreadsPost.id).Yes Returns
ThreadsActionResultinterface ThreadsActionResult { postId: string; done: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/deletePostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.deletePost({ postId: "<postId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.deletePost({"postId": "<postId>"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/deletePost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"postId":"<postId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.deletePost({ postId: "<postId>" });followUserFollows an account as the CALLER.Arguments
Name Type Required userIdstringThe account's numeric id (ThreadsProfile.id).Yes Returns
ThreadsUserActionResultinterface ThreadsUserActionResult { userId: string; done: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/followUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.followUser({ userId: "<userId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.followUser({"userId": "<userId>"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/followUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"userId":"<userId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.followUser({ userId: "<userId>" });likePostLikes a post as the CALLER.Arguments
Name Type Required postIdstringThe post's numeric id (ThreadsPost.id).Yes Returns
ThreadsActionResultinterface ThreadsActionResult { postId: string; done: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/likePostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.likePost({ postId: "<postId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.likePost({"postId": "<postId>"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/likePost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"postId":"<postId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.likePost({ postId: "<postId>" });muteUserMutes an account so the CALLER stops seeing its posts, without unfollowing.Arguments
Name Type Required userIdstringThe account's numeric id (ThreadsProfile.id).Yes Returns
ThreadsUserActionResultinterface ThreadsUserActionResult { userId: string; done: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/muteUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.muteUser({ userId: "<userId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.muteUser({"userId": "<userId>"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/muteUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"userId":"<userId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.muteUser({ userId: "<userId>" });quotePostQuotes a post as the CALLER, with their own text above it.Arguments
Name Type Required postIdstringThe post's numeric id (ThreadsPost.id from getPost / getProfilePosts).Yes textstringUp to 500 characters.Yes Returns
ThreadsPublishedinterface ThreadsPublished { id: string; // the new post's numeric id code: string | null; // its short code, when Threads returns one url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/quotePostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.quotePost({ postId: "<postId>", text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.quotePost({"postId": "<postId>", "text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/quotePost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"postId":"<postId>","text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.quotePost({ postId: "<postId>", text: "<text>" });replyToPostReplies to a post as the CALLER.Arguments
Name Type Required postIdstringThe post's numeric id (ThreadsPost.id from getPost / getProfilePosts).Yes textstringUp to 500 characters.Yes Returns
ThreadsPublishedinterface ThreadsPublished { id: string; // the new post's numeric id code: string | null; // its short code, when Threads returns one url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/replyToPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.replyToPost({ postId: "<postId>", text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.replyToPost({"postId": "<postId>", "text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/replyToPost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"postId":"<postId>","text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.replyToPost({ postId: "<postId>", text: "<text>" });repostPostReposts a post to the CALLER's profile.Arguments
Name Type Required postIdstringThe post's numeric id (ThreadsPost.id).Yes Returns
ThreadsActionResultinterface ThreadsActionResult { postId: string; done: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/repostPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.repostPost({ postId: "<postId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.repostPost({"postId": "<postId>"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/repostPost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"postId":"<postId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.repostPost({ postId: "<postId>" });unblockUserUnblocks an account the CALLER blocked.Arguments
Name Type Required userIdstringThe account's numeric id (ThreadsProfile.id).Yes Returns
ThreadsUserActionResultinterface ThreadsUserActionResult { userId: string; done: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/unblockUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.unblockUser({ userId: "<userId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.unblockUser({"userId": "<userId>"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/unblockUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"userId":"<userId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.unblockUser({ userId: "<userId>" });unfollowUserUnfollows an account as the CALLER.Arguments
Name Type Required userIdstringThe account's numeric id (ThreadsProfile.id).Yes Returns
ThreadsUserActionResultinterface ThreadsUserActionResult { userId: string; done: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/unfollowUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.unfollowUser({ userId: "<userId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.unfollowUser({"userId": "<userId>"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/unfollowUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"userId":"<userId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.unfollowUser({ userId: "<userId>" });unlikePostRemoves the CALLER's like from a post.Arguments
Name Type Required postIdstringThe post's numeric id (ThreadsPost.id).Yes Returns
ThreadsActionResultinterface ThreadsActionResult { postId: string; done: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/unlikePostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.unlikePost({ postId: "<postId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.unlikePost({"postId": "<postId>"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/unlikePost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"postId":"<postId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.unlikePost({ postId: "<postId>" });unmuteUserUnmutes an account the CALLER muted, so its posts show again.Arguments
Name Type Required userIdstringThe account's numeric id (ThreadsProfile.id).Yes Returns
ThreadsUserActionResultinterface ThreadsUserActionResult { userId: string; done: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/unmuteUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.unmuteUser({ userId: "<userId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.unmuteUser({"userId": "<userId>"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/unmuteUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"userId":"<userId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.unmuteUser({ userId: "<userId>" });unrepostPostRemoves the CALLER's repost of a post.Arguments
Name Type Required postIdstringThe post's numeric id (ThreadsPost.id).Yes Returns
ThreadsActionResultinterface ThreadsActionResult { postId: string; done: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/unrepostPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.unrepostPost({ postId: "<postId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.unrepostPost({"postId": "<postId>"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/unrepostPost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"postId":"<postId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.unrepostPost({ postId: "<postId>" });updateProfileSets the CALLER's own Threads bio.Arguments
Name Type Required biographystringNew bio, up to 150 characters; "" clears it.Yes Returns
ThreadsUpdateProfileResultinterface ThreadsUpdateProfileResult { biography: string; done: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/threads/updateProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.threads.updateProfile({ biography: "<biography>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.threads.updateProfile({"biography": "<biography>"}))curl -X POST https://api.bowmark.ai/v1/sites/threads/updateProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"biography":"<biography>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.threads.updateProfile({ biography: "<biography>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/threads/<function> - OpenAPI
/v1/sites/threads/openapi.json