Análise de Mo Xin | A versão oficial do UniSat MCP chega ao npm: uma configuração e o AI Agent já pode consultar dados on-chain do Bitcoin
Hoje, às 11:49, o UniSat (@unisat_wallet) publicou o servidor MCP @unisat/openapi-mcp no npm, já na primeira versão oficial, a 1.0.0. Um minuto antes, a ferramenta de linha de comando @unisat/openapi-cli também passou da versão 0.1.0, de agosto, para a 1.0.0. Até as 12:30, a conta oficial do UniSat ainda não tinha publicado nenhum anúncio.
A seguir, explico o que o Agent pode consultar, como conectá-lo e quais ações exigem sua aprovação.
🐋 MCP em um minuto
- O MCP é um padrão de interface que permite a assistentes de IA usar ferramentas externas. Claude, Cursor e Codex são compatíveis. Depois de instalar um servidor MCP, o assistente ganha um conjunto de ferramentas que pode chamar diretamente.
- Este servidor do UniSat é executado no seu computador e chama a UniSat Open API em nome do Agent. É possível consultar tanto a mainnet do Bitcoin quanto a mainnet do Fractal.
- Para consultar as inscrições de um endereço ou os detentores de um BRC-20, antes era preciso escrever código para chamar a API. Depois de conectar, basta perguntar ao Agent em português.
🐋 Como conectar
Adicione o seguinte trecho à configuração de MCP de clientes como Claude e Cursor:
{
"mcpServers": {
"unisat-ai-kit": {
"command": "npx",
"args": ["-y", "@unisat/openapi-mcp"],
"env": { "UNISAT_BITCOIN_API_KEY": "sua key" }
}
}
}
- Solicite uma key em developer.unisat.io. Para consultar o Fractal, é preciso solicitar outra e adicioná-la em UNISAT_FRACTAL_API_KEY.
- É necessário ter Node.js instalado no computador, na versão 22.23.4 ou superior (ou uma versão mais recente da série 24 ou 26).
- O primeiro teste sugerido pelo projeto é pedir ao Agent que consulte a altura do bloco mais recente do Bitcoin. Não é necessário informar um endereço nem ter uma carteira.
https://www.npmjs.com/package/@unisat/openapi-mcp
🐋 O que o Agent pode consultar
O servidor disponibiliza apenas 4 ferramentas para o Agent:
1. list_operations: procura endpoints por palavra-chave; não precisa de key.
2. get_operation: mostra os parâmetros exigidos pelo endpoint e se ele é somente leitura.
3. call_api: faz a chamada ao endpoint.
4. get_status: verifica se o serviço e a configuração estão funcionando normalmente.
O Agent primeiro procura, depois consulta os detalhes e, por fim, faz a chamada. Não é preciso instalar skills adicionais. Os endpoints disponíveis vêm da documentação pública da API do UniSat (v2.1.0, atualizada em 10/23): são 308 ao todo, divididos em 18 categorias:
- Blocos, transações, saldo de endereços e UTXOs.
- Inscrições, BRC-20 (detentores, progresso de emissão e histórico), Runes e Alkanes.
- Swap de BRC-20; ordens e negociações nos mercados de coleções de inscrições, BRC-20, Runes, Alkanes e domínios.
- Preços de BTC, FB e CAT20; oferta circulante do Fractal e ranking de detentores.
Por exemplo, os endpoints para responder a perguntas como «Quais BRC-20 este endereço possui?» e «Quem são os 20 maiores detentores de determinado Rune?» estão incluídos.
🐋 Quais ações exigem sua aprovação
- Dos 308 endpoints, 195 são somente de leitura e 113 executam ações: transmissão de transações, criação de inscrições, ordens e compras em mercados, swaps etc.
- Se o Agent chamar qualquer um desses 113 sem o parâmetro de confirmação, a solicitação será rejeitada com a mensagem «é necessária autorização do usuário». A documentação da ferramenta especifica que o Agent só pode incluir o parâmetro de confirmação depois que o usuário aprovar explicitamente aquela ação.
- O pacote não acessa chaves privadas. Para ações como criar ordens ou comprar, os endpoints retornam uma transação pendente de assinatura. Você ainda precisa assiná-la na carteira antes de enviá-la.
- Mesmo as consultas somente de leitura exigem uma key, e a cota é contabilizada por key. O call_api também permite consultar a cota restante da key atual.
🐋 Antes deste lançamento
- 8/18: CLI 0.1.0 publicado no npm.
- 10/23: a documentação para desenvolvedores ganhou primeiro uma página «OpenAPI CLI & MCP», com a configuração npx pronta. Naquele momento, ainda não era possível encontrar o pacote no npm. No mesmo dia, o repositório recebeu um commit com a mensagem «preparação do lançamento v0.1.5».
- 10/30, 11:47: primeiro foi publicada uma versão de teste; às 11:48, CLI 1.0.0; às 11:49, MCP 1.0.0. A versão 0.1.5 foi pulada.
——
Este artigo foi publicado originalmente no X: @musinoot
Hoje, às 11:49, o UniSat (@unisat_wallet) publicou o servidor MCP @unisat/openapi-mcp no npm, já na primeira versão oficial, a 1.0.0. Um minuto antes, a ferramenta de linha de comando @unisat/openapi-cli também passou da versão 0.1.0, de agosto, para a 1.0.0. Até as 12:30, a conta oficial do UniSat ainda não tinha publicado nenhum anúncio.
A seguir, explico o que o Agent pode consultar, como conectá-lo e quais ações exigem sua aprovação.
🐋 MCP em um minuto
- O MCP é um padrão de interface que permite a assistentes de IA usar ferramentas externas. Claude, Cursor e Codex são compatíveis. Depois de instalar um servidor MCP, o assistente ganha um conjunto de ferramentas que pode chamar diretamente.
- Este servidor do UniSat é executado no seu computador e chama a UniSat Open API em nome do Agent. É possível consultar tanto a mainnet do Bitcoin quanto a mainnet do Fractal.
- Para consultar as inscrições de um endereço ou os detentores de um BRC-20, antes era preciso escrever código para chamar a API. Depois de conectar, basta perguntar ao Agent em português.
🐋 Como conectar
Adicione o seguinte trecho à configuração de MCP de clientes como Claude e Cursor:
{
"mcpServers": {
"unisat-ai-kit": {
"command": "npx",
"args": ["-y", "@unisat/openapi-mcp"],
"env": { "UNISAT_BITCOIN_API_KEY": "sua key" }
}
}
}
- Solicite uma key em developer.unisat.io. Para consultar o Fractal, é preciso solicitar outra e adicioná-la em UNISAT_FRACTAL_API_KEY.
- É necessário ter Node.js instalado no computador, na versão 22.23.4 ou superior (ou uma versão mais recente da série 24 ou 26).
- O primeiro teste sugerido pelo projeto é pedir ao Agent que consulte a altura do bloco mais recente do Bitcoin. Não é necessário informar um endereço nem ter uma carteira.
https://www.npmjs.com/package/@unisat/openapi-mcp
🐋 O que o Agent pode consultar
O servidor disponibiliza apenas 4 ferramentas para o Agent:
1. list_operations: procura endpoints por palavra-chave; não precisa de key.
2. get_operation: mostra os parâmetros exigidos pelo endpoint e se ele é somente leitura.
3. call_api: faz a chamada ao endpoint.
4. get_status: verifica se o serviço e a configuração estão funcionando normalmente.
O Agent primeiro procura, depois consulta os detalhes e, por fim, faz a chamada. Não é preciso instalar skills adicionais. Os endpoints disponíveis vêm da documentação pública da API do UniSat (v2.1.0, atualizada em 10/23): são 308 ao todo, divididos em 18 categorias:
- Blocos, transações, saldo de endereços e UTXOs.
- Inscrições, BRC-20 (detentores, progresso de emissão e histórico), Runes e Alkanes.
- Swap de BRC-20; ordens e negociações nos mercados de coleções de inscrições, BRC-20, Runes, Alkanes e domínios.
- Preços de BTC, FB e CAT20; oferta circulante do Fractal e ranking de detentores.
Por exemplo, os endpoints para responder a perguntas como «Quais BRC-20 este endereço possui?» e «Quem são os 20 maiores detentores de determinado Rune?» estão incluídos.
🐋 Quais ações exigem sua aprovação
- Dos 308 endpoints, 195 são somente de leitura e 113 executam ações: transmissão de transações, criação de inscrições, ordens e compras em mercados, swaps etc.
- Se o Agent chamar qualquer um desses 113 sem o parâmetro de confirmação, a solicitação será rejeitada com a mensagem «é necessária autorização do usuário». A documentação da ferramenta especifica que o Agent só pode incluir o parâmetro de confirmação depois que o usuário aprovar explicitamente aquela ação.
- O pacote não acessa chaves privadas. Para ações como criar ordens ou comprar, os endpoints retornam uma transação pendente de assinatura. Você ainda precisa assiná-la na carteira antes de enviá-la.
- Mesmo as consultas somente de leitura exigem uma key, e a cota é contabilizada por key. O call_api também permite consultar a cota restante da key atual.
🐋 Antes deste lançamento
- 8/18: CLI 0.1.0 publicado no npm.
- 10/23: a documentação para desenvolvedores ganhou primeiro uma página «OpenAPI CLI & MCP», com a configuração npx pronta. Naquele momento, ainda não era possível encontrar o pacote no npm. No mesmo dia, o repositório recebeu um commit com a mensagem «preparação do lançamento v0.1.5».
- 10/30, 11:47: primeiro foi publicada uma versão de teste; às 11:48, CLI 1.0.0; às 11:49, MCP 1.0.0. A versão 0.1.5 foi pulada.
——
Este artigo foi publicado originalmente no X: @musinoot
