Bluesky MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Bluesky: 70 typed functions through one MCP server. No Bluesky API key needed.
- Site
- bsky.app
- Functions
- 70
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Bluesky 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/blueskyOne MCP server for Bluesky 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 in one of the caller's DM conversations, page by page, with a finder from a person's handle.Arguments
Name Type Required conversationIdstringNo withstringNo limitnumberNo cursorstringNo Returns
BlueskyConversationMessagesinterface BlueskyChatMessage { id: string; text: string; senderDid: string; sentAt: string; deleted: boolean; } interface BlueskyConversationMessages { conversationId: string; messages: BlueskyChatMessage[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getConversationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getConversation({ with: "bsky.app" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getConversation({"with": "bsky.app"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getConversation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"with":"bsky.app"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getConversation({ with: "bsky.app" });getFeedRead a custom feed's posts (Discover, What's Hot, any creator's feed) by URL or at:// URI, page by page.Arguments
Name Type Required feedstring | { feed: string; limit?: number; cursor?: string }Yes Returns
BlueskyFeedinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyPostEmbed { kind: "images" | "external" | "video" | "quote" | null; images?: { thumb: string; fullsize: string; alt: string }[]; external?: { uri: string; title: string; description: string; thumb: string | null }; video?: { thumbnail: string | null; alt: string | null }; quotedPost?: string | null; } interface BlueskyPost { uri: string; cid: string; author: BlueskyPostAuthor; text: string; createdAt: string; likeCount: number; replyCount: number; repostCount: number; quoteCount: number; bookmarkCount: number; embed: BlueskyPostEmbed | null; isRepost: boolean; repostedBy: string | null; } interface BlueskyFeed { posts: BlueskyPost[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getFeed("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.generator/whats-hot");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getFeed("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.generator/whats-hot"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"feed":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.generator/whats-hot"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getFeed("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.generator/whats-hot");getFeedInfoOne custom feed's details: name, creator, description, avatar, like count and whether it is online.Arguments
Name Type Required feedstring | { feed: string }Yes Returns
BlueskyFeedInfointerface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyFeedInfo { uri: string; name: string; creator: BlueskyPostAuthor; description: string | null; avatar: string | null; likeCount: number; indexedAt: string | null; isOnline: boolean; isValid: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getFeedInfoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getFeedInfo("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.generator/whats-hot");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getFeedInfo("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.generator/whats-hot"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getFeedInfo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"feed":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.generator/whats-hot"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getFeedInfo("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.generator/whats-hot");getFollowersWho follows a person, page by page.Arguments
Name Type Required actorstring | { actor: string; limit?: number; cursor?: string }Yes Returns
BlueskyFollowersResultsinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyFollowersResults { followers: BlueskyPostAuthor[]; subject: BlueskyPostAuthor; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getFollowersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getFollowers("bsky.app");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getFollowers("bsky.app"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getFollowers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"actor":"bsky.app"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getFollowers("bsky.app");getFollowsWho a person follows, page by page.Arguments
Name Type Required actorstring | { actor: string; limit?: number; cursor?: string }Yes Returns
BlueskyFollowsResultsinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyFollowsResults { follows: BlueskyPostAuthor[]; subject: BlueskyPostAuthor; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getFollowsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getFollows("bsky.app");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getFollows("bsky.app"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getFollows \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"actor":"bsky.app"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getFollows("bsky.app");getKnownFollowersWhich of the caller's own follows also follow a given person.Arguments
Name Type Required actorstring | { actor: string; limit?: number; cursor?: string }Yes Returns
BlueskyKnownFollowersinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyKnownFollowers { followers: BlueskyPostAuthor[]; subject: BlueskyPostAuthor; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getKnownFollowersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getKnownFollowers("bsky.app");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getKnownFollowers("bsky.app"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getKnownFollowers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"actor":"bsky.app"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getKnownFollowers("bsky.app");getLabelersA moderation service's (labeler's) details and the labels it applies.Arguments
Name Type Required didsstring | string[] | { dids: string | string[]; detailed?: boolean }Yes Returns
BlueskyLabelersResultsinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyLabelDefinition { identifier: string; severity: string; defaultSetting: string; adultOnly: boolean; name: string; description: string; } interface BlueskyLabelerView { uri: string; creator: BlueskyPostAuthor; likeCount: number; policies: BlueskyLabelDefinition[] | null; } interface BlueskyLabelersResults { labelers: BlueskyLabelerView[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getLabelersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getLabelers({ dids: ["did:plc:ar7c4by46qjdydhdevvrndac"] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getLabelers({"dids": ["did:plc:ar7c4by46qjdydhdevvrndac"]}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getLabelers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"dids":{"dids":["did:plc:ar7c4by46qjdydhdevvrndac"]}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getLabelers({ dids: ["did:plc:ar7c4by46qjdydhdevvrndac"] });getListA list's details and members, page by page.Arguments
Name Type Required liststring | { list: string; limit?: number; cursor?: string }Yes Returns
BlueskyListResultinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyUserList { uri: string; name: string; purpose: "curate" | "moderation" | "unknown"; itemCount: number; description: string | null; creator: BlueskyPostAuthor; } interface BlueskyListMember { uri: string; member: BlueskyPostAuthor; } interface BlueskyListResult { list: BlueskyUserList; members: BlueskyListMember[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getListCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getList("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.list/3lvpca43j5z26");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getList("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.list/3lvpca43j5z26"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getList \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"list":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.list/3lvpca43j5z26"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getList("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.list/3lvpca43j5z26");getListFeedThe posts from everyone on a curation list, as the list's own feed tab shows them.Arguments
Name Type Required liststring | { list: string; limit?: number; cursor?: string }Yes Returns
BlueskyListFeedResultinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyPostEmbed { kind: "images" | "external" | "video" | "quote" | null; images?: { thumb: string; fullsize: string; alt: string }[]; external?: { uri: string; title: string; description: string; thumb: string | null }; video?: { thumbnail: string | null; alt: string | null }; quotedPost?: string | null; } interface BlueskyPost { uri: string; cid: string; author: BlueskyPostAuthor; text: string; createdAt: string; likeCount: number; replyCount: number; repostCount: number; quoteCount: number; bookmarkCount: number; embed: BlueskyPostEmbed | null; isRepost: boolean; repostedBy: string | null; } interface BlueskyListFeedResult { posts: BlueskyPost[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getListFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getListFeed("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.list/3lvpca43j5z26");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getListFeed("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.list/3lvpca43j5z26"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getListFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"list":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.list/3lvpca43j5z26"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getListFeed("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.list/3lvpca43j5z26");getMeWho the signed-in caller is: their DID, handle, email-confirmed flag and PDS host.Arguments
None.
Returns
BlueskyMeinterface BlueskyMe { did: string; handle: string; email: string | null; emailConfirmed: boolean; active: boolean; pds: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getMeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getMe();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getMe())curl -X POST https://api.bowmark.ai/v1/sites/bluesky/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.bluesky.getMe();getMyLikesThe posts the caller has liked.Arguments
Name Type Required opts{ limit?: number; cursor?: string }No Returns
BlueskySignedInPostPageinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyPostEmbed { kind: "images" | "external" | "video" | "quote" | null; images?: { thumb: string; fullsize: string; alt: string }[]; external?: { uri: string; title: string; description: string; thumb: string | null }; video?: { thumbnail: string | null; alt: string | null }; quotedPost?: string | null; } interface BlueskyPost { uri: string; cid: string; author: BlueskyPostAuthor; text: string; createdAt: string; likeCount: number; replyCount: number; repostCount: number; quoteCount: number; bookmarkCount: number; embed: BlueskyPostEmbed | null; isRepost: boolean; repostedBy: string | null; } interface BlueskySignedInPostPage { posts: BlueskyPost[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getMyLikesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getMyLikes();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getMyLikes())curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getMyLikes \ -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.bluesky.getMyLikes();getPostOne post by URL (bsky.app/profile/<handle>/post/<rkey>) or at:// URI: text, author, embeds, reply/repost/like/quote counts.Arguments
Name Type Required poststringYes Returns
BlueskyGetPostResultinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyPostEmbed { kind: "images" | "external" | "video" | "quote" | null; images?: { thumb: string; fullsize: string; alt: string }[]; external?: { uri: string; title: string; description: string; thumb: string | null }; video?: { thumbnail: string | null; alt: string | null }; quotedPost?: string | null; } interface BlueskyPost { uri: string; cid: string; author: BlueskyPostAuthor; text: string; createdAt: string; likeCount: number; replyCount: number; repostCount: number; quoteCount: number; bookmarkCount: number; embed: BlueskyPostEmbed | null; isRepost: boolean; repostedBy: string | null; } type BlueskyGetPostResult = BlueskyPost;HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getPost("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3myi2ihquwk26");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getPost("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3myi2ihquwk26"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getPost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"post":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3myi2ihquwk26"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getPost("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3myi2ihquwk26");getPostLikesWho liked a post, page by page.Arguments
Name Type Required poststring | { post: string; limit?: number; cursor?: string }Yes Returns
BlueskyPostLikesResultsinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyPostLike { actor: BlueskyPostAuthor; indexedAt: string; } interface BlueskyPostLikesResults { likes: BlueskyPostLike[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getPostLikesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getPostLikes("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3myi2ihquwk26");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getPostLikes("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3myi2ihquwk26"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getPostLikes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"post":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3myi2ihquwk26"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getPostLikes("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3myi2ihquwk26");getPostQuotesThe posts that quote a given post, page by page.Arguments
Name Type Required poststring | { post: string; limit?: number; cursor?: string }Yes Returns
BlueskyPostQuotesResultsinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyPostEmbed { kind: "images" | "external" | "video" | "quote" | null; images?: { thumb: string; fullsize: string; alt: string }[]; external?: { uri: string; title: string; description: string; thumb: string | null }; video?: { thumbnail: string | null; alt: string | null }; quotedPost?: string | null; } interface BlueskyPost { uri: string; cid: string; author: BlueskyPostAuthor; text: string; createdAt: string; likeCount: number; replyCount: number; repostCount: number; quoteCount: number; bookmarkCount: number; embed: BlueskyPostEmbed | null; isRepost: boolean; repostedBy: string | null; } interface BlueskyPostQuotesResults { posts: BlueskyPost[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getPostQuotesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getPostQuotes("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mw2cdr44fc2a");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getPostQuotes("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mw2cdr44fc2a"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getPostQuotes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"post":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mw2cdr44fc2a"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getPostQuotes("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mw2cdr44fc2a");getPostRepostsWho reposted a post, page by page.Arguments
Name Type Required poststring | { post: string; limit?: number; cursor?: string }Yes Returns
BlueskyPostRepostsResultsinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyPostRepostsResults { reposters: BlueskyPostAuthor[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getPostRepostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getPostReposts("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mw2cdr44fc2a");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getPostReposts("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mw2cdr44fc2a"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getPostReposts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"post":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mw2cdr44fc2a"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getPostReposts("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mw2cdr44fc2a");getProfileOne person's profile: display name, handle, bio, avatar, banner, follower/following/post counts, pinned post and labels.Arguments
Name Type Required actorstringYes Returns
BlueskyProfileinterface BlueskyProfile { did: string; handle: string; displayName: string | null; bio: string | null; avatar: string | null; banner: string | null; followersCount: number; followsCount: number; postsCount: number; pinnedPost: string | null; labels: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getProfile("bsky.app");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getProfile("bsky.app"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"actor":"bsky.app"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getProfile("bsky.app");getRelationshipsWhether one account follows, or is followed by, each of a list of others.Arguments
Name Type Required args{ actor: string; others: string | string[] }Yes Returns
BlueskyRelationshipsResultsinterface BlueskyRelationship { did: string; following: string | null; followedBy: string | null; } interface BlueskyRelationshipsResults { actor: string; relationships: BlueskyRelationship[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getRelationshipsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getRelationships({ actor: "bsky.app", others: "jay.bsky.team" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getRelationships({"actor": "bsky.app", "others": "jay.bsky.team"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getRelationships \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"actor":"bsky.app","others":"jay.bsky.team"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getRelationships({ actor: "bsky.app", others: "jay.bsky.team" });getStarterPackOne starter pack: its creator, description, the accounts and feeds it bundles, and how many joined through it.Arguments
Name Type Required starterPackstring | { starterPack: string }Yes Returns
BlueskyStarterPackResultinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyListMember { uri: string; member: BlueskyPostAuthor; } interface BlueskyStarterPackResult { uri: string; name: string; description: string | null; list: string | null; joinedAllTimeCount: number; joinedWeekCount: number; creator: BlueskyPostAuthor; memberSample: BlueskyListMember[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getStarterPackCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getStarterPack("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.starterpack/3mv3qhvnmkd2l");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getStarterPack("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.starterpack/3mv3qhvnmkd2l"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getStarterPack \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"starterPack":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.starterpack/3mv3qhvnmkd2l"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getStarterPack("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.starterpack/3mv3qhvnmkd2l");getSuggestedFeedsBluesky's own suggested custom feeds.Arguments
Name Type Required options{ limit?: number }No Returns
BlueskySuggestedFeedsResultsinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskySuggestedFeedResult { uri: string; name: string; creator: BlueskyPostAuthor; description: string | null; likeCount: number; } interface BlueskySuggestedFeedsResults { feeds: BlueskySuggestedFeedResult[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getSuggestedFeedsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getSuggestedFeeds();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getSuggestedFeeds())curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getSuggestedFeeds \ -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.bluesky.getSuggestedFeeds();getSuggestedFollowsAccounts Bluesky suggests alongside a given person.Arguments
Name Type Required actorstringYes Returns
BlueskySuggestedFollowsResultsinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskySuggestedFollowsResults { suggestions: BlueskyPostAuthor[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getSuggestedFollowsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getSuggestedFollows("bsky.app");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getSuggestedFollows("bsky.app"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getSuggestedFollows \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"actor":"bsky.app"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getSuggestedFollows("bsky.app");getSuggestedUsersBluesky's own suggested accounts to follow, as shown during onboarding.Arguments
Name Type Required options{ limit?: number }No Returns
BlueskySuggestedUsersResultsinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskySuggestedUsersResults { users: BlueskyPostAuthor[]; count: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getSuggestedUsersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getSuggestedUsers();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getSuggestedUsers())curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getSuggestedUsers \ -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.bluesky.getSuggestedUsers();getThreadA post with its whole conversation: the parents above it and the reply tree below it, as the post page shows it.Arguments
Name Type Required poststringYes Returns
BlueskyGetThreadResultinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyPostEmbed { kind: "images" | "external" | "video" | "quote" | null; images?: { thumb: string; fullsize: string; alt: string }[]; external?: { uri: string; title: string; description: string; thumb: string | null }; video?: { thumbnail: string | null; alt: string | null }; quotedPost?: string | null; } interface BlueskyPost { uri: string; cid: string; author: BlueskyPostAuthor; text: string; createdAt: string; likeCount: number; replyCount: number; repostCount: number; quoteCount: number; bookmarkCount: number; embed: BlueskyPostEmbed | null; isRepost: boolean; repostedBy: string | null; } interface BlueskyGetThreadResult { root: BlueskyPost; parents: BlueskyPost[]; replies: BlueskyPost[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getThreadCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getThread("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mw2cdr44fc2a");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getThread("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mw2cdr44fc2a"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getThread \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"post":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mw2cdr44fc2a"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getThread("at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mw2cdr44fc2a");getTimelineThe caller's home Following feed, newest first, page by page.Arguments
Name Type Required opts{ limit?: number; cursor?: string }No Returns
BlueskySignedInPostPageinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyPostEmbed { kind: "images" | "external" | "video" | "quote" | null; images?: { thumb: string; fullsize: string; alt: string }[]; external?: { uri: string; title: string; description: string; thumb: string | null }; video?: { thumbnail: string | null; alt: string | null }; quotedPost?: string | null; } interface BlueskyPost { uri: string; cid: string; author: BlueskyPostAuthor; text: string; createdAt: string; likeCount: number; replyCount: number; repostCount: number; quoteCount: number; bookmarkCount: number; embed: BlueskyPostEmbed | null; isRepost: boolean; repostedBy: string | null; } interface BlueskySignedInPostPage { posts: BlueskyPost[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getTimelineCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getTimeline();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getTimeline())curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getTimeline \ -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.bluesky.getTimeline();getTrendingTopicsWhat is trending on Bluesky right now: the topics and the links to their search or feed pages.Arguments
None.
Returns
BlueskyTrendingTopicsResultsinterface BlueskyTrendingTopic { link: string; description: string; topic: string; displayName: string; } interface BlueskyTrendingTopicsResults { topics: BlueskyTrendingTopic[]; suggested?: string[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getTrendingTopicsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getTrendingTopics();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getTrendingTopics())curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getTrendingTopics \ -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.bluesky.getTrendingTopics();getTrendsThe richer trending list the Explore page shows: each trend's post count, status (hot/new) and category.Arguments
None.
Returns
BlueskyTrendsResultsinterface BlueskyTrend { value: string; count: number; status: string; // the site's own labels, read the values off a result, never guess one from prose category?: string; } interface BlueskyTrendsResults { trends: BlueskyTrend[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getTrendsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getTrends();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getTrends())curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getTrends \ -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.bluesky.getTrends();getUserFeedsThe custom feeds a person has made.Arguments
Name Type Required actorstring | { actor: string; limit?: number; cursor?: string }Yes Returns
BlueskyUserFeedsResultsinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyUserFeed { uri: string; name: string; creator: BlueskyPostAuthor; description: string | null; likeCount: number; } interface BlueskyUserFeedsResults { feeds: BlueskyUserFeed[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getUserFeedsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getUserFeeds("bsky.app");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getUserFeeds("bsky.app"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getUserFeeds \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"actor":"bsky.app"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getUserFeeds("bsky.app");getUserListsThe lists (curation and moderation lists) a person has made.Arguments
Name Type Required actorstring | { actor: string; limit?: number; cursor?: string }Yes Returns
BlueskyUserListsResultsinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyUserList { uri: string; name: string; purpose: "curate" | "moderation" | "unknown"; itemCount: number; description: string | null; creator: BlueskyPostAuthor; } interface BlueskyUserListsResults { lists: BlueskyUserList[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getUserListsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getUserLists("bsky.app");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getUserLists("bsky.app"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getUserLists \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"actor":"bsky.app"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getUserLists("bsky.app");getUserPostsA person's posts, newest first, as their profile tabs show them.Arguments
Name Type Required actorstring | { actor: string; filter?: "posts" | "postsWithReplies" | "media" | "videos"; limit?: number; cursor?: string }Yes Returns
BlueskyUserPostsinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyPostEmbed { kind: "images" | "external" | "video" | "quote" | null; images?: { thumb: string; fullsize: string; alt: string }[]; external?: { uri: string; title: string; description: string; thumb: string | null }; video?: { thumbnail: string | null; alt: string | null }; quotedPost?: string | null; } interface BlueskyPost { uri: string; cid: string; author: BlueskyPostAuthor; text: string; createdAt: string; likeCount: number; replyCount: number; repostCount: number; quoteCount: number; bookmarkCount: number; embed: BlueskyPostEmbed | null; isRepost: boolean; repostedBy: string | null; } interface BlueskyUserPosts { posts: BlueskyPost[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getUserPostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getUserPosts("bsky.app");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getUserPosts("bsky.app"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getUserPosts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"actor":"bsky.app"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getUserPosts("bsky.app");getUserStarterPacksThe starter packs a person has made.Arguments
Name Type Required actorstring | { actor: string; limit?: number; cursor?: string }Yes Returns
BlueskyUserStarterPacksResultsinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyUserStarterPack { uri: string; name: string; description: string | null; list: string | null; joinedAllTimeCount: number; joinedWeekCount: number; creator: BlueskyPostAuthor; } interface BlueskyUserStarterPacksResults { starterPacks: BlueskyUserStarterPack[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/getUserStarterPacksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.getUserStarterPacks("bsky.app");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.getUserStarterPacks("bsky.app"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/getUserStarterPacks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"actor":"bsky.app"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.getUserStarterPacks("bsky.app");listBlockedUsersThe accounts the caller has blocked.Arguments
Name Type Required opts{ limit?: number; cursor?: string }No Returns
BlueskySignedInUserPageinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskySignedInUserPage { users: BlueskyPostAuthor[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/listBlockedUsersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.listBlockedUsers();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.listBlockedUsers())curl -X POST https://api.bowmark.ai/v1/sites/bluesky/listBlockedUsers \ -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.bluesky.listBlockedUsers();listBookmarksThe posts the caller has saved to Bookmarks.Arguments
Name Type Required opts{ limit?: number; cursor?: string }No Returns
BlueskyBookmarkPageinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyPostEmbed { kind: "images" | "external" | "video" | "quote" | null; images?: { thumb: string; fullsize: string; alt: string }[]; external?: { uri: string; title: string; description: string; thumb: string | null }; video?: { thumbnail: string | null; alt: string | null }; quotedPost?: string | null; } interface BlueskyPost { uri: string; cid: string; author: BlueskyPostAuthor; text: string; createdAt: string; likeCount: number; replyCount: number; repostCount: number; quoteCount: number; bookmarkCount: number; embed: BlueskyPostEmbed | null; isRepost: boolean; repostedBy: string | null; } interface BlueskyBookmark { savedAt: string; post: BlueskyPost; } interface BlueskyBookmarkPage { bookmarks: BlueskyBookmark[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/listBookmarksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.listBookmarks();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.listBookmarks())curl -X POST https://api.bowmark.ai/v1/sites/bluesky/listBookmarks \ -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.bluesky.listBookmarks();listConversationsThe caller's direct-message conversations, most recent first, with the last message and unread count.Arguments
Name Type Required opts{ limit?: number; cursor?: string }No Returns
BlueskyConversationPageinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyChatMessage { id: string; text: string; senderDid: string; sentAt: string; deleted: boolean; } interface BlueskyConversation { id: string; members: BlueskyPostAuthor[]; lastMessage: BlueskyChatMessage | null; unreadCount: number; muted: boolean; status: string | null; // the site's own labels, read the values off a result, never guess one from prose } interface BlueskyConversationPage { conversations: BlueskyConversation[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/listConversationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.listConversations();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.listConversations())curl -X POST https://api.bowmark.ai/v1/sites/bluesky/listConversations \ -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.bluesky.listConversations();listModerationListsOne page of the moderation lists the signed-in caller subscribes to: kind: "mute" (the default) for the lists they mute, kind: "block" for the lists…Arguments
Name Type Required opts{ kind?: "mute" | "block"; limit?: number; cursor?: string }No Returns
BlueskyModerationListPageinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyUserList { uri: string; name: string; purpose: "curate" | "moderation" | "unknown"; itemCount: number; description: string | null; creator: BlueskyPostAuthor; } interface BlueskyModerationListPage { kind: "mute" | "block"; lists: BlueskyUserList[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/listModerationListsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.listModerationLists();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.listModerationLists())curl -X POST https://api.bowmark.ai/v1/sites/bluesky/listModerationLists \ -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.bluesky.listModerationLists();listMutedUsersThe accounts the caller has muted.Arguments
Name Type Required opts{ limit?: number; cursor?: string }No Returns
BlueskySignedInUserPageinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskySignedInUserPage { users: BlueskyPostAuthor[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/listMutedUsersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.listMutedUsers();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.listMutedUsers())curl -X POST https://api.bowmark.ai/v1/sites/bluesky/listMutedUsers \ -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.bluesky.listMutedUsers();listMutedWordsList the words and tags the caller has muted.Arguments
None.
Returns
BlueskyMutedWordListinterface BlueskyMutedWord { id: string | null; value: string; targets: string[]; excludeFollowing: boolean; expiresAt: string | null; } interface BlueskyMutedWordList { words: BlueskyMutedWord[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/listMutedWordsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.listMutedWords();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.listMutedWords())curl -X POST https://api.bowmark.ai/v1/sites/bluesky/listMutedWords \ -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.bluesky.listMutedWords();listNotificationsThe caller's notifications.Arguments
Name Type Required opts{ limit?: number; cursor?: string }No Returns
BlueskyNotificationPageinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyNotification { uri: string; reason: string; reasonSubject: string | null; author: BlueskyPostAuthor; text: string; isRead: boolean; indexedAt: string; } interface BlueskyNotificationPage { notifications: BlueskyNotification[]; cursor?: string; seenAt: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/listNotificationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.listNotifications();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.listNotifications())curl -X POST https://api.bowmark.ai/v1/sites/bluesky/listNotifications \ -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.bluesky.listNotifications();resolveHandleTurn a Bluesky handle (alice.bsky.social, or a custom domain handle) into its permanent DID, the id every other function accepts.Arguments
Name Type Required actorstringYes Returns
BlueskyResolvedHandleinterface BlueskyResolvedHandle { did: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/resolveHandleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.resolveHandle("bsky.app");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.resolveHandle("bsky.app"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/resolveHandle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"actor":"bsky.app"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.resolveHandle("bsky.app");searchFeedsFind custom feeds by words (e.g. 'science', 'art'), the way Explore's feed search does; returns each feed's URI, name, creator, description and like…Arguments
Name Type Required querystring | { query: string; limit?: number; cursor?: string }Yes Returns
BlueskySearchFeedsResultsinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskySearchFeedResult { uri: string; name: string; creator: BlueskyPostAuthor; description: string | null; likeCount: number; } interface BlueskySearchFeedsResults { feeds: BlueskySearchFeedResult[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/searchFeedsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.searchFeeds("science");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.searchFeeds("science"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/searchFeeds \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"science"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.searchFeeds("science");searchPostsSearch all public posts by words, with the Search tab's Top/Latest sort and its author, mention, language, domain and date filters.Arguments
Name Type Required querystring | { query: string; sort?: "top" | "latest"; author?: string; mentions?: string; lang?: string; domain?: string; since?: string; until?: string; limit?: number; cursor?: string }Yes Returns
BlueskySearchPostsResultsinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyPostEmbed { kind: "images" | "external" | "video" | "quote" | null; images?: { thumb: string; fullsize: string; alt: string }[]; external?: { uri: string; title: string; description: string; thumb: string | null }; video?: { thumbnail: string | null; alt: string | null }; quotedPost?: string | null; } interface BlueskyPost { uri: string; cid: string; author: BlueskyPostAuthor; text: string; createdAt: string; likeCount: number; replyCount: number; repostCount: number; quoteCount: number; bookmarkCount: number; embed: BlueskyPostEmbed | null; isRepost: boolean; repostedBy: string | null; } interface BlueskySearchPostsResults { posts: BlueskyPost[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/searchPostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.searchPosts("bluesky");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.searchPosts("bluesky"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/searchPosts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"bluesky"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.searchPosts("bluesky");searchStarterPacksFind starter packs by words.Arguments
Name Type Required querystring | { query: string; limit?: number; cursor?: string }Yes Returns
BlueskyStarterPackSearchResultsinterface BlueskyPostAuthor { did: string; handle: string; displayName: string | null; avatar: string | null; } interface BlueskyUserStarterPack { uri: string; name: string; description: string | null; list: string | null; joinedAllTimeCount: number; joinedWeekCount: number; creator: BlueskyPostAuthor; } interface BlueskyStarterPackSearchResults { starterPacks: BlueskyUserStarterPack[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/searchStarterPacksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.searchStarterPacks({ query: "science" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.searchStarterPacks({"query": "science"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/searchStarterPacks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":{"query":"science"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.searchStarterPacks({ query: "science" });searchUsersSearch people by name, handle or bio words, the way the Search tab's People list does; returns handle, DID, display name, avatar and bio per match.Arguments
Name Type Required querystring | { query: string; limit?: number; cursor?: string }Yes Returns
BlueskyUserSearchResultsinterface BlueskyUserResult { did: string; handle: string; displayName: string | null; avatar: string | null; bio: string | null; } interface BlueskyUserSearchResults { users: BlueskyUserResult[]; cursor?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/searchUsersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.searchUsers("bluesky");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.searchUsers("bluesky"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/searchUsers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"bluesky"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.searchUsers("bluesky");suggestUsersHandle autocomplete: the few accounts that best match a partial name, as the compose box's @-mention picker shows them.Arguments
Name Type Required querystring | { query: string; limit?: number }Yes Returns
BlueskySuggestUsersResultsinterface BlueskySuggestedUser { did: string; handle: string; displayName: string | null; avatar: string | null; bio: string | null; } interface BlueskySuggestUsersResults { users: BlueskySuggestedUser[]; count: number; // users.length }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/suggestUsersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.suggestUsers("blue");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.suggestUsers("blue"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/suggestUsers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"blue"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.suggestUsers("blue");
addToListAdd a person to one of the caller's lists, or remove them.Arguments
Name Type Required liststringYes actorstringYes undobooleanNo Returns
BlueskyPostActionResultinterface BlueskyPostActionResult { uri: string | null; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/addToListCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.addToList({ list: "<list>", actor: "<actor>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.addToList({"list": "<list>", "actor": "<actor>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/addToList \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"list":"<list>","actor":"<actor>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.addToList({ list: "<list>", actor: "<actor>" });blockModerationListBlocks a moderation list for the signed-in caller, so every account on it is blocked from interacting with them; undo: true unblocks it.Arguments
Name Type Required liststringYes undobooleanNo Returns
BlueskyModerationListBlockResultinterface BlueskyModerationListBlockResult { list: string; blocked: boolean; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/blockModerationListCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.blockModerationList({ list: "<list>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.blockModerationList({"list": "<list>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/blockModerationList \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"list":"<list>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.blockModerationList({ list: "<list>" });blockUserBlock a person as the caller, or unblock them.Arguments
Name Type Required actorstringYes undobooleanNo Returns
BlueskyPostActionResultinterface BlueskyPostActionResult { uri: string | null; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/blockUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.blockUser({ actor: "<actor>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.blockUser({"actor": "<actor>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/blockUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"actor":"<actor>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.blockUser({ actor: "<actor>" });bookmarkPostSave a post to the caller's Bookmarks, or remove it.Arguments
Name Type Required poststringYes undobooleanNo Returns
BlueskyPostActionResultinterface BlueskyPostActionResult { uri: string | null; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/bookmarkPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.bookmarkPost({ post: "<post>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.bookmarkPost({"post": "<post>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/bookmarkPost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"post":"<post>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.bookmarkPost({ post: "<post>" });createListCreate a curation or moderation list owned by the caller.Arguments
Name Type Required namestringYes descriptionstringNo purpose"curate" | "moderate"No Returns
BlueskyCreatedRecordinterface BlueskyCreatedRecord { uri: string; cid: string; url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/createListCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.createList({ name: "<name>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.createList({"name": "<name>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/createList \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"name":"<name>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.createList({ name: "<name>" });createPostPublish a post as the caller: text with links and mentions resolved into facets, optional language tags.Arguments
Name Type Required textstringYes langsstring[]No Returns
BlueskyCreatedRecordinterface BlueskyCreatedRecord { uri: string; cid: string; url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/createPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.createPost({ text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.createPost({"text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/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.bluesky.createPost({ text: "<text>" });createPostWithImagesPublish a post with up to four images and their alt text.Arguments
Name Type Required textstringNo imagesBlueskyPostImage[]Yes langsstring[]No Returns
BlueskyCreatedRecordinterface BlueskyCreatedRecord { uri: string; cid: string; url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/createPostWithImagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.createPostWithImages({ images: [] });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.createPostWithImages({"images": []}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/createPostWithImages \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"images":[]}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.createPostWithImages({ images: [] });createPostWithVideoPosts one video, with optional text, alt text and languages.Arguments
Name Type Required textstringNo videostringYes altstringNo langsstring[]No Returns
BlueskyCreatedRecordinterface BlueskyCreatedRecord { uri: string; cid: string; url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/createPostWithVideoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.createPostWithVideo({ video: "<video>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.createPostWithVideo({"video": "<video>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/createPostWithVideo \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"video":"<video>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.createPostWithVideo({ video: "<video>" });deleteListDelete one of the caller's own lists.Arguments
Name Type Required liststringYes Returns
BlueskyPostActionResultinterface BlueskyPostActionResult { uri: string | null; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/deleteListCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.deleteList({ list: "<list>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.deleteList({"list": "<list>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/deleteList \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"list":"<list>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.deleteList({ list: "<list>" });deletePostDelete one of the caller's own posts.Arguments
Name Type Required poststringYes Returns
BlueskyPostActionResultinterface BlueskyPostActionResult { uri: string | null; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/deletePostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.deletePost("<post>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.deletePost("<post>"))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/deletePost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"post":"<post>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.deletePost("<post>");followUserFollow a person as the caller, or unfollow them.Arguments
Name Type Required actorstringYes undobooleanNo Returns
BlueskyPostActionResultinterface BlueskyPostActionResult { uri: string | null; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/followUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.followUser({ actor: "<actor>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.followUser({"actor": "<actor>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/followUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"actor":"<actor>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.followUser({ actor: "<actor>" });leaveConversationLeaves a conversation for the signed-in caller, so it stops being among their chats.Arguments
Name Type Required conversationIdstringYes Returns
BlueskyLeftConversationinterface BlueskyLeftConversation { conversationId: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/leaveConversationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.leaveConversation({ conversationId: "<conversationId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.leaveConversation({"conversationId": "<conversationId>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/leaveConversation \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"conversationId":"<conversationId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.leaveConversation({ conversationId: "<conversationId>" });likePostLike a post as the caller, or undo the like.Arguments
Name Type Required poststringYes undobooleanNo Returns
BlueskyPostActionResultinterface BlueskyPostActionResult { uri: string | null; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/likePostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.likePost({ post: "<post>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.likePost({"post": "<post>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/likePost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"post":"<post>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.likePost({ post: "<post>" });markNotificationsReadMark the caller's notifications as seen up to now.Arguments
Name Type Required opts{ seenAt?: string }No Returns
BlueskyMarkSeenResultinterface BlueskyMarkSeenResult { seenAt: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/markNotificationsReadCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.markNotificationsRead();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.markNotificationsRead())curl -X POST https://api.bowmark.ai/v1/sites/bluesky/markNotificationsRead \ -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.bluesky.markNotificationsRead();muteConversationMutes a direct or group chat for the signed-in caller, so its new messages stop notifying them; undo: true unmutes it.Arguments
Name Type Required conversationIdstringNo withstringNo undobooleanNo Returns
BlueskyConversationMuteResultinterface BlueskyConversationMuteResult { conversationId: string; muted: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/muteConversationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.muteConversation({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.muteConversation({}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/muteConversation \ -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.bluesky.muteConversation({});muteModerationListMutes a moderation list for the signed-in caller, so the accounts on it are hidden from their feeds and notifications; undo: true unmutes it.Arguments
Name Type Required liststringYes undobooleanNo Returns
BlueskyModerationListMuteResultinterface BlueskyModerationListMuteResult { list: string; muted: boolean; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/muteModerationListCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.muteModerationList({ list: "<list>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.muteModerationList({"list": "<list>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/muteModerationList \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"list":"<list>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.muteModerationList({ list: "<list>" });muteThreadMutes a thread for the signed-in caller, so its replies stop reaching their notifications, as the app's Mute thread does.Arguments
Name Type Required poststringYes undobooleanNo Returns
BlueskyThreadMuteResultinterface BlueskyThreadMuteResult { root: string; muted: boolean; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/muteThreadCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.muteThread({ post: "<post>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.muteThread({"post": "<post>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/muteThread \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"post":"<post>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.muteThread({ post: "<post>" });muteUserMute a person for the caller, or unmute them.Arguments
Name Type Required actorstringYes undobooleanNo Returns
BlueskyPostActionResultinterface BlueskyPostActionResult { uri: string | null; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/muteUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.muteUser({ actor: "<actor>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.muteUser({"actor": "<actor>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/muteUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"actor":"<actor>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.muteUser({ actor: "<actor>" });muteWordMute a word or tag so matching posts are hidden, or unmute it.Arguments
Name Type Required wordstringYes targets("content" | "tag")[]No excludeFollowingbooleanNo expiresAtstringNo undobooleanNo Returns
BlueskyMuteWordResultinterface BlueskyMuteWordResult { word: string; muted: boolean; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/muteWordCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.muteWord({ word: "<word>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.muteWord({"word": "<word>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/muteWord \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"word":"<word>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.muteWord({ word: "<word>" });pinPostPin one of the caller's own posts to the top of their profile, or unpin it.Arguments
Name Type Required poststringYes undobooleanNo Returns
BlueskyPostActionResultinterface BlueskyPostActionResult { uri: string | null; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/pinPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.pinPost({ post: "<post>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.pinPost({"post": "<post>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/pinPost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"post":"<post>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.pinPost({ post: "<post>" });quotePostQuote-post an existing post with the caller's own text.Arguments
Name Type Required poststringYes textstringYes langsstring[]No Returns
BlueskyCreatedRecordinterface BlueskyCreatedRecord { uri: string; cid: string; url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/quotePostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.quotePost({ post: "<post>", text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.quotePost({"post": "<post>", "text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/quotePost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"post":"<post>","text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.quotePost({ post: "<post>", text: "<text>" });replyToPostReply to a post as the caller, threaded under it.Arguments
Name Type Required poststringYes textstringYes langsstring[]No Returns
BlueskyCreatedRecordinterface BlueskyCreatedRecord { uri: string; cid: string; url: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/replyToPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.replyToPost({ post: "<post>", text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.replyToPost({"post": "<post>", "text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/replyToPost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"post":"<post>","text":"<text>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.replyToPost({ post: "<post>", text: "<text>" });repostRepost a post as the caller, or undo the repost.Arguments
Name Type Required poststringYes undobooleanNo Returns
BlueskyPostActionResultinterface BlueskyPostActionResult { uri: string | null; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/repostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.repost({ post: "<post>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.repost({"post": "<post>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/repost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"post":"<post>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.repost({ post: "<post>" });saveFeedSave or pin a custom feed to the caller's feed list, or remove it.Arguments
Name Type Required feedstringYes pinnedbooleanNo undobooleanNo Returns
BlueskySaveFeedResultinterface BlueskySaveFeedResult { feed: string; saved: boolean; pinned: boolean; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/saveFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.saveFeed({ feed: "<feed>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.saveFeed({"feed": "<feed>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/saveFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"feed":"<feed>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.saveFeed({ feed: "<feed>" });sendMessageSend a direct message as the caller to a person who accepts DMs from them.Arguments
Name Type Required tostringNo conversationIdstringNo textstringYes Returns
BlueskySentMessageinterface BlueskyChatMessage { id: string; text: string; senderDid: string; sentAt: string; deleted: boolean; } interface BlueskySentMessage { conversationId: string; message: BlueskyChatMessage; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/sendMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.sendMessage({ text: "<text>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.sendMessage({"text": "<text>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/sendMessage \ -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.bluesky.sendMessage({ text: "<text>" });setAvatarChange the caller's profile picture (or banner) from an image.Arguments
Name Type Required imagestringYes bannerbooleanNo Returns
BlueskyPostActionResultinterface BlueskyPostActionResult { uri: string | null; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/setAvatarCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.setAvatar({ image: "<image>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.setAvatar({"image": "<image>"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/setAvatar \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"image":"<image>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.setAvatar({ image: "<image>" });setReplyRestrictionSets who may reply to one of the caller's own thread-root posts: allow: "everyone" lifts the restriction, "nobody" closes replies, and a list of up…Arguments
Name Type Required poststringYes allow"everyone" | "nobody" | BlueskyReplyRule[]Yes Returns
BlueskyReplyRestrictionResulttype BlueskyReplyRule = "mentioned" | "followers" | "following" | `at://${string}`; interface BlueskyReplyRestrictionResult { post: string; allow: "everyone" | "nobody" | BlueskyReplyRule[]; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/setReplyRestrictionCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.setReplyRestriction({ post: "<post>", allow: "everyone" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.setReplyRestriction({"post": "<post>", "allow": "everyone"}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/setReplyRestriction \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"post":"<post>","allow":"everyone"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.bluesky.setReplyRestriction({ post: "<post>", allow: "everyone" });updateProfileChange the caller's display name and bio.Arguments
Name Type Required displayNamestringNo biostringNo Returns
BlueskyPostActionResultinterface BlueskyPostActionResult { uri: string | null; changed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/bluesky/updateProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.bluesky.updateProfile({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.bluesky.updateProfile({}))curl -X POST https://api.bowmark.ai/v1/sites/bluesky/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.bluesky.updateProfile({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/bluesky/<function> - OpenAPI
/v1/sites/bluesky/openapi.json