KosmoKrator

social

Bluesky MCP Integration for Codex

Connect Bluesky to Codex through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

6 functions 5 read 1 write Manual OAuth token auth
Submit Bluesky feedback View package source

Connect Bluesky to Codex

Use KosmoKrator as a local MCP proxy for Codex so coding sessions can reach selected integrations with explicit write policy.

Register kosmo mcp:serve as a local stdio server and choose the integration allowlist. The gateway is local, scoped to this integration, and starts with --write=deny so Codex can inspect read-capable tools without receiving write access by default.

Bluesky MCP Config for Codex

Keep write access denied or ask-based unless the workspace is trusted.

{
  "mcpServers": {
    "kosmokrator-bluesky": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=bluesky",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=bluesky --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Bluesky instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Bluesky Tools Visible to Codex

Codex sees stable MCP tool names generated from the Bluesky integration catalog.

MCP toolSource functionTypeDescription
integration__bluesky__bluesky_create_post bluesky.bluesky_create_post Write Create a new post on Bluesky. The post text is required and supports facets (mentions, links, tags) if provided.
integration__bluesky__bluesky_get_profile bluesky.bluesky_get_profile Read Get the public profile of a Bluesky user. Provide a handle (e.g. "alice.bsky.social") or DID.
integration__bluesky__bluesky_list_followers bluesky.bluesky_list_followers Read List the followers of a Bluesky account. Returns follower profiles with handles, display names, and avatars.
integration__bluesky__bluesky_list_following bluesky.bluesky_list_following Read List the accounts that a Bluesky user follows. Returns profiles with handles, display names, and avatars.
integration__bluesky__bluesky_search_posts bluesky.bluesky_search_posts Read Search for posts on Bluesky. Supports full-text search queries. Returns matching posts with author, text, and timestamps.
integration__bluesky__bluesky_get_current_user bluesky.bluesky_get_current_user Read Get the authenticated user's own Bluesky profile. No parameters required — uses the configured account.

Related Bluesky Pages

Bluesky CLIUse direct JSON commands instead of MCP discovery. Bluesky MCPFull gateway reference and MCP tool names. KosmoKrator for CodexClient-level gateway setup.