Packetrove

Conectar o Packetrove a um agente de IA

Conecte um cliente MCP compatível para calcular CIDRs de cobertura ou consultar a conexão usada por esse cliente. Configure o cliente abaixo e use os exemplos das ferramentas.

Streamable HTTP · Sem conta nem chave de API

https://api.packetrove.com/mcp

Conectar seu cliente

Com o Claude Code ou o Codex instalado, adicione este servidor remoto. Os comandos configuram o cliente; eles não instalam um servidor Packetrove local.

Claude Code

claude mcp add --transport http --scope user packetrove \
  https://api.packetrove.com/mcp
Documentação MCP do Claude Code

Codex

codex mcp add packetrove \
  --url https://api.packetrove.com/mcp
Documentação MCP do Codex

Use /mcp no cliente para consultar a conexão. Confirme que smallest_covering_cidr e public-ip estão disponíveis.

Após a configuração, o cliente descobre as ferramentas com tools/list. As descrições e os esquemas orientam a escolha e os argumentos. Ler uma página web não configura um cliente nem dá acesso às ferramentas.

Usar esta calculadora via MCP

Peça a um agente de IA que calcule um único CIDR para um grupo escolhido de entradas permitidas ou bloqueadas pelo firewall e explique a cobertura adicional.

Nome da ferramenta: smallest_covering_cidr

Endereço do servidor: https://api.packetrove.com/mcp

Streamable HTTP · Sem conta nem chave de API

Aceita de 1 a 1.000 endereços IPv4 ou IPv6 ou intervalos CIDR, com até 64 caracteres por entrada. Use uma só família por chamada.

Exemplo de argumentos

{
  "inputs": [
    "203.0.113.1",
    "203.0.113.2",
    "203.0.113.6"
  ]
}

Exemplo de resultado com endereços de documentação

{
  "family": "ipv4",
  "normalizedInputs": [
    "203.0.113.1/32",
    "203.0.113.2/32",
    "203.0.113.6/32"
  ],
  "cidr": "203.0.113.0/29",
  "range": {
    "first": "203.0.113.0",
    "last": "203.0.113.7"
  },
  "inputAddressCount": "3",
  "coveredAddressCount": "8",
  "additionalAddressCount": "5"
}

Consulte cidr e range para conhecer a rede coberta. Confira additionalAddressCount antes de usar o resultado nas regras do firewall. Todas as contagens são strings decimais para manter a precisão do IPv6.

Chamadas MCP remotas enviam suas entradas ao servidor. A calculadora web funciona localmente. Esta ferramenta calcula um único CIDR; escolher várias combinações para respeitar o limite de uma lista inteira exige definir outro objetivo. Ela não altera regras do firewall.

Abrir a calculadora no navegador

Consultar uma conexão via MCP

Peça a um agente de IA que consulte o IP público observado para a conexão que faz sua chamada MCP.

Nome da ferramenta: public-ip

Endereço do servidor: https://api.packetrove.com/mcp

Streamable HTTP · Sem conta nem chave de API

Passe um objeto vazio, {}. A ferramenta observa a conexão da requisição; ela não aceita um endereço IP para consultar.

Exemplo de argumentos

{}

Exemplo de resultado com endereços de documentação

{
  "ip": "203.0.113.1",
  "family": "ipv4"
}

O exemplo usa um endereço reservado para documentação. Uma chamada real retorna ip e family, com ipv4 ou ipv6, observados para essa requisição.

Um cliente de IA hospedado pode retornar seu próprio endereço de saída. Use esta ferramenta web para consultar a conexão do navegador ou a CLI no seu computador para a conexão do terminal. Uma chamada não descobre as duas famílias, endereços locais privados nem um endereço anterior ao proxy. O resultado não é uma prova de identidade.

Consultar o IP público do meu navegador

Ler resultados e tratar erros

Leia structuredContent ou o JSON do bloco de texto. Mantenha as contagens como strings decimais ou inteiros de precisão arbitrária; converter grandes contagens IPv6 em números de ponto flutuante perde precisão.

Se isError for true, leia o JSON do erro antes de tentar novamente. Corrija INVALID_INPUT e MIXED_ADDRESS_FAMILIES com as informações do usuário. CLIENT_IP_UNAVAILABLE indica que faltam metadados confiáveis da conexão; não invente um endereço.

Ler o guia técnico MCP do repositório (em inglês)