BlueskyとAT ProtocolのためのMCPサーバー

アカウントのパスワードを渡さずに、MCPクライアントからBlueskyとAT Protocolの公開ツールを利用できます。

著者:Bluesky.botチーム

公開日:
更新日:
確認日:

クライアントでできること

公開ツールはハンドルやDIDの解決、公開データの確認、計算を行います。このMCPエンドポイントはBlueskyのアプリパスワードを受け取りません。作成者トークンやMCP OAuth接続で公開ツールの利用枠を増やせます。掲載情報のツールには専用権限が必要で、ハンドルの取得や解放はできません。

公開MCPツール
ツールMCP名HTTPキャッシュ利用枠のコスト
自動化の公開宣言チェッカー

アカウントが公開する自動化の印を確認します。

bot_signals60秒3単位
DID 検索

Bluesky のハンドルの裏にある DID を調べる。

find_did60秒1単位
ハンドル検索(DID からハンドル)

DID の裏にあるハンドルを調べる。

find_handle60秒1単位
Bluesky whois

ハンドルや DID について公開されているすべて。

whois_lookup60秒3単位
アカウント年齢チェッカー

アカウントがいつ Bluesky に参加したかを調べる。

check_account_age60秒1単位
AT URI コンバーター

bsky.app のリンクと at:// の URI を相互に変換。

convert_at_uri60秒1単位
TID デコーダー

レコードキーに隠れた日付を読む。

decode_tid1年1単位
投稿の文字数カウンター

Bluesky と同じ方法で投稿の文字数を数えます。

count_post_characters1年1単位
リッチテキストのファセットビルダー

メンション、リンク、ハッシュタグをバイト位置つきで。

build_post_facetsキャッシュなしリクエストによる
独自ドメインのハンドルチェッカー

ハンドルが無効になる理由と、その直し方がわかります。

check_custom_handleキャッシュなし2単位
ハンドルの空き状況チェッカー

その名前は Bluesky で空いていますか?

check_handle_availabilityキャッシュなし1単位
PLC 履歴ビューア

アカウントのハンドル変更、サーバー移行、鍵の変更をすべて。

plc_history5分2単位
スターターパック分析

スターターパックのメンバーを、数字やボットと一緒に。

analyse_starter_pack5分リクエストによる
投稿とスレッドのビューア

公開されている Bluesky の投稿やスレッドを、アカウントなしで読めます。

view_bluesky_post60秒3単位
フィードインスペクター

カスタムフィードをプレビューし、何も表示されない理由を調べます。

inspect_bluesky_feedキャッシュなし3単位
ラベルインスペクター

誰がラベルを付けたか、その意味を確認できます。

inspect_bluesky_labels5分リクエストによる
フォロワー一覧のエクスポート

公開フォロワー・フォロー一覧をCSVでバックアップ。

preview_bluesky_follows5分2単位
リポジトリエクスプローラー

アカウント自身のサーバーにある公開データを閲覧します。

explore_atproto_repo5分2単位
その他のMCPツール
MCP名ツール認証機能
check_handleBluesky.botハンドルの空きを確認公開読み取り専用
resolve_handle取得済みBluesky.botハンドルを解決公開読み取り専用
search_bots公開ボットディレクトリを検索公開読み取り専用
get_bot公開ボットの詳細を取得公開読み取り専用
search_docs開発者ドキュメントを検索公開読み取り専用
read_docドキュメントをMarkdownで取得公開読み取り専用
list_my_botsトークン所有者のボットを一覧(handles権限)必要な権限を持つ作成者トークン読み取り専用
get_listing自分のボットの掲載情報を取得(listing権限)必要な権限を持つ作成者トークン読み取り専用
update_listing自分のボットの掲載情報のみ更新(listing権限)必要な権限を持つ作成者トークン自分の掲載情報のみ更新

接続の設定

Streamable HTTP対応クライアントを、このサイトの /api/mcp に接続します。設定例は、あらゆるデスクトップクライアントのバージョンを試したという意味ではありません。公開ツールに認証情報は不要です。連携リファレンスでプロトコルと認証を確認できます。

