Skip to main content
Glama
OpenDSS MCP Server

OpenDSS MCP Server

by NoeCalle

Electric MCP — OpenDSS

MCP server for modeling, simulating, and inspecting MV/LV electrical networks with OpenDSS via OpenDSSDirect.py.

The project's goal is to offer an MCP client high-level electrical tools —creating circuits, adding elements, solving power flow, short circuit, contingencies, and generating one-line diagrams— without giving it direct, unrestricted access to the OpenDSS interpreter.

In addition to the ChatGPT/MCP dialogue, the project can maintain a persistent HTML workspace that acts as a technical viewer for the active circuit. The HTML does not contain a second chatbot nor use a model API: ChatGPT remains the conversational interface, OpenDSS remains the electrical engine, and the workspace is solely a structured view of the state and results.

Status: educational / experimental project. It does not replace a professional electrical study or validated software for design, protection coordination, or arc flash safety.

1. Installation

Requirements: Python 3.10 or higher.

git clone https://github.com/NoeCalle/MCP-Electrico.git
cd MCP-Electrico

python -m venv venv

Windows:

venv\Scripts\activate
pip install -r requirements.txt

Linux/macOS:

source venv/bin/activate
pip install -r requirements.txt

Quick verification:

python -c "import opendssdirect; import mcp; import networkx; print('OK')"

Related MCP server: opendss-mcp-server

2. Testing without an MCP client

The examples import the functions from server.py directly:

python examples/hospital_basico.py
python examples/visualizar_hospital.py
python examples/campus_hospitalario.py
python examples/arc_flash_campus.py
python examples/unifilar_tecnico.py
python examples/workspace_hospital.py

unifilar_tecnico.py generates unifilar_tecnico.svg and unifilar_tecnico.html. workspace_hospital.py generates a persistent workspace_hospital.html with the embedded one-line diagram, calculation state, model data, and buttons for printing/PDF and SVG download.

To run the regression suite:

pip install -r requirements-dev.txt
python -m pytest -q

GitHub Actions runs pytest, generates the technical one-line diagram and the reference workspace, and keeps both as artifacts in each PR.

3. Connecting to an MCP client

Example for Claude Desktop on Windows:

{
  "mcpServers": {
    "opendss": {
      "command": "C:\\ruta\\MCP-Electrico\\venv\\Scripts\\python.exe",
      "args": ["C:\\ruta\\MCP-Electrico\\server.py"]
    }
  }
}

On macOS/Linux, use the venv Python executable and the absolute path to server.py.

4. Available tools

Tool

Function

configurar_workspace

Configures path, title, and automatic regeneration of the HTML viewer

obtener_estado_workspace

Returns revisions, result validity, and registered studies

regenerar_workspace

Forces regeneration of the HTML and companion SVG

crear_circuito

Starts a circuit and clears previous auxiliary state

agregar_linea

Adds line/cable with R1/X1

agregar_transformador

Adds three-phase two-winding transformer

agregar_carga

Adds load, criticality, and optional visual type

configurar_tipo_carga_unifilar

Chooses panelboard, motor, or generic load symbol

configurar_etiqueta_carga_unifilar

Defines engineering label without renaming OpenDSS

configurar_bus_unifilar

Forces bus as physical busbar, logical connection, or auto

configurar_alimentador_unifilar

Adds label, protection, conductor, and ATS/UPS annotations

obtener_configuracion_unifilar

Returns the visual metadata of the active circuit

agregar_generador_respaldo

Adds a genset via the OpenDSS Generator

ejecutar_flujo_potencia

Solves bus voltages and losses

ejecutar_cortocircuito

Runs FaultStudy and returns Isc magnitudes

abrir_elemento

Opens an element and leaves the model solved in that state

cerrar_elemento

Closes an element and re-solves

simular_perdida_alimentador

Runs an N-1 contingency with optional restoration

listar_elementos

Lists buses and main elements

obtener_netlist

Exports and returns the DSS files with their content

generar_diagrama_unifilar

Generates a standalone technical SVG/HTML one-line diagram

estimar_arc_flash_lee

Educational incident energy estimation by Lee

calcular_arc_flash

Alias compatible with previous versions

5. Persistent HTML workspace

The workspace sets a stable path for the active circuit. MCP tools that change the model or its representation regenerate that file automatically.

Conceptual example:

configurar_workspace(
    "workspace.html",
    titulo="Hospital — Sistema eléctrico",
    auto_regenerar=True,
)

