Um servidor MCP para Bluesky e AT Protocol
Dê ao seu cliente MCP ferramentas públicas do Bluesky e do protocolo AT sem lhe entregar a palavra-passe de uma conta.
Por A equipa do Bluesky.bot
- Publicado:
- Atualizado:
- Revisto:
O que o seu cliente pode fazer
As ferramentas públicas resolvem identificadores e DID, inspecionam dados públicos e efetuam cálculos. Este ponto de acesso MCP não aceita palavras-passe de aplicação do Bluesky. Um token de criador ou uma ligação OAuth MCP pode aumentar as quotas públicas. As ferramentas de fichas exigem uma permissão própria e não podem reservar nem libertar identificadores.
| Ferramenta | Nome MCP | Cache HTTP | Custo na quota |
|---|---|---|---|
| Verificador de declarações de automatização Consulte os sinais públicos de automatização de uma conta. | bot_signals | 60 segundos | 3 unidade(s) |
| Localizador de DID O DID por trás de qualquer handle do Bluesky. | find_did | 60 segundos | 1 unidade(s) |
| Localizador de handle (de DID para handle) O handle por trás de um DID. | find_handle | 60 segundos | 1 unidade(s) |
| Whois do Bluesky Tudo o que é público sobre um handle ou um DID. | whois_lookup | 60 segundos | 3 unidade(s) |
| Idade de uma conta Veja quando uma conta chegou ao Bluesky. | check_account_age | 60 segundos | 1 unidade(s) |
| Conversor de AT URI De uma ligação bsky.app para um URI at://, e de volta. | convert_at_uri | 60 segundos | 1 unidade(s) |
| Descodificador de TID Leia a data escondida numa chave de registo. | decode_tid | 1 ano | 1 unidade(s) |
| Contador de caracteres Conte a sua publicação como o Bluesky a conta. | count_post_characters | 1 ano | 1 unidade(s) |
| Gerador de facetas de texto rico Menções, ligações e hashtags com as posições em bytes. | build_post_facets | Sem cache | Consoante o pedido |
| Verificador de handles de domínio próprio Descubra porque é que o seu handle é inválido e como o corrigir. | check_custom_handle | Sem cache | 2 unidade(s) |
| Verificador de disponibilidade de handles O seu nome está livre no Bluesky? | check_handle_availability | Sem cache | 1 unidade(s) |
| Histórico PLC Cada mudança de handle, de servidor e de chave de uma conta. | plc_history | 5 minutos | 2 unidade(s) |
| Analisador de starter packs Quem está num starter pack, com números e bots. | analyse_starter_pack | 5 minutos | Consoante o pedido |
| Leitor de publicações e fios Leia qualquer publicação ou fio público do Bluesky, sem conta. | view_bluesky_post | 60 segundos | 3 unidade(s) |
| Inspetor de feeds Pré-visualize um feed personalizado e descubra porque não mostra nada. | inspect_bluesky_feed | Sem cache | 3 unidade(s) |
| Inspetor de etiquetas Saiba quem aplicou uma etiqueta e o que significa. | inspect_bluesky_labels | 5 minutos | Consoante o pedido |
| Exportação de seguidores Guarde uma lista pública de seguidores ou seguidos em CSV. | preview_bluesky_follows | 5 minutos | 2 unidade(s) |
| Explorador de repositórios Consulte os dados públicos de uma conta no o seu servidor. | explore_atproto_repo | 5 minutos | 2 unidade(s) |
| Nome MCP | Ferramenta | Autenticação | Funcionalidades |
|---|---|---|---|
| check_handle | Verificar se um identificador Bluesky.bot está disponível | Público | Só leitura |
| resolve_handle | Resolver um identificador Bluesky.bot reservado | Público | Só leitura |
| search_bots | Pesquisar no diretório público de bots | Público | Só leitura |
| get_bot | Ler os detalhes de um bot público | Público | Só leitura |
| search_docs | Pesquisar na documentação para programadores | Público | Só leitura |
| read_doc | Ler uma página de documentação em Markdown | Público | Só leitura |
| list_my_bots | Listar os bots do titular do token (permissão handles) | Token de criador com a permissão necessária | Só leitura |
| get_listing | Ler a ficha de um bot próprio (permissão listing) | Token de criador com a permissão necessária | Só leitura |
| update_listing | Alterar campos da ficha de um bot próprio (permissão listing) | Token de criador com a permissão necessária | Apenas alterar a própria ficha |
Configurar a ligação
Aponte um cliente Streamable HTTP para /api/mcp neste sítio. Estas configurações são exemplos, não uma afirmação de que cada versão de cliente de computador foi testada. As ferramentas públicas não precisam de credenciais. A referência de integração explica o protocolo e a autenticação.
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"
}
}
}Numa versão do Claude Desktop compatível com Streamable HTTP, adicione a URL /api/mcp deste sítio como conector remoto. Use a ligação OAuth se o seu cliente precisar dela.
O formato depende da versão do cliente. Nunca coloque uma palavra-passe de aplicação Bluesky nestes exemplos. Um token Bluesky.bot ou uma ligação OAuth mantém as suas permissões próprias.
Três sessões de protocolo gravadas
Estas sessões reais usaram o cliente SDK JavaScript MCP, versão 1.32.2, contra o nosso serviço. Cada uma iniciou uma ligação, listou ferramentas, chamou uma ferramenta pública e fechou a ligação. A pergunta explica a intenção; o resultado é a resposta da ferramenta. São testes do protocolo, não conversas inventadas com um 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"
}
}
}Saída 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! 👋"
}
}
}Saída 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"
}
}
}Saída 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
}
}
}
}Escolher um servidor adequado
As nossas ferramentas públicas verificam identidade e detalhes do protocolo sem credenciais de conta. Se o seu agente precisar de publicar, poderá ser preferível um servidor com permissões de escrita explícitas. Mantenha a palavra-passe de aplicação secreta, reveja as ferramentas autorizadas e exija confirmação humana para alterações importantes. A anotação de só leitura não torna fiáveis as instruções de texto externo.
Estes dados foram verificados nos README indicados em 15 de novembro de 2026. Não executámos esses servidores nem auditámos a sua segurança. As funcionalidades e os requisitos podem mudar.
| Servidor | Transporte | Autenticação | Funcionalidades | Licença | Último commit | Útil para | README verificado |
|---|---|---|---|---|---|---|---|
| brianellin/bsky-mcp-server | stdio local | Palavra-passe de aplicação Bluesky | Leitura e escrita | MIT | Cronologia pessoal e publicações da conta | ||
| Ravishka17/Bluesky-MCP | Streamable HTTP | Leituras públicas; palavra-passe nos cabeçalhos para escrever | Leitura e escrita | Unlicense | Cliente HTTP autoalojado com escrita | ||
| cameronrye/atproto-mcp | stdio; HTTP opcional | Leituras públicas; credenciais para dados privados e escrita | Leitura e escrita | MIT | Ferramentas de conta do protocolo AT |
Limites e utilização responsável
Anónimo: 60 unidades por 60 segundos e 2000 por 24 horas. Um token de criador válido multiplica ambos os limites por 10 se o proprietário tiver pelo menos um bot ativo.
Cada chamada consome o peso da ferramenta nas duas quotas. As consultas do servidor partilham também um orçamento externo; uma verificação complexa pode ser recusada antes de esgotar a sua quota.
O MCP permite separadamente 120 pedidos por 60 segundos a clientes anónimos; os tokens de criadores elegíveis também aumentam esse limite. A descoberta e a lista de ferramentas contam mesmo sem chamar uma ferramenta.
As falhas de ferramentas MCP devolvem isError: true no resultado. As verificações do transporte podem devolver um erro HTTP; as recusas por quota incluem Retry-After. A referência do protocolo descreve os erros JSON-RPC.
Contamos a ferramenta e o canal, não a sua entrada. As consultas das ferramentas ficam fora dos registos de acesso. Não envie segredos, publicações privadas ou credenciais de terceiros.
O serviço é gratuito e disponibilizado sem SLA de disponibilidade. Reutilize resultados em cache, respeite os intervalos e contacte-nos para outras utilizações.
Uma alternativa HTTP
Se não precisa de MCP, use a API gratuita de ferramentas. As mesmas definições fornecem os esquemas e as respostas. Esta página não implica registo em diretórios MCP, garantia de disponibilidade, auditoria de segurança independente nem testes dos serviços de terceiros.
Prefere o terminal? Compare os clientes Bluesky de linha de comandos, incluindo a versão publicada do bsbot e os seus limites atuais.
Perguntas
Precisa da minha palavra-passe do Bluesky?
Não. As ferramentas públicas não precisam de palavra-passe nem token. Os tokens Bluesky.bot e as ligações OAuth opcionais têm permissões próprias.
Pode publicar, seguir ou eliminar publicações?
As ferramentas públicas não podem. As ferramentas de fichas alteram apenas informação do diretório do próprio criador com permissão explícita; não gerem identificadores Bluesky.
Que transporte utiliza?
Streamable HTTP em /api/mcp. Use um cliente compatível; a configuração depende da versão.
Existe uma API HTTP alternativa?
Sim. A API em /api/v1/tools expõe as mesmas definições de ferramentas públicas.