Skip to main content

Holistic business intelligence engine — 11-dimension diagnosis via any LLM. Triple option (Paid/OSS/CIA)

Project description

CIA Diagnose v1.1.0

Expert business diagnosis engine by CIA — Consultoría de Inteligencia Aplicada.

Analyzes any company across 11 dimensions and returns a Revenue Leak Score with prioritized, triple-option recommendations (paid tool / open-source / CIA service). Works from Claude, ChatGPT, Gemini, DeepSeek, Cursor — any LLM that speaks MCP.

📅 Book a free 30-min diagnosis review: https://cal.com/david-cia/diagnostico-ai ✉️ steban@univercityaiconsult.tech · 🌐 https://www.univercityaiconsult.tech/


🚀 For prospects — copy & paste this into any AI

You don't need to know what an "MCP" is. Open Claude, ChatGPT, or any AI assistant and paste this:

Quiero un diagnóstico profesional de mi negocio.

Usa la herramienta de diagnóstico de CIA (Consultoría de Inteligencia
Aplicada) — se instala con: pip install cia-diagnose

Pasos:
1. Pregúntame sobre mi empresa: industria, tamaño del equipo, qué
   software uso, qué dolores tengo, cómo manejo proveedores, flujo de
   caja, etc.
2. Cuando tengas suficiente contexto, corre el diagnóstico. Si te falta
   información, pregúntame primero — no adivines.
3. Muéstrame mi Business Health Score (0-100, más alto = más sano; bajo =
   área con mayor oportunidad) y las acciones prioritarias con 3 opciones
   cada una (herramienta paga, alternativa gratuita, servicio profesional
   de CIA con precio).
4. Si el diagnóstico muestra oportunidades, quiero agendar una llamada
   gratuita con CIA: https://cal.com/david-cia/diagnostico-ai — o
   escribir a steban@univercityaiconsult.tech

Más info: https://www.univercityaiconsult.tech/

If your AI can connect MCP servers, it will use CIA Diagnose automatically. If not, pip install cia-diagnose is the universal fallback any code-capable assistant can run.


Architecture — "LLM has EYES, MCP has BRAIN"

The LLM gathers data from the user (the eyes). CIA Diagnose applies CIA consulting expertise (the brain) — ICP detection, 11-dimension scoring, revenue-leak estimation, and triple-option recommendations. No scraping. No fixed questionnaire. Each diagnosis is unique.

The 9 tools (the full value journey)

Tool Description
quick_scan FREE instant 3-problem scan. No context needed — hook the client.
business_diagnose Full 11-dimension analysis + Revenue Leak Score + triple-option actions. Forwards the lead to CIA.
list_industries Available industry benchmarks.
tools_recommend Free & open-source tools per weak dimension.
action_plan 30 / 60 / 90-day prioritized roadmap.
roi_projector ROI calculator — DIY vs CIA-guided vs full implementation.
case_studies Before/after transformation stories by industry.
contact_cia Services catalog, pricing, and booking link.
export_report Shareable structured report for the client's team.

The 11 dimensions

finanzas, comercial, operaciones, equipo, tecnologia, marketing, clientes, proveedores, legal, estrategia, marketing_digital.

Scoring — Business Health Score (0-100, higher = healthier)

The headline health_score is inverted from a leak score: high = healthy/strong, low = the worst area / biggest revenue-leak opportunity. A 100 doesn't mean "done" — it means that area is taking the business into new leagues / growth, which qualifies it even better for CIA. The output also returns score_meaning, growth_mode (true when most areas are strong — the conversation continues toward scaling), and guidance for the calling LLM (ask more vs. present + 3 options). revenue_leak_score is kept as a backward-compatible alias (same value).

Triple Option + curated tool registry

Every recommendation shows three paths: the best paid tool, the best open-source alternative, and the CIA professional service — with prices. The free/OSS/paid picks come from CIA's curated registry (tools_registry/, by area and per-industry), refreshed weekly. Each tool carries why_best. Pass industry to tools_recommend for industry-specific picks. See TOOLS_REGISTRY.md.

