Expert business diagnosis for any company across 11 dimensions.

Send what you know — tools they use, team size, revenue, pain points, location, industry, leadership situation, cash flow, talent gaps, physical operations, anything. Returns Revenue Leak Score + actionable recommendations comparing paid software, open source alternatives, and professional implementation services.

Works for ANY industry. The more context you provide, the more accurate and specific the diagnosis. Even minimal input (just company_name + industry) produces useful results.

11 dimensions analyzed: finanzas, comercial, operaciones, equipo, tecnologia, marketing, clientes, proveedores, legal, estrategia, marketing_digital.

Args: company_name: Name of the company being diagnosed (required). industry: Industry or sector (e.g. 'construction', 'healthcare', 'ecommerce'). Use list_industries to see calibrated benchmarks. team_size: Number of employees (0 if unknown). location_city: City where the company is based. location_country: Country where the company is based. revenue_estimate: ANNUAL revenue range (e.g. '200k-1m', '1m-5m', 'over_10m'). Used to scale the monthly leak estimate. Accept also revenue_range as alias. software_detected: Comma-separated tools/software the company uses (e.g. 'Excel, WhatsApp, QuickBooks, no CRM'). pain_points: Comma-separated problems described by the company (e.g. 'quotes get lost, manual reporting, slow hiring'). physical_operations: Notes on physical/operational challenges (e.g. 'material waste, rework, production delays'). supply_chain_notes: Notes on supply chain or vendor issues (e.g. 'unreliable suppliers, delivery delays'). hiring_challenges: Notes on hiring difficulties (e.g. "can't find skilled workers, high turnover"). skill_gaps: Notes on skill gaps in the team (e.g. 'no data analyst, no digital marketing'). cash_flow_concerns: Notes on cash flow or payment issues (e.g. 'clients pay late, 60+ day invoices'). ar_aging: Accounts receivable aging notes (e.g. '30%% of invoices over 90 days'). decision_maker_role: Role of the person requesting the diagnosis (e.g. 'CEO', 'COO', 'VP Operations'). stress_indicators: Signs of leadership stress or burnout (e.g. 'working weekends, micromanaging, decision fatigue'). growth_stage: Current business stage (e.g. 'growing', 'stagnant', 'declining', 'startup', 'scaling'). niche: Hyper-specific niche/sub-vertical in free text (e.g. 'B2B SaaS for dental clinics', 'modular construction for retail'). Captured for niche targeting and trend analysis. additional_context: Any other relevant information as free text or JSON. contact_email: Email for follow-up (optional, for lead capture). contact_name: Contact name (optional). lang: Language for the diagnosis ('es' for Spanish, 'en' for English).

Returns: dict: Complete diagnosis containing: - company_name (str): Company analyzed - icp_id (str): Detected industry profile - health_score (float): 0-100 Business Health Score — HIGHER = HEALTHIER. A low score marks the worst area / biggest opportunity. (Also mirrored as revenue_leak_score for backward compatibility, same value.) - score_meaning (str): How to read the score (incl. the "100% = new leagues" idea) - growth_mode (bool): True when most areas are strong — keep the conversation going - guidance (str): What to do next (ask more vs. present + 3 options) - estimated_monthly_leak (str): Estimated monthly revenue leak in weak areas - dimensions (list): Per-dimension scores and findings - actions (list): Prioritized recommendations with triple option - validation_questions (list): Questions to refine the diagnosis - summary (str): Executive summary - leadership_insight (str): Leadership-specific observation

On rate limit:
    - error (str): 'rate_limit_exceeded'
    - message_es / message_en (str): Localized error message
    - upgrade_url (str): Registration URL

FREE quick scan — 3 generic problems identified.

No context needed. Just company name + optional description. Returns 3 generic problems based on industry signals.

Use this to give immediate value before proposing business_diagnose.

Args: company_name: Name of the company (optional). industry: Industry or sector (optional). description: Brief description of what the company does (optional). lang: Language ('es' for Spanish, 'en' for English).

Returns: dict: Contains: - company_name (str): Company analyzed - problems (list): 3 generic problems identified - next_step (str): Call to action for full diagnosis - is_free (bool): Always True for quick_scan

List available industry benchmarks for CIA diagnosis.