crear_circuito("hospital", 22.9)
agregar_transformador(...)
agregar_linea(...)
agregar_carga(...)
ejecutar_flujo_potencia()

5.1 State and revisions

The workspace distinguishes:

  • EMPTY: no usable model exists;

  • MODIFIED: the model changed after the last solution;

  • SOLVED: the current revision matches the solved revision;

  • ERROR: a relevant electrical error/non-convergence exists.

model_revision, solved_revision, and visual_revision are maintained. An electrical change automatically invalidates previous studies; a purely visual change does not invalidate a correct solution.

Each study keeps the revision with which it was calculated and exposes a valid flag. Thus a historical result can remain traceable without being presented as current.

5.2 HTML and export

The initial version includes:

  • embedded SVG one-line diagram;

  • summary of buses, feeders, loads, and losses;

  • Data tab;

  • embedded and versioned JSON snapshot;

  • Print / PDF button, based on window.print() and print CSS;

  • Download SVG button;

  • Reload file button.

The HTML is self-contained and uses no remote dependencies. The file is rewritten automatically, but an already-open local tab must be refreshed to read the new version. A local server/watch for live updates is left for a later phase.

The guide is in docs/WORKSPACE.md and the full architectural decision in docs/decisions/ADR-0001-workspace-persistente.md.

6. Technical SVG one-line diagram

The visualization avoids the aesthetic of a generic graph. The renderer interprets the electrical model to show physical busbars only when appropriate and collapses purely logical buses by default.

Main principles:

  1. ordered main power flow;

  2. clearly hierarchical physical busbars;

  3. orthogonal and ordered feeders;

  4. head-of-line protection;

  5. consistent symbology for source, transformer, panelboard, motor, ATS, UPS, generator, and ground;

  6. engineering labels independent of the internal OpenDSS name;

  7. distinguishable visual protections: breaker, MCCB, ACB, fuse, and disconnector;

  8. clean ingenieria mode and diagnostico mode with additional information;

  9. vertical or horizontal orientation;

  10. open elements and de-energized buses visually differentiated.

Example:

agregar_carga(
    "motor_bomba",
    "mcc_01",
    kw=75,
    kvar=30,
    kv=0.48,
    tipo_visual="motor",
)

configurar_alimentador_unifilar(
    "Line.f_critico",
    dispositivos=["ats", "ups"],
    fuente_alterna="Generator.ge_01",
    proteccion="mccb",
    conductor="3x50 mm2 Cu XLPE",
)

ejecutar_flujo_potencia()
generar_diagrama_unifilar("hospital.html", titulo="Hospital — Diagrama unifilar")

If the path ends in .html, a companion vector .svg is also generated. The complete visual specification is in docs/UNIFILAR_TECNICO.md.

ATS and UPS are, for now, representation annotations. They let the one-line diagram document the intended architecture without claiming that OpenDSS already models their internal electronics, transfer, autonomy, or fault contribution. Those annotations do not change impedances or electrical results.

7. N-1 contingencies: coherent state

simular_perdida_alimentador() distinguishes two working modes.

With restaurar=True, the element is opened, OpenDSS solves the contingency, the results are captured, and then the exact original state is restored and re-solved.

With restaurar=False, the element remains open and the circuit stays solved in contingency for inspection and visualization.

The workspace records the contingency study along with the model revision it corresponds to.

8. Critical loads

Loads marked with critica=True are kept as model metadata. During a contingency, for each critical load, its bus, per-unit voltages, energization indicator, and the list of critical loads without voltage are returned.

The internal threshold used to distinguish an essentially de-energized busbar from an energized one is not a service quality compliance criterion.

9. DSS export

obtener_netlist() exports the circuit and returns the directory, Master.dss, number of files, and content of each generated .dss file.

10. Arc Flash: scope and safety

estimar_arc_flash_lee() implements only the simplified Lee equation for learning and order-of-magnitude estimation.

It does not implement the full empirical IEEE 1584-2018 model and does not convert incident energy into a PPE category. calcular_arc_flash() is kept as a compatible alias.

11. Short circuit

dss.Bus.Isc() returns interleaved real and imaginary components. The server explicitly calculates the magnitude of each phasor:

|I| = sqrt(Re(I)^2 + Im(I)^2)

When integrating it with the workspace, the FaultStudy is kept as a study and then a power flow solution is restored before regenerating the viewer. This avoids mixing solution modes in the persistent one-line diagram.

12. Generators and UPS

agregar_generador_respaldo() represents a genset via the OpenDSS Generator object. A power-electronics-based UPS is not presented as equivalent to a synchronous generator.

