tkawen

El servidor MCP para Argelia. Datos argelinos reales para cualquier asistente de IA: las 69 wilayas completas, 1.581 comunas, validación de teléfonos, más comercio electrónico, economía del pago contra reembolso, verificación de credenciales, talento certificado y formación profesional. 35 herramientas. Cero dependencias. Sin clave API.

npx -y tkawen

Por qué existe esto

Pregúntale a cualquier modelo cuántas provincias tiene Argelia y te dirá 58.

Argelia tiene 69 wilayas desde el 16 de noviembre de 2025, cuando se ascendieron once provincias delegadas. Pregunta por las comunas de Timimoun y el modelo inventa nombres de lugares árabes verosímiles. Pregunta si 0770112233 es un número argelino válido y lo adivina.

Eso no es una brecha que un modelo más grande cierre. Es un problema de datos, y esto son los datos.

> How many wilayas does Algeria have, and list them?

Algeria — 69 wilayas, 1,581 communes.
The 2025 reform promoted 11 delegated provinces to full wilayas on 16 Nov 2025.
Any list of 58 is stale.

01  Adrar                  أدرار                   16 communes
02  Chlef                  الشلف                   35 communes
...
69  El Abiodh Sidi Cheikh  الأبيض سيدي الشيخ        9 communes

Related MCP server: Australian Postcodes MCP Server

Instalación

Añádelo a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "tkawen": {
      "command": "npx",
      "args": ["-y", "tkawen"]
    }
  }
}

Funciona con Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Zed y cualquier otra cosa que hable MCP sobre stdio. Esa es toda la instalación: sin cuenta, sin clave, sin registro.

🇩🇿 La API de datos de Argelia

La joya de la corona. Dos herramientas que responden desde un dataset local, en milisegundos, y que siguen funcionando incluso cuando todos los demás servicios están caídos.

algeria_geospatial

El latín y el árabe son ciudadanos de pleno derecho: Alger, الجزائر, الجزاير y alger resuelven todos a la wilaya 16.

algeria_telecom_validator

Acepta cualquier formato que un argelino escribe de verdad: +213…, 00213…, 213…, 9 dígitos sin prefijo, espacios, guiones y dígitos indoarábigos (٠٥٥٥١٢٣٤٥٦):

input:    ٠٥٥٥١٢٣٤٥٦
local:    0555123456
E.164:    +213555123456
whatsapp: 213555123456
type:     mobile
issuer:   Ooredoo (originally allocated)

Se validan tanto los móviles (05 / 06 / 07) como las líneas fijas de Algérie Télécom (02 / 03).

Dos cosas que no hará, porque ser útil importa más que parecer completo:

• El operador es la asignación original. La portabilidad numérica está en vigor en Argelia desde 2017, así que 07 ya no prueba Djezzy. Se informa como "asignado originalmente", nunca como un hecho.

• Las líneas fijas no se asignan a una wilaya. Los códigos de área argelinos no siguen la numeración de las wilayas: Argel es 021 en la wilaya 16, Orán 041 en la wilaya 31. No existe aquí una tabla autoritativa de códigos de área, e inventar una pondría geografía ficticia dentro de la herramienta creada para impedir que los modelos inventen geografía argelina.

Las otras 33 herramientas

Empieza con tkawen_search_tools — describe lo que quieres en palabras sencillas y devuelve solo las herramientas que encajan, en lugar de cargar 35 esquemas en tu contexto. Entiende árabe, francés e inglés.

Comercio electrónico (MyStoq) — cod_profit (beneficio neto real, incluida la tasa de rechazo) · order_risk (puntuación de fraude en COD) · yalidine_delivery (tasas de devolución y tiempos de entrega por wilaya) · search_stores · get_store · list_plans · platform_stats · create_store · create_product · set_price · publish · delete_product

Credenciales (AlgeriaCertify) — verify_certificate · search_certified_talent · match_talent_to_job · get_talent_profile · list_specialties · list_institutions · platform_stats

Formación — search_trainings · get_training · list_categories · request_quote · list_individual_trainings · catalogue_stats

Reuniones (LIQAA) — create_instant_room · list_plans · platform_capacity · request_quote · list_individual_trainings · catalogue_stats

Meta — tkawen_search_tools · tkawen_overview · tkawen_recommend · tkawen_verify

Preguntas reales que responde:

Herramientas de escritura

La mayoría de herramientas son de solo lectura y no necesitan nada. Las que crean cosas operan sobre una cuenta real y requieren un token:

{
  "mcpServers": {
    "tkawen": {
      "command": "npx",
      "args": ["-y", "tkawen"],
      "env": { "TKAWEN_TOKEN": "your-token" }
    }
  }
}

Sin token, se niegan. Nada se crea por accidente.

Arquitectura

Un puente stdio, ~190 líneas, hacia la API de inteligencia TKAWEN en https://mcp.tkawen.com. Vale la pena saber exactamente qué significa:

• Tus consultas salen de tu máquina. Las llamadas a las herramientas van a mcp.tkawen.com por HTTPS. Si eso no es aceptable para tus datos, no lo instales. Dicho aquí y no enterrado en una página de privacidad.

• Las herramientas no están en este paquete. Viven en la puerta de enlace, así que una herramienta añadida un martes funciona para ti sin actualización y sin desajuste de versiones.

• Cero dependencias. El fetch nativo de Node y nada más: npx sigue siendo rápido y no hay árbol de dependencias que auditar.

• stdout solo para el protocolo. Cualquier console.log accidental corrompería el stream MCP y el cliente reportaría "server disconnected". Por eso todos los diagnósticos van a stderr.

• Errores explícitos. Respuestas mal formadas, timeouts, JSON no válido: cada fallo es un error limpio de MCP, no un cierre silencioso.

Preguntas reales que responde

Arquitectura

Un puente stdio, ~190 líneas, hacia la puerta de enlace de inteligencia de TKAWEN en https://mcp.tkawen.com. Merece la pena saber exactamente qué significa esto:

• Tus preguntas salen de tu máquina. Las llamadas a herramientas van a mcp.tkawen.com por HTTPS. Si eso no es aceptable para tus datos, no lo instales. Dicho aquí en lugar de enterrado en una página de privacidad.

• Las herramientas no están en este paquete. Viven en la puerta de enlace, así que una herramienta nueva funciona para ti sin actualizar y sin desajustes de versión.

• Cero dependencias. fetch integrado de Node y nada más: npx sigue siendo rápido y el paquete no arrastra nada.

Configuración

Pruebas

npm test     # 10 tests, no network — framing, errors, stdout purity
npm run smoke # hits the live gateway, asserts 69 wilayas

Las pruebas unitarias se ejecutan contra una puerta de enlace simulada a propósito: un test en rojo significa que este paquete se rompió, y un smoke en rojo significa que la puerta de enlace está caída. Combinar ambos haría que cualquier caída de red pareciera una regresión del código.

Licencia

MIT — hecho en Argel por TKAWEN.