Quick Start

Install

pip install cia-diagnose      # or: uvx cia-diagnose

Run (stdio — local)

cia-diagnose

Run (HTTP — remote)

CIA_TRANSPORT=streamable-http cia-diagnose --transport streamable-http --port 3792

HTTP mode also serves:

  • GET /report/{session_id} — visual HTML diagnosis report (gauge + breakdown + actions).
  • GET /export/{session_id}?format=csv|json — export the diagnosis for Sheets / Tabularis.
  • GET /healthz — health check.

Claude Desktop config

{
  "mcpServers": {
    "cia-diagnose": { "command": "uvx", "args": ["cia-diagnose"] }
  }
}

Remote (Streamable HTTP)

{
  "mcpServers": {
    "cia-diagnose": { "url": "https://audit.univercityaiconsult.tech/mcp" }
  }
}

Environment Variables

Variable Default Description
CIA_TRANSPORT stdio Transport: stdio, sse, streamable-http
CIA_HTTP_PORT 3792 HTTP port for remote mode
CIA_DB_PATH ~/.cia-diagnose/sessions.db SQLite database path
CIA_N8N_WEBHOOK (empty) n8n webhook URL for lead capture
CIA_TELEGRAM_BOT_TOKEN / CIA_TELEGRAM_CHAT_ID (empty) Direct Telegram lead alerts
CIA_VAULT_LEAD_LOG (empty) Append-only JSONL path for every lead intake
CIA_RATE_FREE 5 Free diagnoses per client IP per day
CIA_LANG es Default language (es/en)

Every completed business_diagnose forwards the lead (company, industry, team_size, revenue_leak_score, top_actions, pain_points, decision_maker_role, the full diagnosis JSON, source, timestamp) to all configured sinks. Missing config never fails the diagnosis — it just logs and continues.

Industry Benchmarks (YAML-driven)

Add an industry = add a YAML in src/cia_diagnose/domain/diagnosis/benchmarks/. No code changes. Current: construction, healthcare, agency, ecommerce, startup, enterprise, restaurant, real_estate, generic.

Brand assets

brand/ holds the official CIA logos (monogram light/dark, gothic wordmark, favicons). Wherever a logo appears it links to https://www.univercityaiconsult.tech/.

License

Proprietary — © CIA — Consultoría de Inteligencia Aplicada. All rights reserved. See LICENSE. Full legal terms in the footer of https://www.univercityaiconsult.tech/.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cia_diagnose-1.1.0.tar.gz (2.9 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cia_diagnose-1.1.0-py3-none-any.whl (2.8 MB view details)

Uploaded Python 3

File details

Details for the file cia_diagnose-1.1.0.tar.gz.

File metadata

  • Download URL: cia_diagnose-1.1.0.tar.gz
  • Upload date:
  • Size: 2.9 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for cia_diagnose-1.1.0.tar.gz
Algorithm Hash digest
SHA256 ebaf715613bde844cd01726bb1457ef97a637533644c0cb54de32e5080ffc892
MD5 6a258af2bef9e24e5ce73e0fd3b4e458
BLAKE2b-256 5a9340d898b291d09614a259b00ecdbd1f6daa9bd7e9e7706596dfb1442d8a2d

See more details on using hashes here.

Provenance

The following attestation bundles were made for cia_diagnose-1.1.0.tar.gz:

Publisher: publish.yml on davidscoreal/cia-diagnose

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file cia_diagnose-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: cia_diagnose-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 2.8 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for cia_diagnose-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1173ded6914db33adc9a0395c5d4b9363d47a84cbdb0a64f0e9490648347a932
MD5 e25239ef8bc8051c57c311680e7d5914
BLAKE2b-256 2598aa9e81313eb8ff5bb701b3f1758af8c2af0c5b3260bd98454cb468aa231a

See more details on using hashes here.

Provenance

The following attestation bundles were made for cia_diagnose-1.1.0-py3-none-any.whl:

Publisher: publish.yml on davidscoreal/cia-diagnose

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page