Claude Code
claude mcp add --transport http bluesky-bot https://bluesky.bot/api/mcp
VS Code (.vscode/mcp.json)
{
  "servers": {
    "bluesky-bot": {
      "type": "http",
      "url": "https://bluesky.bot/api/mcp"
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "bluesky-bot": {
      "url": "https://bluesky.bot/api/mcp"
    }
  }
}

Streamable HTTP対応のClaude Desktopでは、このサイトの/api/mcpのURLをリモートコネクターとして追加します。必要な場合はOAuth接続を使います。

設定形式はクライアントのバージョンにより異なります。この例にBlueskyのアプリパスワードを入れないでください。任意のBluesky.botトークンやOAuth接続にはそれぞれの権限があります。

記録した3つのプロトコルセッション

MCP JavaScript SDKクライアントのバージョン1.32.2で、実際に当サービスへ接続した記録です。各セッションは初期化、ツール一覧の取得、公開ツール1件の呼び出し、接続終了を行いました。質問は目的を示し、結果はツールの回答そのものです。これはプロトコルのテストで、AIモデルとの架空の会話ではありません。

取得日

入力

{
  "question": "Which DID does the official bluesky.bot handle resolve to?",
  "method": "tools/call",
  "params": {
    "name": "find_did",
    "arguments": {
      "handle": "bluesky.bot"
    }
  }
}

取得した出力

{
  "client": "MCP JavaScript SDK",
  "clientVersion": "1.32.2",
  "transport": "Streamable HTTP",
  "server": {
    "name": "bluesky-bot",
    "title": "Bluesky.bot",
    "version": "1.1.0"
  },
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"status\":\"found\",\"handle\":\"bluesky.bot\",\"unicodeHandle\":null,\"dns\":{\"status\":\"found\",\"did\":\"did:plc:ulmk4vmvoobkemd3w2tkwhu5\"},\"https\":{\"status\":\"none\"},\"appview\":{\"status\":\"found\",\"did\":\"did:plc:ulmk4vmvoobkemd3w2tkwhu5\"},\"did\":\"did:plc:ulmk4vmvoobkemd3w2tkwhu5\",\"method\":\"dns\",\"verified\":true,\"claimedHandle\":null,\"warnings\":[]}\n\nTool page: https://bluesky.bot/tools/did-finder"
      }
    ],
    "structuredContent": {
      "tool": "did-finder",
      "url": "https://bluesky.bot/tools/did-finder",
      "result": {
        "status": "found",
        "handle": "bluesky.bot",
        "unicodeHandle": null,
        "dns": {
          "status": "found",
          "did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5"
        },
        "https": {
          "status": "none"
        },
        "appview": {
          "status": "found",
          "did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5"
        },
        "did": "did:plc:ulmk4vmvoobkemd3w2tkwhu5",
        "method": "dns",
        "verified": true,
        "claimedHandle": null,
        "warnings": []
      }
    }
  }
}
取得日

入力

{
  "question": "Does this short sample fit a Bluesky post?",
  "method": "tools/call",
  "params": {
    "name": "count_post_characters",
    "arguments": {
      "text": "Hello Bluesky! 👋"
    }
  }
}

取得した出力

{
  "client": "MCP JavaScript SDK",
  "clientVersion": "1.32.2",
  "transport": "Streamable HTTP",
  "server": {
    "name": "bluesky-bot",
    "title": "Bluesky.bot",
    "version": "1.1.0"
  },
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"graphemes\":16,\"bytes\":19,\"graphemesLeft\":284,\"bytesLeft\":2981,\"over\":false,\"limits\":{\"graphemes\":300,\"bytes\":3000},\"parts\":[]}\n\nTool page: https://bluesky.bot/tools/character-counter"
      }
    ],
    "structuredContent": {
      "tool": "character-counter",
      "url": "https://bluesky.bot/tools/character-counter",
      "result": {
        "graphemes": 16,
        "bytes": 19,
        "graphemesLeft": 284,
        "bytesLeft": 2981,
        "over": false,
        "limits": {
          "graphemes": 300,
          "bytes": 3000
        },
        "parts": []
      }
    }
  }
}
取得日

入力

{
  "question": "What timestamp does this example record key encode?",
  "method": "tools/call",
  "params": {
    "name": "decode_tid",
    "arguments": {
      "tid": "3l6oveex3ii2l"
    }
  }
}

取得した出力