13. Architecture

MCP-Electrico/
├── server.py
├── mcp_electrico/
│   ├── __init__.py
│   ├── core.py
│   ├── visualization.py
│   ├── visual_state.py
│   ├── visual_symbols.py
│   ├── workspace_state.py
│   └── workspace.py
├── docs/
│   ├── UNIFILAR_TECNICO.md
│   ├── WORKSPACE.md
│   └── decisions/
│       └── ADR-0001-workspace-persistente.md
├── examples/
│   ├── unifilar_tecnico.py
│   └── workspace_hospital.py
├── tests/
├── requirements.txt
└── requirements-dev.txt
  • server.py: MCP tools and orchestration.

  • core.py: electrical logic and OpenDSS state.

  • visualization.py: topological interpretation, layout, and SVG rendering.

  • visual_symbols.py: vector symbol library.

  • visual_state.py: visual metadata that does not alter the calculation.

  • workspace_state.py: revisions, validity, and snapshot contract.

  • workspace.py: rendering/auto-generation of the persistent HTML.

14. Current limitations

  • several elements use positive-sequence parameters R1/X1;

  • there is still no technical cable library with parameter provenance;

  • there is no detailed R0/X0 modeling or impedance matrices;

  • there are no TCC curves or protection coordination;

  • ATS/UPS can be documented visually, but they do not yet have their own detailed electrical model;

  • there is no LoadShape, PV, Storage, capacitors, harmonics, or annual simulation;

  • the workspace does not persist the project between process restarts;

  • an open local HTML requires manual refresh to read a regeneration;

  • the specific voltage drop, flow, short-circuit, and contingency views are planned on the v1 snapshot but are not yet part of the workspace;

  • the SVG is a technical one-line diagram, not a contractual CAD drawing or a complete IEC/ANSI standards library;

  • Arc Flash is only an educational Lee estimation.

The next leap for the workspace will be incorporating visual interaction with element selection and, afterward, flow and voltage drop overlays without breaking the snapshot contract defined in this phase.

Available Tools

127 tools
abrir_elementoC

Abre un elemento, resuelve y sincroniza la revisión persistente.

Inputs: nombre_elemento (required).

abrir_elemento_sin_resolverA

Abre un elemento sin Solve ni regeneración de archivo workspace.

Inputs: nombre_elemento (required).

agregar_cargaC

Agrega una carga y permite escoger su símbolo en el unifilar.

Inputs: kw (required), bus (required), nombre (required), kv, +4 more. Returns: result

agregar_generador_respaldoC

Agrega un grupo electrógeno/modelo Generator de OpenDSS.

Inputs: kv (required), kw (required), bus (required), nombre (required), +1 more. Returns: result

agregar_lineaC

Agrega una línea/cable y marca el workspace como MODIFICADO.

Inputs: bus1 (required), bus2 (required), nombre (required), longitud_km (required), +3 more. Returns: result

agregar_transformadorC

Agrega un transformador trifásico de dos devanados.

Inputs: kva (required), nombre (required), kv_primario (required), bus_primario (required), +4 more. Returns: result

agregar_transformador_profesionalB

Crea un transformador P2 sin completar %Z, X/R, pérdidas o taps con defaults silenciosos.

Inputs: kva (required), kv_hv (required), kv_lv (required), bus_hv (required), +18 more.

analizar_caida_tensionB

Analiza ΔV por alimentador con un límite configurable por el usuario.

El valor por defecto de 3 % NO se presenta como requisito normativo universal. OpenDSS resuelve las tensiones y el MCP deriva la comparación bus1→bus2 sobre la revisión vigente.

Inputs: limite_pct.

analizar_flujo_operacionB

Devuelve flujo detallado OpenDSS por alimentador y actualiza el workspace.

Inputs: no named parameters.

aplicar_conductorB

Asigna un conductor de catálogo a Line.* e invalida resultados previos.

R1/X1 se actualizan únicamente cuando el fabricante publica ambos para la formación elegida. La ampacidad puede aplicarse de forma independiente mediante NormAmps y metadatos del workspace.

Inputs: codigo (required), instalacion (required), nombre_elemento (required), actualizar_impedancia.

auditar_modeloB

Ejecuta QA determinístico y reporta si el modelo puede habilitarse para emisión.

Inputs: estudios_requeridos.

calcular_arc_flashD

Alias compatible con la API v0.5.

Inputs: voltaje_kv (required), tiempo_despeje_s (required), corriente_falla_ka (required), distancia_trabajo_mm.

