Metadata-Version: 2.4
Name: univercity-mcp
Version: 1.0.0
Summary: Holistic business intelligence engine — 11-dimension diagnosis via any LLM. Triple option (Paid/OSS/CIA)
Project-URL: Homepage, https://univercityaiconsult.tech
Project-URL: Repository, https://github.com/davidscoreal/univercity-mcp
Project-URL: Documentation, https://github.com/davidscoreal/univercity-mcp#readme
Author-email: David Lopez <proyectos@univercity.com.co>
License-Expression: MIT
Keywords: audit,automation,business,consulting,mcp
Requires-Python: >=3.10
Requires-Dist: aiosqlite>=0.20.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: jinja2>=3.1.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.4; extra == 'dev'
Provides-Extra: pdf
Requires-Dist: weasyprint>=62.0; extra == 'pdf'
Description-Content-Type: text/markdown

# UniverCity MCP v0.2.1

<!-- mcp-name: io.github.davidscoreal/univercity-mcp -->

**Expert business diagnosis engine** by [CIA — Consultoría de Inteligencia Aplicada](https://univercityaiconsult.tech).

Analyzes any company across **8 dimensions** and returns a Revenue Leak Score with prioritized, triple-option recommendations. Works from Claude, GPT, Gemini, DeepSeek, Cursor — any LLM that speaks MCP.

## Architecture

**"LLM has EYES, MCP has BRAIN."**

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

## Tools

| Tool | Description |
|------|-------------|
| `univercity_diagnose` | Full 8-dimension diagnosis. Send company context, get Revenue Leak Score + actions. |
| `univercity_list_industries` | Returns available industry benchmarks (construction, healthcare, agency, ecommerce, startup, enterprise, generic). |

## 8 Dimensions

digital, operations, supply_chain, talent, financial, leadership, market, regulatory

## Triple Option

Every recommendation shows three paths: the best **paid tool**, the best **open source alternative**, and the **CIA professional service** — with prices. Radical transparency.

## Quick Start

### Install

```bash
pip install univercity-mcp
```

### Run (stdio — local)

```bash
univercity-mcp
```

### Run (HTTP — remote)

```bash
UNIVERCITY_TRANSPORT=streamable-http univercity-mcp --transport streamable-http --port 3792
```

### Claude Desktop config

```json
{
  "mcpServers": {
    "univercity": {
      "command": "uvx",
      "args": ["univercity-mcp"]
    }
  }
}
```

### Remote (Streamable HTTP)

```json
{
  "mcpServers": {
    "univercity": {
      "url": "https://audit.univercityaiconsult.tech/mcp"
    }
  }
}
```

## Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `UNIVERCITY_TRANSPORT` | `stdio` | Transport: stdio, sse, streamable-http |
| `UNIVERCITY_HTTP_PORT` | `3792` | HTTP port for remote mode |
| `UNIVERCITY_DB_PATH` | `~/.univercity-mcp/sessions.db` | SQLite database path |
| `UNIVERCITY_N8N_WEBHOOK` | (empty) | n8n webhook for lead capture |
| `UNIVERCITY_RATE_FREE` | `5` | Free diagnoses per IP per day |
| `UNIVERCITY_LANG` | `es` | Default language (es/en) |

## Industry Benchmarks (YAML-driven)

Add an industry = add a YAML file in `src/univercity_mcp/domain/diagnosis/benchmarks/`. No code changes needed.

Current benchmarks: construction, healthcare, agency, ecommerce, startup, enterprise, generic.

## Value Ladder

Free diagnosis → Paid diagnostic (\$1K-\$5K) → Core implementation (\$4K-\$25K) → Retainer (\$500-\$3K/mo) → Bespoke (\$30K+)

100% Credit Bridge: audit cost credited if client proceeds within 30 days.

## License

Proprietary — CIA (Consultoría de Inteligencia Aplicada). All rights reserved.
