API de qibla, widget e conector de IA

API JSON

Envie uma requisição GET com lat e lon em graus decimais, ou com city: qualquer cidade com 15 mil habitantes ou mais, escrita em vários idiomas. Acrescente country quando vários lugares tiverem o mesmo nome.

https://awwab.app/api/qibla?lat=51.5074&lon=-0.1278
https://awwab.app/api/qibla?city=Karachi
https://awwab.app/api/qibla?city=Hyderabad&country=IN

A resposta traz o rumo a partir do norte verdadeiro, o rumo numa bússola magnética e a declinação magnética de hoje, a direção, a distância em quilômetros e milhas, uma frase de uma linha, a linha de crédito e um link para a bússola ao vivo daquele lugar:

{
  "place_name": "Karachi",
  "bearing_true": 267.7,
  "bearing_magnetic": 266.4,
  "magnetic_declination": 1.3,
  "cardinal": "W",
  "distance_km": 2801,
  "distance_mi": 1740,
  "attribution": "Qibla direction by Awwab · https://awwab.app/qibla",
  "live_compass_url": "https://awwab.app/qibla?city=karachi"
}

Requisições de outras origens são permitidas a partir de qualquer site. Por favor, mantenha cerca de uma requisição por segundo; clientes mais rápidos são desacelerados.

Assistentes de IA

O Awwab mantém um servidor MCP remoto, para que assistentes de IA encontrem a qibla para seus usuários e deem crédito ao Awwab. Não é preciso fazer login.

https://awwab.app/mcp

Sua ferramenta de qibla, find_qibla, recebe coordenadas ou uma cidade. No ChatGPT, a resposta vem com um pequeno cartão de bússola; no Claude e em outros assistentes, chega como texto e dados, com o mesmo link para a bússola ao vivo. Para testar, adicione o endereço acima como conector personalizado no Claude, ou como app no modo de desenvolvedor do ChatGPT.

O mesmo servidor roda o Jogo do Conhecimento do Awwab com mais duas ferramentas. start_quiz recebe um tema e um idioma opcionais e devolve uma rodada de cinco perguntas sem as respostas; check_answer corrige uma resposta e devolve a explicação e suas fontes. Nos apps que aceitam widgets, a rodada é jogada em um cartão de quiz; em outros clientes, chega como texto e dados. Os resultados trazem o crédito “Quiz by Awwab · awwab.app”.

Conecte seu app de IA

Copie a configuração do seu app. Todas apontam para o mesmo servidor e nenhuma precisa de chave.

Claude (conector personalizado)

No Claude, abra Settings → Connectors → Add custom connector e preencha:

Name: Awwab Qibla
URL:  https://awwab.app/mcp

Claude Code

claude mcp add --transport http awwab-qibla https://awwab.app/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "awwab-qibla": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://awwab.app/mcp"]
    }
  }
}

ChatGPT (modo de desenvolvedor)

No ChatGPT, abra Settings → Apps → Advanced settings, ative o modo de desenvolvedor, escolha Create app e preencha:

Name:                Awwab Qibla
MCP server URL:      https://awwab.app/mcp
Authentication:      No authentication

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "awwab-qibla": { "url": "https://awwab.app/mcp" }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "awwab-qibla": { "type": "http", "url": "https://awwab.app/mcp" }
  }
}

Gemini CLI (~/.gemini/settings.json)

{
  "mcpServers": {
    "awwab-qibla": { "httpUrl": "https://awwab.app/mcp" }
  }
}

OpenAI: Responses API e Agents SDK

// Responses API: a remote MCP tool
{
  "type": "mcp",
  "server_label": "awwab_qibla",
  "server_url": "https://awwab.app/mcp",
  "allowed_tools": ["find_qibla"],
  "require_approval": "never"
}

# Agents SDK (Python)
from agents import Agent
from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(name="awwab-qibla", params={"url": "https://awwab.app/mcp"}) as qibla:
    agent = Agent(name="Assistant", mcp_servers=[qibla])

Descoberta

O cartão do servidor fica em /mcp/server-card e está listado em /.well-known/ai-catalog.json. A API JSON é descrita em OpenAPI 3.1, para ações de GPT e outros frameworks de agentes.

Mesquitas, escolas e blogs podem mostrar a qibla nas próprias páginas com poucas linhas de código. Escolha uma cidade ou a localização de cada visitante, a aparência clara ou escura e o idioma na página do localizador de qibla.

Privacidade

Não registramos nem guardamos as coordenadas ou as cidades enviadas à API ou ao conector. Nada é guardado depois da resposta e nenhum cookie é definido. Para evitar abusos, a Cloudflare conta as solicitações por endereço IP durante cerca de um minuto. Todos os detalhes estão na nossa política de privacidade.

Como os números são calculados

O rumo é a direção inicial do círculo máximo do lugar até a Caaba (21,422487° N, 39,826206° L) numa esfera, que é como a qibla costuma ser calculada. A diferença para um cálculo sobre o elipsoide terrestre é menor que meio grau. A distância usa o raio médio da Terra. A declinação magnética vem do World Magnetic Model 2025, válido até o fim de 2029.

Termos

Uso gratuito, com a condição de dar o crédito “Qibla direction by Awwab” com um link para awwab.app/qibla onde o resultado for mostrado. Os nomes e as posições das cidades vêm do GeoNames, sob CC BY 4.0; dê crédito ao GeoNames também se reutilizá-los. Dúvidas: support@awwab.app.