Can I use Bluesky as a CLI?

Yes. KosmoKrator exposes a Bluesky CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Bluesky through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Bluesky tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Bluesky credentials stored?

Bluesky credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Bluesky MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

data

Bluesky MCP, CLI, and Lua Integration for AI Agents

Bluesky integration docs for AI agents: MCP gateway setup, Bluesky CLI commands, Lua API reference, credentials, and function schemas.

Bluesky for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Agent Surfaces

Bluesky CLIHeadless setup, JSON output, direct function calls. Bluesky MCPExpose selected tools to local MCP clients. Bluesky LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug: bluesky
route_slug: bluesky
package: bluesky
auth_strategy: oauth2_manual_token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true

Function Catalog

Function	Type	Parameters	Description
`bluesky.bluesky_create_post`	Write `write`	4	Create a new post on Bluesky. The post text is required and supports facets (mentions, links, tags) if provided.
`bluesky.bluesky_get_profile`	Read `read`	1	Get the public profile of a Bluesky user. Provide a handle (e.g. "alice.bsky.social") or DID.
`bluesky.bluesky_get_timeline`	Read `read`	0	Get the authenticated account timeline.
`bluesky.bluesky_get_author_feed`	Read `read`	0	Get posts and reposts by an actor.
`bluesky.bluesky_get_feed`	Read `read`	0	Get posts from a feed generator.
`bluesky.bluesky_get_feed_generator`	Read `read`	0	Get feed generator metadata.
`bluesky.bluesky_get_post_thread`	Read `read`	0	Get a post thread by URI.
`bluesky.bluesky_get_posts`	Read `read`	0	Get one or more posts by URI.
`bluesky.bluesky_get_likes`	Read `read`	0	Get actors who liked a post.
`bluesky.bluesky_get_reposted_by`	Read `read`	0	Get actors who reposted a post.
`bluesky.bluesky_list_followers`	Read `read`	3	List the followers of a Bluesky account. Returns follower profiles with handles, display names, and avatars.
`bluesky.bluesky_list_following`	Read `read`	3	List the accounts that a Bluesky user follows. Returns profiles with handles, display names, and avatars.
`bluesky.bluesky_search_posts`	Read `read`	3	Search for posts on Bluesky. Supports full-text search queries. Returns matching posts with author, text, and timestamps.
`bluesky.bluesky_list_notifications`	Read `read`	0	List notifications for the authenticated account.
`bluesky.bluesky_get_current_user`	Read `read`	0	Get the authenticated user's own Bluesky profile. No parameters required — uses the configured account.
`bluesky.bluesky_create_record`	Write `write`	0	Create an arbitrary AT Protocol record.
`bluesky.bluesky_delete_record`	Write `write`	0	Delete an AT Protocol record.
`bluesky.bluesky_like_post`	Write `write`	0	Like a Bluesky post.
`bluesky.bluesky_repost_post`	Write `write`	0	Repost a Bluesky post.
`bluesky.bluesky_follow_actor`	Write `write`	0	Follow an actor DID.
`bluesky.bluesky_xrpc_get`	Read `read`	0	Call any GET XRPC method.
`bluesky.bluesky_xrpc_post`	Write `write`	0	Call any POST XRPC method.