Un servidor MCP para Bluesky y AT Protocol
Da a tu cliente MCP herramientas públicas de Bluesky y AT Protocol sin entregarle la contraseña de una cuenta.
Por El equipo de Bluesky.bot
- Publicado:
- Actualizado:
- Revisado:
Qué puede hacer tu cliente
Las herramientas públicas resuelven handles y DID, inspeccionan datos públicos y hacen cálculos. Este endpoint MCP no acepta contraseñas de aplicación de Bluesky. Un token de creador o una conexión OAuth MCP puede aumentar las cuotas públicas. Las herramientas de fichas necesitan su permiso específico y no pueden reservar ni liberar handles.
| Herramienta | Nombre MCP | Caché HTTP | Coste en la cuota |
|---|---|---|---|
| Comprobador de declaraciones de automatización Consulta las señales de automatización públicas de una cuenta. | bot_signals | 60 segundos | 3 unidad(es) |
| Buscador de DID El DID detrás de cualquier handle de Bluesky. | find_did | 60 segundos | 1 unidad(es) |
| Buscador de handle (de DID a handle) El handle detrás de un DID. | find_handle | 60 segundos | 1 unidad(es) |
| Whois de Bluesky Todo lo público sobre un handle o un DID. | whois_lookup | 60 segundos | 3 unidad(es) |
| Edad de una cuenta Mira cuándo se unió una cuenta a Bluesky. | check_account_age | 60 segundos | 1 unidad(es) |
| Conversor de AT URI De un enlace de bsky.app a una URI at://, y al revés. | convert_at_uri | 60 segundos | 1 unidad(es) |
| Decodificador de TID Lee la fecha oculta en una clave de registro. | decode_tid | 1 año | 1 unidad(es) |
| Contador de caracteres Cuenta tu post como lo cuenta Bluesky. | count_post_characters | 1 año | 1 unidad(es) |
| Generador de facetas de texto enriquecido Menciones, enlaces y hashtags con sus posiciones en bytes. | build_post_facets | Sin caché | Según la solicitud |
| Verificador de handles con dominio propio Descubre por qué tu handle no es válido y cómo arreglarlo. | check_custom_handle | Sin caché | 2 unidad(es) |
| Verificador de disponibilidad de handles ¿Tu nombre está libre en Bluesky? | check_handle_availability | Sin caché | 1 unidad(es) |
| Historial PLC Cada cambio de handle, de servidor y de clave de una cuenta. | plc_history | 5 minutos | 2 unidad(es) |
| Analizador de starter packs Quién está en un starter pack, con cifras y bots. | analyse_starter_pack | 5 minutos | Según la solicitud |
| Visor de publicaciones e hilos Lee cualquier publicación o hilo público de Bluesky, sin cuenta. | view_bluesky_post | 60 segundos | 3 unidad(es) |
| Inspector de feeds Previsualiza un feed personalizado y descubre por qué no muestra nada. | inspect_bluesky_feed | Sin caché | 3 unidad(es) |
| Inspector de etiquetas Descubre quién aplicó una etiqueta y qué significa. | inspect_bluesky_labels | 5 minutos | Según la solicitud |
| Exportación de seguidores Guarda una lista pública de seguidores o seguidos en CSV. | preview_bluesky_follows | 5 minutos | 2 unidad(es) |
| Explorador de repositorios Consulta los datos públicos de una cuenta en su servidor. | explore_atproto_repo | 5 minutos | 2 unidad(es) |
| Nombre MCP | Herramienta | Autenticación | Funciones |
|---|---|---|---|
| check_handle | Comprobar si un handle Bluesky.bot está disponible | Público | Solo lectura |
| resolve_handle | Resolver un handle Bluesky.bot reservado | Público | Solo lectura |
| search_bots | Buscar en el directorio público de bots | Público | Solo lectura |
| get_bot | Leer los detalles de un bot público | Público | Solo lectura |
| search_docs | Buscar en la documentación para desarrolladores | Público | Solo lectura |
| read_doc | Leer una página de documentación en Markdown | Público | Solo lectura |
| list_my_bots | Listar los bots del titular del token (permiso handles) | Token de creador con el permiso necesario | Solo lectura |
| get_listing | Leer la ficha de un bot propio (permiso listing) | Token de creador con el permiso necesario | Solo lectura |
| update_listing | Modificar campos de la ficha de un bot propio (permiso listing) | Token de creador con el permiso necesario | Solo editar la ficha propia |
Configurar la conexión
Apunta un cliente Streamable HTTP a /api/mcp en este sitio. Estas configuraciones son ejemplos, no una afirmación de haber probado cada versión de cliente de escritorio. Las herramientas públicas no necesitan credenciales. La referencia de integración explica el protocolo y la autenticación.
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"
}
}
}En una versión de Claude Desktop compatible con Streamable HTTP, añade la URL /api/mcp de este sitio como conector remoto. Usa su conexión OAuth si tu cliente la necesita.
El formato depende de la versión del cliente. Nunca pongas una contraseña de aplicación Bluesky en estos ejemplos. Un token de Bluesky.bot o una conexión OAuth conserva sus propios permisos.
Tres sesiones de protocolo grabadas
Estas sesiones reales utilizaron el cliente SDK JavaScript MCP, versión 1.32.2, contra nuestro servicio. Cada una inicializó una conexión, enumeró herramientas, llamó a una herramienta pública y cerró la conexión. La pregunta explica la intención; el resultado es la respuesta de la herramienta. Son pruebas del protocolo, no conversaciones inventadas con un modelo de IA.
Entrada
{
"question": "Which DID does the official bluesky.bot handle resolve to?",
"method": "tools/call",
"params": {
"name": "find_did",
"arguments": {
"handle": "bluesky.bot"
}
}
}Salida capturada
{
"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": []
}
}
}
}Entrada
{
"question": "Does this short sample fit a Bluesky post?",
"method": "tools/call",
"params": {
"name": "count_post_characters",
"arguments": {
"text": "Hello Bluesky! 👋"
}
}
}Salida capturada
{
"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": []
}
}
}
}Entrada
{
"question": "What timestamp does this example record key encode?",
"method": "tools/call",
"params": {
"name": "decode_tid",
"arguments": {
"tid": "3l6oveex3ii2l"
}
}
}Salida capturada
{
"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
}
}
}
}Elegir el servidor adecuado
Nuestras herramientas públicas permiten comprobar identidad y detalles del protocolo sin credenciales de cuenta. Si tu agente necesita publicar, puede convenir un servidor con permisos de escritura explícitos. Mantén secreta la contraseña de aplicación, revisa las herramientas autorizadas y pide confirmación humana para cambios importantes. La anotación de solo lectura no convierte las instrucciones de un texto externo en fiables.
Estos datos se comprobaron en los README enlazados el 15 de noviembre de 2026. No ejecutamos esos servidores ni auditamos su seguridad. Sus funciones y requisitos pueden cambiar.
| Servidor | Transporte | Autenticación | Funciones | Licencia | Último commit | Útil para | README comprobado |
|---|---|---|---|---|---|---|---|
| brianellin/bsky-mcp-server | stdio local | Contraseña de aplicación Bluesky | Lectura y escritura | MIT | Cronología personal y publicaciones de la cuenta | ||
| Ravishka17/Bluesky-MCP | Streamable HTTP | Lecturas públicas; contraseña en cabeceras para escribir | Lectura y escritura | Unlicense | Cliente HTTP autoalojado con escritura | ||
| cameronrye/atproto-mcp | stdio; HTTP opcional | Lecturas públicas; credenciales para datos privados y escritura | Lectura y escritura | MIT | Herramientas de cuenta del protocolo AT |
Límites y uso razonable
Anónimo: 60 unidades por 60 segundos y 2000 por 24 horas. Un token de creador válido multiplica ambos límites por 10 si su propietario tiene al menos un bot activo.
Cada llamada consume el peso de la herramienta en ambas cuotas. Las consultas del servidor también comparten un presupuesto externo; una comprobación compleja puede rechazarse antes de agotar tu cuota.
MCP permite por separado 120 solicitudes por 60 segundos para clientes anónimos; los tokens de creadores elegibles también elevan ese límite. El descubrimiento y la lista de herramientas cuentan aunque no se llame a una herramienta.
Los fallos de herramientas MCP devuelven isError: true en el resultado. Los controles del transporte pueden devolver un error HTTP; los rechazos por cuota incluyen Retry-After. La referencia del protocolo detalla los errores JSON-RPC.
Contamos herramienta y canal, no tu entrada. Las consultas de herramientas se excluyen de los registros de acceso. No envíes secretos, publicaciones privadas ni credenciales ajenas.
El servicio es gratuito y se ofrece sin SLA de disponibilidad. Reutiliza resultados en caché, respeta los retrasos y contacta con nosotros para otros usos.
Una alternativa HTTP
Si no necesitas MCP, usa la API gratuita de herramientas. Las mismas definiciones proporcionan sus esquemas y respuestas. Esta página no implica registro en directorios MCP, garantía de disponibilidad, auditoría de seguridad independiente ni pruebas de los despliegues de terceros.
¿Prefieres el terminal? Compara los clientes de Bluesky por línea de comandos, con la versión publicada de bsbot y sus límites actuales.
Preguntas
¿Necesita mi contraseña de Bluesky?
No. Las herramientas públicas no necesitan contraseña ni token. Los tokens de Bluesky.bot y las conexiones OAuth opcionales tienen permisos propios.
¿Puede publicar, seguir o eliminar publicaciones?
Las herramientas públicas no pueden. Las herramientas de fichas solo modifican información del directorio del propio creador con permiso explícito; no gestionan handles de Bluesky.
¿Qué transporte utiliza?
Streamable HTTP en /api/mcp. Usa un cliente compatible; la configuración depende de su versión.
¿Existe una API HTTP alternativa?
Sí. La API en /api/v1/tools expone las mismas definiciones de herramientas públicas.