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.

Ferramentas MCP públicas
FerramentaNome MCPCache HTTPCusto na quota
Verificador de declarações de automatização

Consulte os sinais públicos de automatização de uma conta.

bot_signals60 segundos3 unidade(s)
Localizador de DID

O DID por trás de qualquer handle do Bluesky.

find_did60 segundos1 unidade(s)
Localizador de handle (de DID para handle)

O handle por trás de um DID.

find_handle60 segundos1 unidade(s)
Whois do Bluesky

Tudo o que é público sobre um handle ou um DID.

whois_lookup60 segundos3 unidade(s)
Idade de uma conta

Veja quando uma conta chegou ao Bluesky.

check_account_age60 segundos1 unidade(s)
Conversor de AT URI

De uma ligação bsky.app para um URI at://, e de volta.

convert_at_uri60 segundos1 unidade(s)
Descodificador de TID

Leia a data escondida numa chave de registo.

decode_tid1 ano1 unidade(s)
Contador de caracteres

Conte a sua publicação como o Bluesky a conta.

count_post_characters1 ano1 unidade(s)
Gerador de facetas de texto rico

Menções, ligações e hashtags com as posições em bytes.

build_post_facetsSem cacheConsoante o pedido
Verificador de handles de domínio próprio

Descubra porque é que o seu handle é inválido e como o corrigir.

check_custom_handleSem cache2 unidade(s)
Verificador de disponibilidade de handles

O seu nome está livre no Bluesky?

check_handle_availabilitySem cache1 unidade(s)
Histórico PLC

Cada mudança de handle, de servidor e de chave de uma conta.

plc_history5 minutos2 unidade(s)
Analisador de starter packs

Quem está num starter pack, com números e bots.

analyse_starter_pack5 minutosConsoante o pedido
Leitor de publicações e fios

Leia qualquer publicação ou fio público do Bluesky, sem conta.

view_bluesky_post60 segundos3 unidade(s)
Inspetor de feeds

Pré-visualize um feed personalizado e descubra porque não mostra nada.

inspect_bluesky_feedSem cache3 unidade(s)
Inspetor de etiquetas

Saiba quem aplicou uma etiqueta e o que significa.

inspect_bluesky_labels5 minutosConsoante o pedido
Exportação de seguidores

Guarde uma lista pública de seguidores ou seguidos em CSV.

preview_bluesky_follows5 minutos2 unidade(s)
Explorador de repositórios

Consulte os dados públicos de uma conta no o seu servidor.

explore_atproto_repo5 minutos2 unidade(s)
Outras ferramentas MCP
Nome MCPFerramentaAutenticaçãoFuncionalidades
check_handleVerificar se um identificador Bluesky.bot está disponívelPúblicoSó leitura
resolve_handleResolver um identificador Bluesky.bot reservadoPúblicoSó leitura
search_botsPesquisar no diretório público de botsPúblicoSó leitura
get_botLer os detalhes de um bot públicoPúblicoSó leitura
search_docsPesquisar na documentação para programadoresPúblicoSó leitura
read_docLer uma página de documentação em MarkdownPúblicoSó leitura
list_my_botsListar os bots do titular do token (permissão handles)Token de criador com a permissão necessáriaSó leitura
get_listingLer a ficha de um bot próprio (permissão listing)Token de criador com a permissão necessáriaSó leitura
update_listingAlterar campos da ficha de um bot próprio (permissão listing)Token de criador com a permissão necessáriaApenas 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 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"
    }
  }
}

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.

Capturado em

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

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

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.

ServidorTransporteAutenticaçãoFuncionalidadesLicençaÚltimo commitÚtil paraREADME verificado
brianellin/bsky-mcp-serverstdio localPalavra-passe de aplicação BlueskyLeitura e escritaMITCronologia pessoal e publicações da conta
Ravishka17/Bluesky-MCPStreamable HTTPLeituras públicas; palavra-passe nos cabeçalhos para escreverLeitura e escritaUnlicenseCliente HTTP autoalojado com escrita
cameronrye/atproto-mcpstdio; HTTP opcionalLeituras públicas; credenciais para dados privados e escritaLeitura e escritaMITFerramentas 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.

Fontes