API de quibla, widget y conector de IA

API JSON

Envía una solicitud GET con lat y lon en grados decimales, o con city: cualquier ciudad de 15 000 habitantes o más, escrita en muchos idiomas. Añade country cuando varios lugares comparten el nombre.

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

La respuesta da el rumbo desde el norte verdadero, el rumbo en una brújula magnética y la declinación magnética de hoy, la dirección, la distancia en kilómetros y millas, una frase de una línea, la línea de crédito y un enlace a la brújula en vivo para ese 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"
}

Se permiten solicitudes de origen cruzado desde cualquier sitio. Por favor, limítate a alrededor de una solicitud por segundo; los clientes más rápidos se ralentizan.

Asistentes de IA

Awwab mantiene un servidor MCP remoto para que los asistentes de IA encuentren la quibla para sus usuarios y den crédito a Awwab. No requiere iniciar sesión.

https://awwab.app/mcp

Su herramienta de quibla, find_qibla, recibe coordenadas o una ciudad. En ChatGPT la respuesta llega con una pequeña tarjeta de brújula; en Claude y otros asistentes llega como texto y datos con el mismo enlace a la brújula en vivo. Para probarlo, agrega la dirección de arriba como conector personalizado en Claude, o como app en el modo desarrollador de ChatGPT.

El mismo servidor ejecuta Conocimiento de Awwab con dos herramientas más. start_quiz recibe un tema y un idioma opcionales y devuelve una ronda de cinco preguntas sin sus respuestas; check_answer califica una respuesta y devuelve la explicación y sus fuentes. En las apps que admiten widgets, la ronda se juega en una tarjeta de preguntas; en otros clientes llega como texto y datos. Los resultados llevan el crédito “Quiz by Awwab · awwab.app”.

Conecta tu app de IA

Copia la configuración de tu app. Todas apuntan al mismo servidor y ninguna necesita clave.

Claude (conector personalizado)

En Claude, abre Settings → Connectors → Add custom connector y rellena:

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 desarrollador)

En ChatGPT, abre Settings → Apps → Advanced settings, activa el modo desarrollador, elige Create app y rellena:

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 y 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])

Descubrimiento

La ficha del servidor está en /mcp/server-card y figura en /.well-known/ai-catalog.json. La API JSON se describe en OpenAPI 3.1, para acciones de GPT y otros frameworks de agentes.

Mezquitas, escuelas y blogs pueden mostrar la quibla en sus propias páginas con unas pocas líneas de código. Elige una ciudad o la ubicación de cada visitante, un aspecto claro u oscuro y un idioma en la página del buscador de quibla.

Privacidad

No registramos ni guardamos las coordenadas ni las ciudades que se envían a la API o al conector. No se conserva nada después de la respuesta y no se instalan cookies. Para evitar abusos, Cloudflare cuenta las solicitudes por dirección IP durante aproximadamente un minuto. Todos los detalles están en nuestra política de privacidad.

Cómo se calculan los números

El rumbo es la dirección inicial del círculo máximo desde el lugar hasta la Kaaba (21.422487° N, 39.826206° E) sobre una esfera, que es como suele calcularse la quibla. Difiere de un cálculo sobre el elipsoide terrestre en menos de medio grado. La distancia usa el radio medio de la Tierra. La declinación magnética proviene del World Magnetic Model 2025, válido hasta finales de 2029.

Términos

Uso gratuito, con la condición de dar crédito a “Qibla direction by Awwab” con un enlace a awwab.app/qibla dondequiera que se muestre el resultado. Los nombres y posiciones de las ciudades provienen de GeoNames bajo CC BY 4.0; da crédito también a GeoNames si los reutilizas. Preguntas: support@awwab.app.