cerrar_elementoC

Cierra un elemento, resuelve y sincroniza la revisión persistente.

Inputs: nombre_elemento (required).

cerrar_elemento_sin_resolverC

Cierra un elemento sin Solve ni regeneración de archivo workspace.

Inputs: nombre_elemento (required).

configurar_alimentador_unifilarB

Configura metadatos visuales de un alimentador sin tocar OpenDSS.

Inputs: nombre_elemento (required), etiqueta, conductor, proteccion, +4 more.

configurar_bus_unifilarC

Configura si un bus se dibuja como barra física o conexión lógica.

Inputs: nombre_bus (required), rol, etiqueta.

configurar_etiqueta_carga_unifilarC

Define un rótulo de ingeniería sin renombrar el elemento OpenDSS.

Inputs: etiqueta (required), nombre_carga (required).

configurar_tipo_carga_unifilarC

Cambia el símbolo de una carga sin invalidar la solución eléctrica.

Inputs: tipo_visual (required), nombre_carga (required).

configurar_workspaceC

Configura el visor HTML persistente del circuito activo.

El workspace es solo una vista del modelo. ChatGPT continúa siendo la interfaz conversacional y OpenDSS continúa siendo el motor de cálculo por defecto.

Inputs: titulo, ruta_salida, auto_regenerar.

construir_evidencia_primaria_ampacidadD

Inputs: revisor (required), source_id (required), ruta_archivo (required), referencias_pagina (required), +3 more.

construir_modelo_rev0C

Construye el modelo admitido sin Solve y sin regenerar archivos workspace.

Inputs: manifest (required).

construir_snapshot_proyecto_p7aB

Construye el snapshot canónico en memoria y devuelve su SHA-256.

Inputs: directorio_netlist.

crear_circuitoB

Crea un circuito nuevo con barra de fuente explícita.

Para compatibilidad histórica, bus_fuente conserva "sourcebus" como default. Los flujos profesionales deben declararlo explícitamente.

Inputs: nombre (required), kv_base (required), bus_fuente, frecuencia. Returns: result

definir_ajustes_proteccion_p5aD

Inputs: dispositivo (required), ii_a, ir_a, isd_a, +2 more.

definir_aplicabilidad_normativa_ampacidadD

Inputs: nombre_elemento (required), metodo_instalacion (required), perfil_normativo_id (required), ambiente, +10 more.

definir_condiciones_ampacidadC

Configura Ib/In/Iz; factores P3B secundarios requieren opt-in explícito.

Inputs: norma_id (required), in_proteccion_a (required), nombre_elemento (required), factores, +9 more.

definir_dispositivo_proteccion_p5aD

Inputs: in_a (required), tipo (required), ue_kv (required), nombre (required), +13 more.

definir_red_equivalenteB

Define Scc3/XR máxima y opcional mínima; no infiere secuencia cero.

Inputs: kv_ll (required), x_r_max (required), scc_max_mva (required), x_r_min, +4 more.

definir_secuencia_cero_fuenteB

Define R0/X0 explícitos de la red aguas arriba por escenario; no deriva Z0 desde Scc3.

Inputs: r0_max_ohm (required), x0_max_ohm (required), fuente_url, r0_min_ohm, +2 more.

definir_secuencia_cero_lineaC

Aplica R0/X0 y opcional C0 explícitos a una Line trifásica.

Inputs: r0_ohm_km (required), x0_ohm_km (required), nombre_elemento (required), c0_nf_km, +2 more.

definir_secuencia_cero_transformadorB

Registra datos Z0 de transformador sin asumir Z0=Z1 ni proyectarlos silenciosamente a OpenDSS.

Inputs: uk0_percent (required), ur0_percent (required), nombre_elemento (required), leakage_share_hv (required), +8 more.

ejecutar_arranque_motoresD

Ejecuta estudios estáticos explícitos en contextos OpenDSS aislados.

Inputs: manifest (required).

ejecutar_cortocircuitoC

Calcula Isc y restaura después una solución de flujo para el workspace.

FaultStudy cambia el modo de solución de OpenDSS. El resultado de falla se conserva como estudio, pero el visor vuelve a una solución de flujo normal para no mezclar tensiones de modos distintos en el unifilar persistente.

Inputs: bus_falla (required).

ejecutar_cortocircuito_iec60909_1ph_groundA

Ejecuta IEC 60909 1F-T MAX/MIN con Z0 explícita y registra V4.

