ENTIA MCP-Server

Strukturierte Business Intelligence für KI-Agenten.

ENTIA bietet verifizierte Unternehmensdaten aus 34 Ländern – zugänglich über das Model Context Protocol (MCP) oder eine REST-API.

Schnellstart (< 2 Minuten)

Option 1: Remote-MCP-Server (empfohlen)

Keine Installation erforderlich. Verbinden Sie Ihren MCP-Client direkt:

Claude Desktop — hinzufügen zu claude_desktop_config.json:

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

Cursor IDE — hinzufügen zu .cursor/mcp.json:

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

Dann versuchen Sie:

Look up Telefonica in Spain

Option 2: REST-API

# 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"

Option 3: Python SDK (in Kürze)

Ein Python-Client (entia-mcp auf PyPI) und eine LangChain-Integration sind in Planung. Noch nicht veröffentlicht. Verwenden Sie bis dahin Option 1 (MCP) oder Option 2 (REST).

Related MCP server: Bizfile MCP

6 MCP-Tools

Preisgestaltung

Holen Sie sich Ihren API-Schlüssel: entia.systems/mcp-setup

Datenquellen

Alle Daten stammen aus offiziellen öffentlichen Registern:

• BORME -- Spanisches Handelsregister (BOE)

• VIES -- EU-USt-Validierung (Europäische Kommission)

• GLEIF -- Legal Entity Identifiers (Global LEI Foundation)

• Wikidata -- Knowledge Graph (Wikimedia Foundation)

• REPS -- Spanisches Register der Gesundheitsberufe

• INE -- Spanisches Nationales Statistikinstitut

• SEPE -- Spanische Arbeitsagentur

• AEAT -- Spanische Steuerbehörde

• Companies House -- Britisches Unternehmensregister

• Sirene/INSEE -- Französisches Unternehmensregister

Links

• API-Dokumentation

• API-Schlüssel erhalten

• Einrichtungsanleitung

• Client-Dashboard

• Offizielles MCP-Register

Über uns

Entwickelt von PrecisionAI Marketing OU (Estland, EU).

• USt-IdNr.: EE102780516

• DUNS: 565868914

• e-Residency zertifiziert

• eIDAS-konform

Lizenz

Proprietär. Siehe Nutzungsbedingungen.

AWS-Bereitstellung (Notfall-Migrations-Runbook)

Dieses Repository enthält jetzt einen minimalen AWS-Bootstrap für den Betrieb des eigenständigen MCP-Servers auf ECR + ECS Fargate + ALB + Route 53 + ACM + Secrets Manager + CloudWatch Logs unter infra/aws/.

Was wird bereitgestellt

• ECR-Repository für Container-Images.

• ECS-Cluster, Aufgabendefinition und Fargate-Service.

• ALB mit:

  • Port 80 Weiterleitung auf 443

  • Port 443 HTTPS-Listener (ACM-Zertifikat)

  • Zielgruppen-Health-Check auf /health

• Sicherheitsgruppen (ALB öffentlicher Ingress, ECS Ingress nur von ALB).

• Route53-Alias-Eintrag (optional) für mcp.entia.systems.

• CloudWatch-Logs-Gruppe für ECS-Logs.

• IAM-Rollen mit Least-Privilege-Baseline sowie optionalem Zugriff auf den Secrets Manager.

Beibehaltene Laufzeitannahmen

• MCP_TRANSPORT=http

• MCP_PORT=3000

• Health-Endpunkt-Pfad: /health

Erforderliche AWS-Umgebungsvariablen (GitHub Actions Repository-Variablen)

• AWS_REGION

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

• ECS_CLUSTER

• ECS_SERVICE

• DOCKERFILE_PATH (optional, Standard ist Dockerfile)

Erforderliche GitHub Actions Secrets

• AWS_GITHUB_ACTIONS_ROLE_ARN (OIDC-Rollen-ARN mit Terraform/ECR/ECS-Berechtigungen)

• TF_VARS_JSON_B64 (base64-kodiertes JSON-tfvars für erforderliche Terraform-Eingaben außer container_image)

Erforderliche Laufzeit-Secrets (AWS Secrets Manager)

Konfigurieren Sie diese als secret_arns-Map in Terraform (ENV_VAR_NAME => secret ARN), zum Beispiel:

• ENTIA_API_KEY

• Alle Upstream-API-Anmeldedaten, die vom eigenständigen MCP-Server verwendet werden

• SMTP- oder Provider-Token, falls von der Laufzeit verwendet

Bewahren Sie alle Anmeldedaten im Secrets Manager auf. Hardcodieren Sie keine Secrets in Workflow-Dateien oder Terraform-Variablen.

Bereitstellungsschritte

1. Kopieren Sie infra/aws/terraform.tfvars.example nach infra/aws/terraform.tfvars.

2. Füllen Sie Netzwerk-/DNS-/Zertifikats-/Image-Werte aus.

3. Führen Sie aus:

   • terraform -chdir=infra/aws init

   • terraform -chdir=infra/aws plan

   • terraform -chdir=infra/aws apply

4. Für CI-Bereitstellungen stellen Sie das TF_VARS_JSON_B64-Secret bereit (base64 von tfvars JSON) und lösen Sie den Workflow AWS MCP Deploy aus.

5. Pushen Sie auf main oder lösen Sie den GitHub Actions-Workflow AWS MCP Deploy aus.

6. Validieren Sie Smoke-Tests:

   • GET https://mcp.entia.systems/health gibt 200 zurück

   • MCP-Endpunkt ist über ALB erreichbar

   • ECS-Service hat gesunde Ziele

Rollout-Schritte (produktionssicher)

1. Stellen Sie Infrastruktur und ECS-Service bereit, ohne das DNS zu ändern (create_dns_record=false) und testen Sie über den ALB-DNS-Namen.

2. Führen Sie Smoke-Tests auf dem ALB-Hostnamen durch.

3. Aktivieren Sie den DNS-Alias (create_dns_record=true), sobald der Status gesund ist.

4. Überwachen Sie CloudWatch Logs + ALB-Zielstatus für mindestens einen vollständigen Geschäftszyklus.

Rollback-Schritte

1. Setzen Sie den DNS-Alias auf den vorherigen Endpunkt zurück (mcp.entia.systems).

2. Stellen Sie das vorherige stabile Image-Tag oder die vorherige Aufgabendefinitionsrevision in ECS erneut bereit:

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

3. Falls erforderlich, setzen Sie Terraform auf den vorherigen Commit zurück und wenden Sie ihn an.

4. Bestätigen Sie die Wiederherstellung von /health und dem MCP-Endpunkt.

DNS-Umstellungsschritte für mcp.entia.systems

1. Stellen Sie sicher, dass das ACM-Zertifikat für mcp.entia.systems in der Bereitstellungsregion ausgestellt ist.

2. Wenden Sie Terraform mit create_dns_record=true, hosted_zone_id und domain_name="mcp.entia.systems" an.

3. Überprüfen Sie, ob der Route53-Alias auf ALB zeigt und die Zielgruppe gesund ist.

4. Führen Sie Post-Cutover-Prüfungen durch:

   • TLS-Zertifikatskette gültig

   • /health = 200

   • MCP-Anfrage/Antwort-Pfad funktioniert durchgehend

Für weitere Sicherheits-/Rollback-Details siehe AGENTS.md und 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