Servidor MCP de ENTIA

Inteligencia empresarial estructurada para agentes de IA.

ENTIA proporciona datos de entidades verificadas en 34 países, accesibles a través del Protocolo de Contexto de Modelo (MCP) o API REST.

Inicio rápido (< 2 minutos)

Opción 1: Servidor MCP remoto (recomendado)

No requiere instalación. Conecte su cliente MCP directamente:

Claude Desktop — añada a claude_desktop_config.json:

{
 "mcpServers": {
 "entia": {
 "command": "npx",
 "args": ["mcp-remote", "https://mcp.entia.systems/mcp"]
 }
 }
}

Cursor IDE — añada a .cursor/mcp.json:

{
 "mcpServers": {
 "entia": {
 "command": "npx",
 "args": ["mcp-remote", "https://mcp.entia.systems/mcp"]
 }
 }
}

Luego pruebe:

Look up Telefonica in Spain

Opción 2: API REST

# Search entities
curl "https://entia.systems/v1/search?q=telefonica&country=ES&limit=5" \
 -H "X-ENTIA-Key: YOUR_API_KEY"

# Full entity profile (BORME + GLEIF + VIES + Wikidata)
curl "https://entia.systems/v1/profile/Telefonica?country=ES"

# EU VAT verification
curl "https://entia.systems/v1/verify/vat/ESA28015865"

# Platform stats
curl "https://entia.systems/v1/stats"

Opción 3: SDK de Python (próximamente)

Un cliente de Python (entia-mcp en PyPI) y la integración con LangChain están en la hoja de ruta. Aún no publicados. Hasta entonces, utilice la Opción 1 (MCP) o la Opción 2 (REST).

Related MCP server: Bizfile MCP

6 herramientas MCP

Precios

Obtenga su clave API: entia.systems/mcp-setup

Fuentes de datos

Todos los datos provienen de registros públicos oficiales:

• BORME -- Registro Mercantil Español (BOE)

• VIES -- Validación de IVA de la UE (Comisión Europea)

• GLEIF -- Identificadores de Entidades Legales (Global LEI Foundation)

• Wikidata -- Grafo de conocimiento (Wikimedia Foundation)

• REPS -- Registro Estatal de Profesionales Sanitarios

• INE -- Instituto Nacional de Estadística (España)

• SEPE -- Servicio Público de Empleo Estatal (España)

• AEAT -- Agencia Tributaria (España)

• Companies House -- Registro de empresas del Reino Unido

• Sirene/INSEE -- Registro de empresas francés

Enlaces

• Documentación de la API

• Obtener clave API

• Guía de configuración

• Panel de control del cliente

• Registro oficial de MCP

Acerca de

Creado por PrecisionAI Marketing OU (Estonia, UE).

• IVA: EE102780516

• DUNS: 565868914

• Certificado e-Residency

• Cumple con eIDAS

Licencia

Propietaria. Consulte los Términos de servicio.

Despliegue en AWS (manual de migración de emergencia)

Este repositorio incluye ahora un bootstrap mínimo de AWS para ejecutar el servidor MCP independiente en ECR + ECS Fargate + ALB + Route 53 + ACM + Secrets Manager + CloudWatch Logs bajo infra/aws/.

Qué se despliega

• Repositorio ECR para imágenes de contenedor.

• Clúster ECS, definición de tarea y servicio Fargate.

• ALB con:

  • redirección del puerto 80 al 443

  • listener HTTPS en el puerto 443 (certificado ACM)

  • comprobación de estado del grupo de destino en /health

• Grupos de seguridad (entrada pública al ALB, entrada al ECS solo desde el ALB).

• Registro alias de Route53 (opcional) para mcp.entia.systems.

• Grupo de logs de CloudWatch para logs de ECS.

• Roles IAM con base de privilegios mínimos, más acceso opcional a Secrets Manager.

Suposiciones de tiempo de ejecución preservadas

• MCP_TRANSPORT=http

• MCP_PORT=3000