No hay despacho automático ni cross-check. La secuencia cero de fuente, líneas y transformadores debe estar declarada y proyectable; MIN exige endtemp_degree explícita por línea. Sk'', ip e Ith no se derivan ni se promocionan para 1F-T en P4C11C. La emisión profesional permanece deshabilitada.

Inputs: bus_falla (required), lv_tol_percent, line_endtemp_degree_c.

ejecutar_cortocircuito_iec60909_2phA

Ejecuta IEC 60909 2F MAX/MIN explícitamente con pandapower experimental.

La falla es fase-fase sin tierra. P4C06 declara Z2=Z1 solo para la red simétrica pasiva actualmente soportada; no es un supuesto universal. MIN exige endtemp_degree explícita por línea e ip/Ith conservan los mismos gates de topología/tiempo/método κ. El resultado se registra en V5/V4 sin habilitar emisión profesional.

Inputs: bus_falla (required), tk_s, topology, kappa_method, +2 more.

ejecutar_cortocircuito_iec60909_2ph_groundC

Ejecuta la extensión operacional 2F-T MAX/MIN y registra V4.

Pandapower se usa exclusivamente para obtener Z1/Z0 del mismo modelo P4; la falla franca b-c-tierra se resuelve con el solver MCP de componentes simétricas auditado. results.ikss_ka representa la mayor corriente RMS de las fases en falla para uso técnico interno; ikss_contractual sigue siendo False hasta cerrar las validaciones normativas pendientes.

Inputs: bus_falla (required), lv_tol_percent, line_endtemp_degree_c.

ejecutar_cortocircuito_iec60909_3phA

Ejecuta IEC 60909 3F MAX/MIN explícitamente con pandapower experimental.

No hay despacho automático ni cross-check. El escenario MIN conserva la exigencia de endtemp_degree explícita por línea y ip/Ith solo se calculan con topología, tiempo de despeje y método κ declarados. El estudio se registra en V5/V4, pero professional_emission permanece en false.

Inputs: bus_falla (required), tk_s, topology, kappa_method, +2 more.

ejecutar_escenarios_operativosC

Ejecuta únicamente las maniobras/estados declarados en el paquete P12.

Inputs: manifest (required), paquete_escenarios (required).

ejecutar_flujo_pandapowerA

Resuelve explícitamente con pandapower dentro del alcance experimental v1.

No compara contra OpenDSS, no selecciona motores automáticamente y no modifica la solución base del workspace. Si el modelo contiene elementos todavía no soportados, devuelve el rechazo y sus códigos de compatibilidad.

Inputs: no named parameters.

ejecutar_flujo_potenciaB

Resuelve flujo con OpenDSS y actualiza la vista detallada.

Inputs: no named parameters.

ejecutar_perfiles_arranque_motoresC

Resuelve únicamente los puntos explícitos de los perfiles P13C.

Inputs: manifest (required), paquete_perfiles (required).

ejecutar_secuencias_arranque_motoresC

Ejecuta las secuencias estáticas declaradas en contextos aislados.

Inputs: manifest (required), paquete_perfiles (required), paquete_secuencias (required).

estimar_arc_flash_leeC

Estimación educativa de energía incidente mediante el método de Lee.

Inputs: voltaje_kv (required), tiempo_despeje_s (required), corriente_falla_ka (required), distancia_trabajo_mm.

evaluar_admision_piloto_realC

Revisa presencia/trazabilidad de entradas sin construir ni calcular el modelo.

Inputs: manifest (required).

evaluar_ampacidadD

Inputs: nombre_elemento.

evaluar_capacidad_corte_p5cC

Compara la falla con Icu o poder de corte sin sustituir ratings.

Inputs: dispositivo (required), fuente_corriente (required), corriente_falla_ka (required), tension_operacion_kv (required), +2 more.

evaluar_cierre_p2C

Evalúa el contrato de producto P2 v1 y la coherencia del modelo activo.

Inputs: no named parameters.

evaluar_cierre_p3A

Evalúa el gate formal P3; hoy debe bloquear avance mientras falte evidencia/cobertura normativa.

Inputs: no named parameters.

evaluar_cierre_p5B

Evalúa si P5-v1 está listo con limitaciones para entregar a P7.

Inputs: no named parameters.

evaluar_cierre_p7d_engineering_previewC

Evalúa el gate de MCP Eléctrico 0.9 sin habilitar emisión profesional.

Inputs: no named parameters.

evaluar_cierre_p8f5_uso_real_controladoC

Evalúa el gate final P8 sin ejecutar ingeniería ni habilitar emisión profesional.

