Movahedi Privacy API

npx add-mcp 'https://movahedi.ca/mcp'

Inicio rápido

No se necesita clave para las primeras 2,000 llamadas al día. Pruébalo:

curl "https://movahedi.ca/api/v1/enforcement?regulator=cai&per_page=5"

La respuesta está envuelta en un pequeño sobre: data contiene el payload, meta contiene la paginación, lang siempre es "en".

Endpoints

Método	Ruta	Qué devuelve
GET	/api/v1/enforcement	Acciones de cumplimiento de CAI y OPC verificadas (filtrar por regulator, year, q)
GET	/api/v1/enforcement/:id	Una acción de cumplimiento, registro completo
GET	/api/v1/glossary	Términos del glosario de privacidad (filtrar por q, letter)
GET	/api/v1/glossary/:term	Una definición del glosario por slug
GET	/api/v1/law25/checklist	Requisitos de la Ley 25 de Quebec (filtrar por category)
GET	/api/v1/openapi.json	Especificación OpenAPI 3.1 legible por máquina
GET	/api/v1/terms	Términos de uso de la API
GET	/api/v1/health	Estado del servicio y versión de datos
POST	/mcp	Servidor MCP (HTTP Streamable, JSON-RPC)

Cada respuesta incluye ETag para almacenamiento en caché. Envía If-None-Match para recibir un 304 cuando nada haya cambiado.

Cuotas

• Anónimo: 2,000 llamadas por IP por día UTC.
• Con clave gratuita: 10,000 llamadas por clave por día UTC.

Los encabezados de cuota regresan en cada respuesta: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Cuando la cuota se agota, recibes HTTP 429 con un encabezado Retry-After y un enlace para obtener una clave.

Autenticación

Las claves son gratuitas y no requieren cuenta ni correo electrónico. Pasa la tuya como token de portador:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://movahedi.ca/api/v1/glossary?query=consent"

Obtén una clave resolviendo un desafío de Cloudflare Turnstile y aceptando los términos de la API. La clave se muestra una sola vez y nunca se almacena en nuestro lado.

Ejemplos

JavaScript

const res = await fetch(
  "https://movahedi.ca/api/v1/law25/checklist?category=Consent",
  { headers: { Authorization: "Bearer YOUR_API_KEY" } }
);
const { data } = await res.json();
console.log(data.items.map((c) => c.title));

Python

import requests

res = requests.get(
    "https://movahedi.ca/api/v1/enforcement",
    params={"regulator": "cai", "per_page": 5},
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
res.raise_for_status()
for case in res.json()["data"]["items"]:
    print(case["date"], "-", case["title"])

Servidor MCP

Apunta cualquier cliente MCP al endpoint HTTP Streamable: https://movahedi.ca/mcp. Sin registro, sin clave necesaria.

Claude Code

claude mcp add --transport http movahedi-privacy https://movahedi.ca/mcp

Claude Desktop

Abre Configuración > Conectores > Agregar conector personalizado, o usa el botón de arriba. Ingresa el nombre Movahedi Privacy API y la URL https://movahedi.ca/mcp. En versiones antiguas sin conectores personalizados, agrega esto a claude_desktop_config.json en su lugar (requiere Node.js):

{
  "mcpServers": {
    "movahedi-ca-privacy": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://movahedi.ca/mcp"]
    }
  }
}

Cursor

Agrega a ~/.cursor/mcp.json (cada proyecto) o .cursor/mcp.json (este proyecto), o usa el botón de un clic de arriba:

{
  "mcpServers": {
    "movahedi-ca-privacy": {
      "url": "https://movahedi.ca/mcp"
    }
  }
}

Windsurf

Agrega a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "movahedi-ca-privacy": {
      "serverUrl": "https://movahedi.ca/mcp"
    }
  }
}

VS Code

Agrega a .vscode/mcp.json:

{
  "servers": {
    "movahedi-ca-privacy": {
      "type": "http",
      "url": "https://movahedi.ca/mcp"
    }
  }
}

Cualquier otro cliente

{
  "mcpServers": {
    "movahedi-ca-privacy": {
      "url": "https://movahedi.ca/mcp"
    }
  }
}

Se exponen cinco herramientas de solo lectura:

• privacy_search_enforcement_actions: busca casos por palabra clave, regulador o año
• privacy_get_enforcement_case: registro completo para un ID de caso
• privacy_lookup_glossary_term: definición para un slug de término
• privacy_list_glossary_terms: explora o busca el glosario, paginado
• privacy_law25_requirements: la lista de verificación de la Ley 25, opcionalmente por categoría

Ejemplos de indicaciones una vez conectado:

• "Busca acciones de cumplimiento de CAI que involucren videovigilancia y resume los resultados."
• "¿Cuál es la definición del glosario de privacidad de consentimiento significativo?"
• "Enumera los requisitos de la Ley 25 sobre consentimiento y retención de datos."

Envía la clave de API como Authorization: Bearer ... si tienes una. El servidor negocia la versión del protocolo MCP en initialize y devuelve salida estructurada en cada llamada de herramienta.

Listados

También aparece en el directorio MCP de Claude Market y en Glama.

Códigos de error

Estado	Código	Significado
400	invalid_parameter	Un parámetro de consulta falló la validación. El mensaje nombra el parámetro y sus valores permitidos.
404	not_found	Ningún registro coincide con el ID o slug. El mensaje apunta al endpoint de búsqueda.
405	method_not_allowed	Solo se acepta GET en las rutas de datos.
429	quota_exhausted	Cuota diaria agotada. Incluye key_url y Retry-After.
500	internal_error	Algo falló en nuestro lado. Es seguro reintentar después de una breve espera.

Registro de cambios

v1.0.0, 2026-09-24

• Lanzamiento inicial: acciones de cumplimiento, glosario, lista de verificación de la Ley 25, servidor MCP, claves de API gratuitas.
• Versión de datos 2026-09-24: 5 acciones de cumplimiento verificadas, 263 términos del glosario, 11 verificaciones de la Ley 25.

Términos

Los datos son gratuitos para uso personal y comercial con atribución a movahedi.ca. Se proporcionan tal cual, solo con fines informativos, y no constituyen asesoría legal. Términos completos: /api/v1/terms.