• Ruta del endpoint de salud: /health

Variables de entorno de AWS requeridas (variables del repositorio de GitHub Actions)

• AWS_REGION

• ECR_REPOSITORY (ejemplo: 123456789012.dkr.ecr.us-east-1.amazonaws.com/entia-mcp-prod-mcp)

• ECS_CLUSTER

• ECS_SERVICE

• DOCKERFILE_PATH (opcional, por defecto Dockerfile)

Secretos requeridos de GitHub Actions

• AWS_GITHUB_ACTIONS_ROLE_ARN (ARN del rol OIDC con permisos de Terraform/ECR/ECS)

• TF_VARS_JSON_B64 (JSON tfvars codificado en base64 para las entradas requeridas de Terraform excepto container_image)

Secretos de tiempo de ejecución requeridos (AWS Secrets Manager)

Configurar como mapa secret_arns en Terraform (ENV_VAR_NAME => secret ARN), por ejemplo:

• ENTIA_API_KEY

• Cualquier credencial de API ascendente utilizada por el servidor MCP independiente

• Tokens de SMTP o proveedor si son utilizados por el tiempo de ejecución

Mantenga todas las credenciales en Secrets Manager. No codifique secretos en archivos de flujo de trabajo o variables de Terraform.

Pasos de despliegue

1. Copie infra/aws/terraform.tfvars.example a infra/aws/terraform.tfvars.

2. Rellene los valores de red/DNS/certificado/imagen.

3. Ejecute:

   • terraform -chdir=infra/aws init

   • terraform -chdir=infra/aws plan

   • terraform -chdir=infra/aws apply

4. Para despliegues de CI, proporcione el secreto TF_VARS_JSON_B64 (base64 del JSON de tfvars) y active el flujo de trabajo AWS MCP Deploy.

5. Haga push a main o active el flujo de trabajo de GitHub Actions AWS MCP Deploy.

6. Valide las comprobaciones de humo:

   • GET https://mcp.entia.systems/health devuelve 200

   • El endpoint MCP es accesible a través del ALB

   • El servicio ECS tiene objetivos saludables

Pasos de despliegue (seguro para producción)

1. Despliegue la infraestructura y el servicio ECS sin cambiar el DNS (create_dns_record=false) y pruebe con el nombre DNS del ALB.

2. Ejecute comprobaciones de humo en el nombre de host del ALB.

3. Habilite el alias DNS (create_dns_record=true) una vez que esté saludable.

4. Supervise los logs de CloudWatch + el estado del objetivo del ALB durante al menos un ciclo comercial completo.

Pasos de reversión

1. Revierta el alias DNS al endpoint de servicio anterior (mcp.entia.systems).

2. Vuelva a desplegar la etiqueta de imagen estable anterior o la revisión de definición de tarea anterior en ECS:

   • aws ecs update-service --cluster <cluster> --service <service> --task-definition <family:revision> --force-new-deployment

3. Si es necesario, revierta Terraform al commit anterior y aplique.

4. Confirme la recuperación de /health y del endpoint MCP.

Pasos de corte de DNS para mcp.entia.systems

1. Asegúrese de que el certificado ACM esté emitido para mcp.entia.systems en la región de despliegue.

2. Aplique Terraform con create_dns_record=true, hosted_zone_id y domain_name="mcp.entia.systems".

3. Verifique que el alias de Route53 apunte al ALB y que el grupo de destino esté saludable.

4. Ejecute comprobaciones posteriores al corte:

   • Cadena de certificados TLS válida

   • /health = 200

   • La ruta de solicitud/respuesta MCP funciona de extremo a extremo

Para obtener detalles adicionales de seguridad/reversión, consulte AGENTS.md y docs/aws-migration-assumptions.md.

Maintenance

Resources

• Remote Server
• GitHub Repository
Need Help?Related Servers

Tools

• borme_lookupA
• entity_lookupA
• get_competitorsA
• search_entitiesA
• verify_vatA
• zone_profileA