Inputs: no named parameters.

evaluar_coordinacion_temporal_p5eC

Evalúa margen temporal puntual; no declara selectividad total/backup.

Inputs: fuente_relacion (required), margen_minimo_s (required), fuente_corrientes (required), corriente_upstream_a (required), +3 more.

evaluar_curva_tcc_p5bC

Evalúa la curva vinculada solo dentro del dominio publicado.

Inputs: current_a (required), dispositivo (required).

evaluar_dataset_tcc_p5bD

Inputs: current_a (required), dataset_id (required).

evaluar_evidencia_normativa_ampacidadB

Clasifica evidencia de factores sin cambiar READY_DATA ni madurez P3.

Inputs: no named parameters.

evaluar_preparacion_estudioD

Separa completitud de datos, aptitud del backend y disponibilidad del módulo.

Inputs: estudio (required), norma, tipo_falla, permitir_experimental.

evaluar_preparacion_proteccion_p5aD

Evalúa datos/capacidad de corte y conserva el contrato P5A.

Inputs: dispositivo (required).

evaluar_promocion_dataset_ampacidadD

Inputs: evidencia (required), dataset_id (required).

evaluar_soportabilidad_termica_conductor_p5cC

Evalúa I²t <= k²S² con k, sección y tiempo explícitos/trazables.

Inputs: elemento (required), fuente_k (required), seccion_mm2 (required), fuente_tiempo (required), +4 more.

evaluar_tiempo_despeje_p5dD

Promueve a clearing time solo TOTAL_CLEARING_TIME dentro de dominio.

Inputs: current_a (required), dispositivo (required).

exportar_reporte_desde_archivo_p7cC

Carga un snapshot P7A JSON y genera el mismo reporte técnico P7C.

Inputs: ruta_snapshot (required), ruta_salida.

exportar_reporte_tecnico_p7cC

Genera HTML reproducible desde un snapshot P7A con hash válido.

Inputs: snapshot (required), ruta_salida.

exportar_snapshot_proyecto_p7aC

Exporta el snapshot JSON sin sobrescribir archivos previos.

Inputs: ruta_salida, directorio_netlist.

generar_diagrama_unifilarC

Genera un unifilar técnico SVG/HTML independiente del workspace.

Inputs: modo, titulo, orientacion, ruta_salida, +3 more.

generar_dossier_arranque_motoresC

Genera Workspace y dossier P13 con replay e integridad SHA-256.

Inputs: manifest (required), paquete_perfiles (required), paquete_secuencias (required), directorio_salida.

generar_dossier_escenarios_operativosC

Genera dossier P12 reproducible desde escenarios explícitos.

Inputs: manifest (required), paquete_escenarios (required), directorio_salida.

generar_dossier_piloto_realB

Ejecuta el piloto real y genera una entrega íntegra sin sobrescribir previas.

La operación falla cerrada si P8D2 no completa o si P8F2 no puede verificar el conjunto exacto de artefactos por SHA-256. Si el directorio solicitado ya contiene una entrega, P8F3 crea un sufijo incremental en vez de modificarla. No selecciona motor, falla, caso, curva ni rating automáticamente y no habilita emisión profesional.

Inputs: manifest (required), directorio_salida.

listar_conductoresC

Lista productos BT/MT trazables de la biblioteca técnica.

Inputs: nivel, familia. Returns: result

listar_datasets_curva_tcc_p5bD

Inputs: no named parameters. Returns: result

listar_datasets_numericos_ampacidadD

Inputs: no named parameters. Returns: result

listar_elementosB

Lista buses, líneas, transformadores, cargas y generadores.

Inputs: no named parameters.

listar_fuentes_primarias_ampacidadD

Inputs: no named parameters. Returns: result

listar_perfiles_normativos_ampacidadD

Inputs: no named parameters. Returns: result

listar_referencias_ampacidadD

Inputs: no named parameters. Returns: result

obtener_asignaciones_conductoresB

Devuelve conductores de catálogo asignados al circuito activo.

Inputs: no named parameters.

obtener_capacidades_motoresB

Devuelve la matriz determinista OpenDSS/pandapower/MCP sin ejecutar estudios.

Inputs: no named parameters.

obtener_checklist_p8f5_datos_proyecto_realA

Devuelve los datos/procedencias que deben sustituirse antes de una corrida real.

Inputs: no named parameters.

obtener_conductorC

Devuelve ficha, instalaciones, parámetros y fuente de un conductor.

Inputs: codigo (required).

obtener_configuracion_unifilarC

