Orbit Sentinel

Orbit Sentinel MCP Server

Servidor MCP (Model Context Protocol) para Orbit Sentinel — mais de 950 mil registros regulatórios espaciais da FCC, ITU, UNOOSA e FAA-AST, consultáveis a partir do Claude Desktop, Claude Code, Cursor ou qualquer cliente MCP.

É necessária uma chave de API. Acesso beta: https://console.viventine.com.

O servidor é um cliente leve e de código aberto (MIT) da API REST pública — nove arquivos Go, fáceis de auditar antes de executar. Execute-o localmente via stdio ou pule a instalação e aponte seu cliente para o endpoint remoto hospedado (abaixo).

Instalação

Remoto (sem instalação)

O caminho de menor atrito — sem binário, sem atualizações. Aponte qualquer cliente MCP compatível com HTTP para:

https://orbit-sentinel.viventine.com/mcp

O transporte é Streamable HTTP (sem estado). Duas formas de autenticar:

OAuth (recomendado) — faça login com sua conta Viventine no navegador; sem chave para copiar ou armazenar. No Claude Code:

claude mcp add --transport http orbit-sentinel https://orbit-sentinel.viventine.com/mcp

Em seguida, execute /mcp -> orbit-sentinel -> authenticate. Um navegador abre para login e consentimento; o Claude Code armazena o token e o atualiza automaticamente. O mesmo funciona como conector personalizado no claude.ai / Claude Desktop (Configurações -> Conectores -> Adicionar conector personalizado -> cole a URL -> faça login).

Chave de API — se preferir usar uma chave estática (ou seu cliente não suportar OAuth), passe sua chave do console como bearer token:

claude mcp add --transport http orbit-sentinel \
  https://orbit-sentinel.viventine.com/mcp \
  --header "Authorization: Bearer <your-key>"

Obtenha uma chave / acesso beta em https://console.viventine.com.

Clientes MCP genéricos — qualquer cliente Streamable HTTP funciona via OAuth 2.1 (descoberta de recurso protegido RFC 9728) ou um cabeçalho Authorization: Bearer <key>. Para um cliente somente stdio, faça a ponte com npx mcp-remote https://orbit-sentinel.viventine.com/mcp.

Claude Desktop (um clique)

Baixe orbit-sentinel-mcp.mcpb e clique duas vezes — o Claude Desktop instala a extensão e solicita sua chave de API. Inclui binários para macOS (universal), Linux e Windows.

Homebrew (macOS — recomendado)

brew install --cask viventine-space/tap/orbit-sentinel-mcp

Instala em $(brew --prefix)/bin/orbit-sentinel-mcp, lida com a flag de quarentena para você e atualiza com brew upgrade.

Download manual

Baixe o arquivo para sua plataforma na última versão e então:

tar -xzf orbit-sentinel-mcp_*.tar.gz
mkdir -p ~/bin && mv orbit-sentinel-mcp ~/bin/

Somente macOS — o binário ainda não está notarizado, então limpe a flag de quarentena uma vez:

xattr -d com.apple.quarantine ~/bin/orbit-sentinel-mcp

Windows: descompacte e anote o caminho completo para orbit-sentinel-mcp.exe.

Compilar a partir do código-fonte

go install github.com/viventine-space/orbit-sentinel-mcp@latest

Configuração

O servidor lê duas variáveis de ambiente:

Variável	Finalidade
MCP_API_URL	URL base da API do Orbit Sentinel (https://orbit-sentinel.viventine.com)
MCP_API_KEY	Sua chave de API do console

Claude Desktop — adicione em ~/Library/Application Support/Claude/claude_desktop_config.json (Windows: %APPDATA%\Claude\claude_desktop_config.json), usando o caminho absoluto para o binário (~ não é expandido):

{
  "mcpServers": {
    "orbit-sentinel": {
      "command": "/absolute/path/to/orbit-sentinel-mcp",
      "env": {
        "MCP_API_URL": "https://orbit-sentinel.viventine.com",
        "MCP_API_KEY": "<your-key>"
      }
    }
  }
}

Claude Code — um comando:

claude mcp add orbit-sentinel \
  --env MCP_API_URL=https://orbit-sentinel.viventine.com \
  --env MCP_API_KEY=<your-key> \
  -- ~/bin/orbit-sentinel-mcp

Reinicie seu cliente; as ferramentas do Orbit Sentinel (research, search_filings, get_entity_profile, …) aparecem no menu de ferramentas.

Publicação de versões (mantenedores)

Crie a tag e faça push — o GitHub Actions compila e publica todas as plataformas:

git tag v0.x.y && git push origin v0.x.y

Os nomes dos assets são estáveis por versão (orbit-sentinel-mcp_<os>_<arch>.tar.gz), então as URLs releases/latest/download/... sempre servem a build mais recente.

O pacote do Claude Desktop (orbit-sentinel-mcp.mcpb) é empacotado e enviado pelo fluxo de release — o template do manifesto está em mcpb/manifest.json (seu version é carimbado a partir da tag no momento do empacotamento).

Em seguida, repita a publicação no Glama — ela não é atualizada automaticamente a partir do GitHub e controla a pontuação de qualidade no selo acima. Na página de administração do Dockerfile, a especificação de build salva deve ser mantida (as etapas de build instalam Go e go build; parâmetros de placeholder precisam de um MCP_API_KEY fictício para satisfazer o schema de env) — clique em Build e depois em Make Release com a nova versão. Manual por enquanto; considere a integração com a API do Glama no próximo ciclo de release.