API Províncias de Angola
Servidor MCP
Visão geral
Além da API REST, os mesmos dados podem ser consultados por assistentes de IA através de um servidor MCP (Model Context Protocol), um protocolo aberto que permite que clientes de IA, como o Claude, usem as ferramentas de um serviço. Ao se conectar, o assistente descobre sozinho o que o servidor oferece: basta perguntar.
O servidor dá acesso às províncias e às suas capitais, aos municípios, às comunas e aos distritos, e às etnias e línguas de cada província. Ele é somente leitura e não requer autenticação, como a API.
Como conectar
O servidor responde neste endereço:
https://www.angolaprovinciasapi.oamaralsalgado.ao/mcp/angola-provinces
No Claude Code, adicione o servidor com o comando:
claude mcp add --transport http angola-provinces https://www.angolaprovinciasapi.oamaralsalgado.ao/mcp/angola-provinces
Em qualquer outro cliente que suporte servidores MCP por HTTP, basta informar o endereço acima.
Exemplos de perguntas
Com o servidor conectado, você pode fazer perguntas como:
- Quantos municípios e comunas tem a província do Uíge?
- Qual é a capital da província do Bié?
- Quais são as comunas do município de Dande?
- Que etnias existem na província de Luanda?
- Em que províncias se fala Kikongo?
Limites e restrições
O servidor limita as requisições a 60 por minuto, um limite separado do da API REST. Um assistente pode fazer várias chamadas para responder uma única pergunta. Ao atingir o limite, o servidor responde com o código 429 e indica em quantos segundos uma nova requisição pode ser feita.