Un serveur MCP pour Bluesky et le protocole AT
Donnez à votre client MCP des outils publics Bluesky et AT Protocol sans lui confier le mot de passe d’un compte.
Par L’équipe Bluesky.bot
- Publié:
- Modifié:
- Revu:
Ce que votre client peut faire
Les outils publics résolvent handles et DID, inspectent des données publiques et effectuent des calculs. Ce point d’accès MCP n’accepte aucun mot de passe d’application Bluesky. Un jeton créateur ou une connexion OAuth MCP peut augmenter les quotas publics. Les outils de fiche exigent une permission dédiée et ne peuvent ni réserver ni libérer un handle.
| Outil | Nom MCP | Cache HTTP | Coût dans le quota |
|---|---|---|---|
| Vérificateur de déclarations d’automatisation Voir les signaux d’automatisation publiés par un compte. | bot_signals | 60 secondes | 3 unité(s) |
| Trouver un DID Le DID derrière n’importe quel handle Bluesky. | find_did | 60 secondes | 1 unité(s) |
| Trouver un handle (DID vers handle) Le handle derrière un DID. | find_handle | 60 secondes | 1 unité(s) |
| Whois Bluesky Tout ce qui est public sur un handle ou un DID. | whois_lookup | 60 secondes | 3 unité(s) |
| Âge d’un compte Voyez quand un compte a rejoint Bluesky. | check_account_age | 60 secondes | 1 unité(s) |
| Convertisseur d’AT URI D’un lien bsky.app à une URI at://, et retour. | convert_at_uri | 60 secondes | 1 unité(s) |
| Décodeur de TID Lisez la date cachée dans une clé d’enregistrement. | decode_tid | 1 an | 1 unité(s) |
| Compteur de caractères Comptez votre post comme Bluesky le compte. | count_post_characters | 1 an | 1 unité(s) |
| Générateur de facettes de texte enrichi Mentions, liens et hashtags avec leurs positions en octets. | build_post_facets | Sans cache | Selon la requête |
| Vérificateur de handle de domaine Découvrez pourquoi votre handle est invalide, et comment le corriger. | check_custom_handle | Sans cache | 2 unité(s) |
| Vérificateur de disponibilité de handle Votre nom est-il libre sur Bluesky ? | check_handle_availability | Sans cache | 1 unité(s) |
| Historique PLC Chaque changement de handle, de serveur et de clé d’un compte. | plc_history | 5 minutes | 2 unité(s) |
| Analyseur de starter packs Qui est dans un starter pack, avec les chiffres et les bots. | analyse_starter_pack | 5 minutes | Selon la requête |
| Lecteur de posts et de fils Lisez n’importe quel post ou fil Bluesky public, sans compte. | view_bluesky_post | 60 secondes | 3 unité(s) |
| Inspecteur de flux Prévisualisez un flux personnalisé et découvrez pourquoi il n’affiche rien. | inspect_bluesky_feed | Sans cache | 3 unité(s) |
| Inspecteur de labels Identifiez l’auteur d’un label et sa signification. | inspect_bluesky_labels | 5 minutes | Selon la requête |
| Export des abonnés Sauvegardez une liste publique d’abonnés ou d’abonnements en CSV. | preview_bluesky_follows | 5 minutes | 2 unité(s) |
| Explorateur de dépôt Parcourez les données publiques d’un compte sur son serveur. | explore_atproto_repo | 5 minutes | 2 unité(s) |
| Nom MCP | Outil | Authentification | Fonctions |
|---|---|---|---|
| check_handle | Vérifier la disponibilité d’un handle Bluesky.bot | Public | Lecture seule |
| resolve_handle | Résoudre un handle Bluesky.bot réservé | Public | Lecture seule |
| search_bots | Rechercher dans l’annuaire public des bots | Public | Lecture seule |
| get_bot | Lire les détails d’un bot public | Public | Lecture seule |
| search_docs | Rechercher dans la documentation développeur | Public | Lecture seule |
| read_doc | Lire une page de documentation en Markdown | Public | Lecture seule |
| list_my_bots | Lister les bots du titulaire du jeton (permission handles) | Jeton créateur avec la permission requise | Lecture seule |
| get_listing | Lire la fiche d’un bot géré (permission listing) | Jeton créateur avec la permission requise | Lecture seule |
| update_listing | Modifier les champs de fiche d’un bot géré (permission listing) | Jeton créateur avec la permission requise | Modifier sa propre fiche uniquement |
Configurer la connexion
Indiquez à votre client Streamable HTTP le chemin /api/mcp de ce site. Les configurations ci-dessous sont des exemples, pas une affirmation que chaque version de client de bureau a été testée. Les outils publics fonctionnent sans identifiants. La référence d’intégration détaille le protocole et l’authentification.
claude mcp add --transport http bluesky-bot https://bluesky.bot/api/mcp{
"servers": {
"bluesky-bot": {
"type": "http",
"url": "https://bluesky.bot/api/mcp"
}
}
}{
"mcpServers": {
"bluesky-bot": {
"url": "https://bluesky.bot/api/mcp"
}
}
}Dans une version de Claude Desktop compatible avec Streamable HTTP, ajoutez le chemin /api/mcp de ce site comme connecteur distant. Utilisez sa connexion OAuth si votre client en a besoin.
Les formats de configuration varient selon la version du client. Ne placez jamais un mot de passe d’application Bluesky dans ces exemples. Un jeton Bluesky.bot ou une connexion OAuth conserve ses permissions propres.
Trois sessions de protocole enregistrées
Ces sessions réelles ont utilisé le client SDK JavaScript MCP, version 1.32.2, contre notre service. Chacune a initialisé une connexion, listé les outils, appelé un outil public puis fermé la connexion. La question explique l’intention ; le résultat est la réponse de l’outil. Ce sont des tests du protocole, pas des conversations inventées avec un modèle d’IA.
Entrée
{
"question": "Which DID does the official bluesky.bot handle resolve to?",
"method": "tools/call",
"params": {
"name": "find_did",
"arguments": {
"handle": "bluesky.bot"
}
}
}Sortie enregistrée
{
"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": []
}
}
}
}Entrée
{
"question": "Does this short sample fit a Bluesky post?",
"method": "tools/call",
"params": {
"name": "count_post_characters",
"arguments": {
"text": "Hello Bluesky! 👋"
}
}
}Sortie enregistrée
{
"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": []
}
}
}
}Entrée
{
"question": "What timestamp does this example record key encode?",
"method": "tools/call",
"params": {
"name": "decode_tid",
"arguments": {
"tid": "3l6oveex3ii2l"
}
}
}Sortie enregistrée
{
"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
}
}
}
}Choisir un serveur adapté
Nos outils publics servent à vérifier l’identité et les détails du protocole sans identifiants de compte. Si votre agent doit publier, un serveur doté de permissions d’écriture explicites peut mieux convenir. Gardez le mot de passe d’application secret, vérifiez les outils autorisés et conservez une confirmation humaine pour les changements importants. Une annotation de lecture seule ne rend pas fiables les instructions d’un texte externe.
Les faits ci-dessous ont été vérifiés dans les README liés le 15 novembre 2026. Nous n’avons ni exécuté ces autres serveurs ni audité leur sécurité. Leurs fonctions et leurs exigences peuvent évoluer.
| Serveur | Transport | Authentification | Fonctions | Licence | Dernier commit | Utile pour | README vérifié |
|---|---|---|---|---|---|---|---|
| brianellin/bsky-mcp-server | stdio local | Mot de passe d’application Bluesky | Lecture et écriture | MIT | Fil personnel et publications du compte | ||
| Ravishka17/Bluesky-MCP | Streamable HTTP | Lectures publiques ; mot de passe dans les en-têtes pour écrire | Lecture et écriture | Unlicense | Client HTTP auto-hébergé avec outils d’écriture | ||
| cameronrye/atproto-mcp | stdio ; HTTP facultatif | Lectures publiques ; identifiants pour les données privées et l’écriture | Lecture et écriture | MIT | Outils de compte pour le protocole AT |
Limites et usage raisonnable
Anonyme : 60 unités de quota par 60 secondes et 2000 par 24 heures. Un jeton créateur valide multiplie ces deux limites par 10 si son propriétaire possède au moins un bot actif.
Un appel consomme le poids de l’outil dans les deux quotas. Les recherches serveur partagent aussi un budget externe ; une vérification complexe peut être refusée avant l’épuisement de votre quota.
MCP autorise séparément 120 requêtes par 60 secondes pour les clients anonymes ; les jetons créateurs éligibles augmentent aussi cette limite. La découverte et la liste des outils comptent même sans appel d’un outil.
Un échec d’outil MCP renvoie isError: true dans le résultat. Les contrôles du transport peuvent renvoyer une erreur HTTP ; un refus de quota inclut Retry-After. La référence du protocole détaille les erreurs JSON-RPC.
Nous comptons l’outil et le canal, pas votre saisie. Les paramètres de recherche des outils sont exclus des journaux d’accès. N’envoyez ni secret, ni publication privée, ni identifiants d’une autre personne.
Le service est gratuit et fourni au mieux, sans garantie contractuelle de disponibilité. Réutilisez les résultats mis en cache, respectez les délais et contactez-nous pour un autre usage.
Une autre possibilité en HTTP
Sans besoin de MCP, utilisez l’API gratuite des outils. Les mêmes définitions fournissent les schémas et les réponses. Cette page ne prétend ni à une inscription dans un annuaire MCP, ni à une garantie de disponibilité, ni à un audit de sécurité indépendant, ni au test des déploiements tiers.
Vous préférez le terminal ? Comparez les clients Bluesky en ligne de commande, avec la version publiée de bsbot et ses limites actuelles.
Questions
Faut-il mon mot de passe Bluesky ?
Non. Les outils publics n’ont besoin d’aucun mot de passe ni jeton. Les jetons Bluesky.bot et les connexions OAuth facultatifs ont leurs permissions propres.
Peut-il publier, suivre ou supprimer des publications ?
Les outils publics ne le peuvent pas. Les outils de fiche modifient seulement les informations de l’annuaire du créateur avec permission explicite ; ils ne gèrent pas les handles Bluesky.
Quel transport utilise-t-il ?
Streamable HTTP à /api/mcp. Utilisez un client compatible ; sa syntaxe de configuration dépend de sa version.
Existe-t-il plutôt une API HTTP ?
Oui. L’API à /api/v1/tools expose les mêmes définitions d’outils publics.