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.

Outils MCP publics
OutilNom MCPCache HTTPCoût dans le quota
Vérificateur de déclarations d’automatisation

Voir les signaux d’automatisation publiés par un compte.

bot_signals60 secondes3 unité(s)
Trouver un DID

Le DID derrière n’importe quel handle Bluesky.

find_did60 secondes1 unité(s)
Trouver un handle (DID vers handle)

Le handle derrière un DID.

find_handle60 secondes1 unité(s)
Whois Bluesky

Tout ce qui est public sur un handle ou un DID.

whois_lookup60 secondes3 unité(s)
Âge d’un compte

Voyez quand un compte a rejoint Bluesky.

check_account_age60 secondes1 unité(s)
Convertisseur d’AT URI

D’un lien bsky.app à une URI at://, et retour.

convert_at_uri60 secondes1 unité(s)
Décodeur de TID

Lisez la date cachée dans une clé d’enregistrement.

decode_tid1 an1 unité(s)
Compteur de caractères

Comptez votre post comme Bluesky le compte.

count_post_characters1 an1 unité(s)
Générateur de facettes de texte enrichi

Mentions, liens et hashtags avec leurs positions en octets.

build_post_facetsSans cacheSelon la requête
Vérificateur de handle de domaine

Découvrez pourquoi votre handle est invalide, et comment le corriger.

check_custom_handleSans cache2 unité(s)
Vérificateur de disponibilité de handle

Votre nom est-il libre sur Bluesky ?

check_handle_availabilitySans cache1 unité(s)
Historique PLC

Chaque changement de handle, de serveur et de clé d’un compte.

plc_history5 minutes2 unité(s)
Analyseur de starter packs

Qui est dans un starter pack, avec les chiffres et les bots.

analyse_starter_pack5 minutesSelon la requête
Lecteur de posts et de fils

Lisez n’importe quel post ou fil Bluesky public, sans compte.

view_bluesky_post60 secondes3 unité(s)
Inspecteur de flux

Prévisualisez un flux personnalisé et découvrez pourquoi il n’affiche rien.

inspect_bluesky_feedSans cache3 unité(s)
Inspecteur de labels

Identifiez l’auteur d’un label et sa signification.

inspect_bluesky_labels5 minutesSelon la requête
Export des abonnés

Sauvegardez une liste publique d’abonnés ou d’abonnements en CSV.

preview_bluesky_follows5 minutes2 unité(s)
Explorateur de dépôt

Parcourez les données publiques d’un compte sur son serveur.

explore_atproto_repo5 minutes2 unité(s)
Autres outils MCP
Nom MCPOutilAuthentificationFonctions
check_handleVérifier la disponibilité d’un handle Bluesky.botPublicLecture seule
resolve_handleRésoudre un handle Bluesky.bot réservéPublicLecture seule
search_botsRechercher dans l’annuaire public des botsPublicLecture seule
get_botLire les détails d’un bot publicPublicLecture seule
search_docsRechercher dans la documentation développeurPublicLecture seule
read_docLire une page de documentation en MarkdownPublicLecture seule
list_my_botsLister les bots du titulaire du jeton (permission handles)Jeton créateur avec la permission requiseLecture seule
get_listingLire la fiche d’un bot géré (permission listing)Jeton créateur avec la permission requiseLecture seule
update_listingModifier les champs de fiche d’un bot géré (permission listing)Jeton créateur avec la permission requiseModifier 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 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"
    }
  }
}

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.

Enregistré le

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": []
      }
    }
  }
}
Enregistré le

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": []
      }
    }
  }
}
Enregistré le

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.

ServeurTransportAuthentificationFonctionsLicenceDernier commitUtile pourREADME vérifié
brianellin/bsky-mcp-serverstdio localMot de passe d’application BlueskyLecture et écritureMITFil personnel et publications du compte
Ravishka17/Bluesky-MCPStreamable HTTPLectures publiques ; mot de passe dans les en-têtes pour écrireLecture et écritureUnlicenseClient HTTP auto-hébergé avec outils d’écriture
cameronrye/atproto-mcpstdio ; HTTP facultatifLectures publiques ; identifiants pour les données privées et l’écritureLecture et écritureMITOutils 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.

Sources