Devuelve los metadatos de representación visual del circuito activo.

Inputs: no named parameters.

obtener_contrato_arranque_motoresB

Devuelve contratos de arranque estático, perfiles y secuencias P13.

Inputs: no named parameters.

obtener_contrato_construccion_rev0C

Devuelve la ruta recomendada para construir Rev.0 sin Solve.

Inputs: no named parameters.

obtener_contrato_coordinacion_p5eD

Inputs: no named parameters.

obtener_contrato_dinamica_motoresC

Describe datos físicos P13F1 y gates pendientes del backend dinámico.

Inputs: no named parameters.

obtener_contrato_p12_escenarios_operativosC

Devuelve alcance, acciones y fronteras fail-closed de P12.

Inputs: no named parameters.

obtener_contrato_p8b_admision_realC

Devuelve el contrato fail-closed de ingreso de datos del piloto real.

Inputs: no named parameters.

obtener_contrato_p8f1_piloto_realC

Devuelve el contrato del entrypoint integral del primer proyecto real.

Inputs: no named parameters.

obtener_contrato_p8f2_integridad_dossierB

Devuelve el contrato SHA-256 del dossier Engineering Preview.

Inputs: no named parameters.

obtener_contrato_p8f3_repeticion_dossierB

Devuelve la política de repetición, aislamiento y no sobrescritura.

Inputs: no named parameters.

obtener_contrato_p8f4_primer_usoB

Devuelve la secuencia pública y estados de reparación del primer uso P8.

Inputs: no named parameters.

obtener_contrato_protecciones_p5aC

Devuelve alcance, semántica y políticas fail-closed del bloque P5A.

Inputs: no named parameters.

obtener_contrato_reconstruccion_p7bB

Devuelve las reglas fail-closed de reconstrucción P7B.

Inputs: no named parameters.

obtener_contrato_reporte_p7cB

Devuelve el contrato fail-closed del reporte técnico P7C.

Inputs: no named parameters.

obtener_contrato_tiempo_despeje_p5dD

Inputs: no named parameters.

obtener_datos_profesionalesB

Devuelve datos P2 positivos y homopolares con procedencia y derivaciones.

Inputs: no named parameters.

obtener_estado_ampacidadD

Inputs: no named parameters.

obtener_estado_protecciones_p5aD

Inputs: no named parameters.

obtener_estado_workspaceA

Devuelve ruta, revisiones, validez de resultados y estudios registrados.

Inputs: no named parameters.

obtener_matriz_validacionC

Devuelve la madurez técnica declarada de cada módulo.

Inputs: no named parameters.

obtener_netlistC

Exporta el circuito y devuelve todos los archivos DSS y su contenido.

Inputs: directorio.

obtener_placeholders_modeloC

Devuelve TBC explícitos que aún bloquean preparación de estudio.

Inputs: no named parameters.

obtener_plan_validacion_dinamica_motoresC

Devuelve candidatos sin calificar, oráculos analíticos y casos pendientes.

Inputs: no named parameters.

obtener_referencias_proteccion_p5cC

Devuelve referencias objetivo y alcance explícito de P5C.

Inputs: no named parameters.

obtener_secuencia_ceroB

Devuelve la ficha P2 de secuencia cero de fuente, líneas y transformadores.

Inputs: no named parameters.

reconstruir_archivo_proyecto_p7bC

Carga un JSON P7A desde archivo y aplica el mismo gate P7B.

Inputs: ruta_snapshot (required), directorio_reconstruccion.

reconstruir_snapshot_proyecto_p7bC

Verifica hash, reconstruye DSS y exige round-trip canónico.

Inputs: snapshot (required), directorio_reconstruccion.

regenerar_workspaceB

Regenera manualmente el HTML, SVG y vistas de estudios.

Inputs: no named parameters.

registrar_dataset_curva_tcc_p5bC

Registra puntos TCC explícitos; no digitaliza ni inventa curvas.

Inputs: shape (required), curve_id (required), segments (required), dataset_id (required), +6 more.

registrar_placeholder_modeloC

Registra un TBC sin crear un elemento eléctrico ficticio en OpenDSS.

Inputs: element_id (required), element_type (required), missing_fields (required), note, +2 more.

resolver_base_normativa_ampacidadD

Resuelve Tabla 1/2 exacta y devuelve base_p3 portable si existe.

Inputs: consulta (required), dataset_id (required), permitir_dataset_secundario.

resolver_factor_agrupamiento_ampacidadC

Resuelve agrupamiento y, si existe valor, devuelve factor_p3 trazable.