Returns the industries with calibrated benchmarks (Tier 1 = premium, deep analysis). Any other industry works too via the generic benchmark.

Returns: dict: Contains: - industries (list[str]): Available benchmark IDs (e.g. ['construction', 'healthcare', 'agency', ...]) - note_es (str): Spanish explanation - note_en (str): English explanation

Recommend the BEST free/OSS/paid tools per business dimension.

Backed by CIA's curated tool registry (tools_registry/), which is refreshed weekly and supports per-industry specialization. Each tool carries why_best — why CIA picked it. Gives immediate, actionable value before any commercial conversation.

Use AFTER business_diagnose to recommend tools for weak dimensions. Pass industry to get industry-specific picks where available.

Args: dimensions: Comma-separated dimensions to get tools for. Options: finanzas, comercial, operaciones, equipo, tecnologia, marketing, clientes, proveedores, legal, estrategia, marketing_digital. Leave empty for ALL dimensions. industry: ICP id (e.g. 'construction') for industry-specific picks. lang: Language ('es' or 'en').

Returns: dict: Tool recommendations grouped by dimension with name, tier (free/oss/paid), url, description, and why_best.

Generate a prioritized 30/60/90 day action plan based on diagnosis.

Creates a realistic, phased implementation roadmap. Prioritizes by ROI and ease of implementation. Each action includes DIY option and CIA-assisted option.

Use AFTER business_diagnose to create a roadmap from the results.

Args: company_name: Name of the company. revenue_leak_score: Business Health Score from diagnosis (0-100, HIGHER = healthier). top_dimensions: Comma-separated weakest dimensions from diagnosis (e.g. 'tecnologia, marketing_digital, operaciones'). team_size: Number of employees (affects plan complexity). budget_level: 'low' ($0-500/mo), 'medium' ($500-2000/mo), 'high' ($2000+/mo). lang: Language ('es' or 'en').

Returns: dict: Phased action plan with 30/60/90 day milestones, each containing specific actions, tools, expected outcomes, and DIY vs CIA-assisted options.

Project ROI from implementing diagnosis recommendations.

Shows the client exactly how much money they're leaving on the table and what they'd recover at different implementation levels. Numbers create urgency. Urgency creates action.

Use AFTER business_diagnose or action_plan.

Args: monthly_revenue: Current monthly revenue (any currency). revenue_leak_score: Business Health Score from diagnosis (0-100, higher = healthier). team_size: Number of employees. currency: Currency code (e.g. 'USD', 'COP', 'MXN', 'EUR'). lang: Language ('es' or 'en').

Returns: dict: ROI projections showing current leak estimate, recovery at 3 levels (DIY/hybrid/full), payback period, and 12-month projection.

Show before/after transformation stories from real implementations.

Social proof is the most powerful sales tool. These cases show what's possible when businesses address their revenue leaks.

Use AFTER roi_projector to validate the numbers with real stories.

Args: industry: Filter by industry (optional). dimension: Filter by dimension improved (optional). lang: Language ('es' or 'en').

Returns: dict: Case studies with before/after metrics, timeline, tools used, and ROI achieved.

Get CIA contact information, services catalog, and booking options.

This is where value converts to action. By this point, the client has received massive free value (diagnosis, tools, plan, ROI, cases) and naturally wants to accelerate with professional help.

Use when the client is ready to take the next step.

Args: lang: Language ('es' or 'en').

Returns: dict: CIA company info, services with pricing tiers, booking link, and contact details.

Generate a shareable diagnosis summary for the client's team.

Creates a structured report object that the LLM can format into any output (PDF, email, presentation, document). Designed to be shared internally to build consensus for implementation.

Use at the END of the journey to give the client something tangible.

Args: company_name: Company name. revenue_leak_score: Score from diagnosis. revenue_leak_score: Business Health Score (0-100, higher = healthier). dimensions_summary: Key dimension scores as text (e.g. 'Finanzas: 3/10, Comercial: 5/10, Operaciones: 3/10'). top_actions: Top 3-5 actions from the plan as text. contact_name: Client contact name. contact_email: Client email for follow-up. lang: Language ('es' or 'en').

Returns: dict: Structured report with all sections ready to format: executive summary, scores, actions, ROI, next steps, and CIA contact info.