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.

Herramientas MCP públicas
HerramientaNombre MCPCaché HTTPCoste en la cuota
Comprobador de declaraciones de automatización

Consulta las señales de automatización públicas de una cuenta.

bot_signals60 segundos3 unidad(es)
Buscador de DID

El DID detrás de cualquier handle de Bluesky.

find_did60 segundos1 unidad(es)
Buscador de handle (de DID a handle)

El handle detrás de un DID.

find_handle60 segundos1 unidad(es)
Whois de Bluesky

Todo lo público sobre un handle o un DID.

whois_lookup60 segundos3 unidad(es)
Edad de una cuenta

Mira cuándo se unió una cuenta a Bluesky.

check_account_age60 segundos1 unidad(es)
Conversor de AT URI

De un enlace de bsky.app a una URI at://, y al revés.

convert_at_uri60 segundos1 unidad(es)
Decodificador de TID

Lee la fecha oculta en una clave de registro.

decode_tid1 año1 unidad(es)
Contador de caracteres

Cuenta tu post como lo cuenta Bluesky.

count_post_characters1 año1 unidad(es)
Generador de facetas de texto enriquecido

Menciones, enlaces y hashtags con sus posiciones en bytes.

build_post_facetsSin 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_handleSin caché2 unidad(es)
Verificador de disponibilidad de handles

¿Tu nombre está libre en Bluesky?

check_handle_availabilitySin caché1 unidad(es)
Historial PLC

Cada cambio de handle, de servidor y de clave de una cuenta.

plc_history5 minutos2 unidad(es)
Analizador de starter packs

Quién está en un starter pack, con cifras y bots.

analyse_starter_pack5 minutosSegún la solicitud
Visor de publicaciones e hilos

Lee cualquier publicación o hilo público de Bluesky, sin cuenta.

view_bluesky_post60 segundos3 unidad(es)
Inspector de feeds

Previsualiza un feed personalizado y descubre por qué no muestra nada.

inspect_bluesky_feedSin caché3 unidad(es)
Inspector de etiquetas

Descubre quién aplicó una etiqueta y qué significa.

inspect_bluesky_labels5 minutosSegún la solicitud
Exportación de seguidores

Guarda una lista pública de seguidores o seguidos en CSV.

preview_bluesky_follows5 minutos2 unidad(es)
Explorador de repositorios

Consulta los datos públicos de una cuenta en su servidor.

explore_atproto_repo5 minutos2 unidad(es)
Otras herramientas MCP
Nombre MCPHerramientaAutenticaciónFunciones
check_handleComprobar si un handle Bluesky.bot está disponiblePúblicoSolo lectura
resolve_handleResolver un handle Bluesky.bot reservadoPúblicoSolo lectura
search_botsBuscar en el directorio público de botsPúblicoSolo lectura
get_botLeer los detalles de un bot públicoPúblicoSolo lectura
search_docsBuscar en la documentación para desarrolladoresPúblicoSolo lectura
read_docLeer una página de documentación en MarkdownPúblicoSolo lectura
list_my_botsListar los bots del titular del token (permiso handles)Token de creador con el permiso necesarioSolo lectura
get_listingLeer la ficha de un bot propio (permiso listing)Token de creador con el permiso necesarioSolo lectura
update_listingModificar campos de la ficha de un bot propio (permiso listing)Token de creador con el permiso necesarioSolo 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 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"
    }
  }
}

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.

Capturado el

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": []
      }
    }
  }
}
Capturado el

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": []
      }
    }
  }
}
Capturado el

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.

ServidorTransporteAutenticaciónFuncionesLicenciaÚltimo commitÚtil paraREADME comprobado
brianellin/bsky-mcp-serverstdio localContraseña de aplicación BlueskyLectura y escrituraMITCronología personal y publicaciones de la cuenta
Ravishka17/Bluesky-MCPStreamable HTTPLecturas públicas; contraseña en cabeceras para escribirLectura y escrituraUnlicenseCliente HTTP autoalojado con escritura
cameronrye/atproto-mcpstdio; HTTP opcionalLecturas públicas; credenciales para datos privados y escrituraLectura y escrituraMITHerramientas 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.

Fuentes