Inputs: disposicion_id (required), nombre_elemento (required), circuitos_agrupados (required), permitir_dataset_secundario.

resolver_factor_normativo_ampacidadC

Resuelve un factor exact_rows_v1 y devuelve factor_p3 portable.

La resolución exacta no basta para aplicarlo: definir_condiciones_ampacidad revalida después su compatibilidad con routing P3A e Iz_base normativa.

Inputs: consulta (required), dataset_id (required), permitir_dataset_secundario.

seleccionar_escenario_redC

Activa el escenario máximo o mínimo y reaplica Z0 solo si existe para ese escenario.

Inputs: escenario (required).

seleccionar_motor_estudioC

Indica backend, requisitos y aptitud actual; no despacha el cálculo automáticamente.

Inputs: estudio (required), norma, tipo_falla, permitir_experimental.

simular_perdida_alimentadorC

Simula una contingencia N-1 y la registra en el workspace.

Inputs: nombre_elemento (required), restaurar.

validar_arranque_motoresC

Evalúa admisión y preparación P13 sin resolver la red.

Inputs: manifest (required).

validar_construccion_rev0C

Valida intake + preflight del materializador sin mutar OpenDSS.

Inputs: manifest (required).

validar_datos_dinamica_motoresD

Admite datos físicos explícitos; no materializa ni integra un motor.

Inputs: manifest (required), paquete_dinamico (required).

validar_escenarios_operativosB

Valida escenarios explícitos sin construir ni calcular el modelo.

Inputs: manifest (required), paquete_escenarios (required).

validar_perfiles_arranque_motoresC

Valida los puntos de perfil declarados sin ejecutar estudios.

Inputs: manifest (required), paquete_perfiles (required).

validar_secuencias_arranque_motoresC

Valida secuencias multi-motor sin inferir orden ni tiempos.

Inputs: manifest (required), paquete_perfiles (required), paquete_secuencias (required).

verificar_archivo_fuente_ampacidadD

Inputs: source_id (required), ruta_archivo (required).

verificar_integridad_dossier_arranque_motoresC

Verifica el inventario y los hashes del dossier P13.

Inputs: ruta_indice (required).

verificar_integridad_dossier_escenariosC

Verifica SHA-256 y file-set del dossier P12.

Inputs: ruta_indice (required).

verificar_integridad_dossier_realC

Revalida un dossier copiado usando su dossier_integrity.json.

Inputs: ruta_indice (required).

verificar_snapshot_proyecto_p7aC

Verifica schema/hash sin reconstruir el modelo.

Inputs: snapshot (required).

vincular_curva_proteccion_p5aD

Inputs: curva_id (required), tipo_curva (required), dispositivo (required), fuente_referencia (required), +2 more.

vincular_dataset_curva_tcc_p5bD

Inputs: dataset_id (required), dispositivo (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.2/5.0

    Scored across 127 tools

    Disambiguation2/5

    127 tools with many phase-specific variants (e.g., multiple IEC 60909 cortocircuito tools, many obtener_contrato_* and evaluar_cierre_* tools) create overlapping boundaries. Aliases like calcular_arc_flash vs estimar_arc_flash_lee and paired abrir/cerrar_elemento vs *_sin_resolver make misselection likely despite detailed descriptions.

    Naming Consistency4/5

    Consistent snake_case verb_noun pattern in Spanish throughout. Minor deviations include an explicit alias (calcular_arc_flash) and phase suffixes (P5A, P7A, etc.) that add noise but remain predictable.

    Tool Count1/5

    127 tools far exceeds typical scope; even for a complex engineering server this is an extreme mismatch that makes discovery and selection difficult.

    Completeness4/5

    The surface covers a wide lifecycle (circuit creation, element addition, power flow, short circuit, protection, arc flash, snapshots, dossiers, integrity checks). Minor gaps include no explicit delete/update for added elements, but many validation/contract tools fill adjacent roles.

    Maintenance

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables conversational power system analysis by connecting Claude AI with EPRI's OpenDSS simulator. Allows distribution planning engineers to perform sophisticated electrical grid studies through natural language instead of complex scripting.
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      MCP server that exposes the UAM vertiport simulator as tools for AI-assisted analysis, enabling simulations, KPI analysis, and what-if studies via Claude Desktop.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for the OpenEMT electromagnetic transient simulator, enabling AI agents to enumerate the physics catalog, build circuits, solve power flow and EMT studies, and query simulation results by stable block ID.
      10 npm
      5
      AGPL 3.0