{
  "client": "MCP JavaScript SDK",
  "clientVersion": "1.32.2",
  "transport": "Streamable HTTP",
  "server": {
    "name": "bluesky-bot",
    "title": "Bluesky.bot",
    "version": "1.1.0"
  },
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"tid\":\"3l6oveex3ii2l\",\"timestamp\":\"2024-10-17T07:06:51.642Z\",\"microseconds\":\"1729148811642318\",\"clockId\":17,\"topBitSet\":false}\n\nTool page: https://bluesky.bot/tools/tid-decoder"
      }
    ],
    "structuredContent": {
      "tool": "tid-decoder",
      "url": "https://bluesky.bot/tools/tid-decoder",
      "result": {
        "tid": "3l6oveex3ii2l",
        "timestamp": "2024-10-17T07:06:51.642Z",
        "microseconds": "1729148811642318",
        "clockId": 17,
        "topBitSet": false
      }
    }
  }
}

用途に合うサーバーを選ぶ

当サイトの公開ツールは、アカウントの認証情報なしで識別情報やプロトコルを確認する用途に向いています。エージェントから投稿するなら、明示的な書き込み権限を持つサーバーが適している場合があります。アプリパスワードを秘密に保ち、許可するツールを確認し、重要な変更は人が確認してください。読み取り専用の注釈があっても、外部テキストの指示が信頼できるとは限りません。

以下は2026年11月15日に各リンク先READMEで確認した内容です。他のサーバーを実行したり、安全性を監査したりはしていません。機能と要件は変わることがあります。

サーバー通信方式認証機能ライセンス最新コミット向いている用途README確認日
brianellin/bsky-mcp-serverローカルstdioBlueskyアプリパスワード読み取り・書き込みMITアカウントのタイムラインと投稿
Ravishka17/Bluesky-MCPStreamable HTTP公開読み取り・書き込みはヘッダーでアプリパスワード読み取り・書き込みUnlicense書き込み対応の自前HTTPクライアント
cameronrye/atproto-mcpstdio・任意のHTTP公開読み取り・非公開データと書き込みは認証が必要読み取り・書き込みMIT幅広いAT Protocolアカウント操作

制限と適切な利用

匿名利用:60秒あたり60単位、24時間あたり2000単位。有効な作成者トークンの所有者に稼働中のボットが1つ以上ある場合、両方の上限が10倍になります。

各呼び出しは両方の利用枠からツールの重みを消費します。サーバー検索には共通の外部アクセス枠もあるため、個別の枠が残っていても複雑な確認が拒否される場合があります。

MCPには別途、匿名クライアントの60秒あたり120リクエストという上限があります。条件を満たす作成者トークンではこの上限も増えます。ツールを呼ばない検出やツール一覧の取得も数えます。

MCPツールの失敗は結果内のisError: trueで返します。トランスポートの検査はHTTPエラーを返す場合があり、利用枠超過の拒否にはRetry-Afterが含まれます。JSON-RPCエラーの詳細はプロトコルのリファレンスをご覧ください。

ツール名と経路を集計し、入力値は集計しません。ツールの入力を含むクエリはアクセスログから除外します。秘密、非公開投稿、他人の認証情報は送らないでください。

無料のベストエフォートサービスで、稼働率のSLAはありません。キャッシュ可能な結果を再利用し、再試行の待ち時間を守ってください。別の用途はお問い合わせください。

HTTPという選択肢

MCPが不要なら無料ツールAPIを利用できます。同じツール定義からスキーマと回答を提供します。このページは、MCPディレクトリへの登録、稼働保証、独立したセキュリティ監査、他社サービスの実地テストを意味しません。

ターミナルを使う場合は、Blueskyのコマンドラインクライアント比較をご覧ください。公開済みのbsbotのバージョンと現在の制限も説明しています。

よくある質問

Blueskyのパスワードは必要ですか

不要です。公開ツールにパスワードやトークンは必要ありません。任意のBluesky.botトークンやOAuth接続にはそれぞれ権限があります。

投稿、フォロー、投稿削除はできますか

公開ツールではできません。掲載情報のツールは明示的な許可の下で作成者自身のディレクトリ情報のみ変更でき、Blueskyのハンドルは管理できません。

通信方式は何ですか

/api/mcpでStreamable HTTPを使います。対応クライアントが必要で、設定形式はバージョンによります。

代わりにHTTP APIを使えますか

はい。/api/v1/toolsのAPIは同じ公開ツール定義を提供します。

出典