OpenDSS MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@OpenDSS MCP Server Model a hospital with a 13.2 kV feed, 500 kVA transformer to 0.4 kV, and critical OR loads. Run power flow."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 venvWindows:
venv\Scripts\activate
pip install -r requirements.txtLinux/macOS:
source venv/bin/activate
pip install -r requirements.txtQuick 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.pyunifilar_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 -qGitHub 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 |
| Configures path, title, and automatic regeneration of the HTML viewer |
| Returns revisions, result validity, and registered studies |
| Forces regeneration of the HTML and companion SVG |
| Starts a circuit and clears previous auxiliary state |
| Adds line/cable with R1/X1 |
| Adds three-phase two-winding transformer |
| Adds load, criticality, and optional visual type |
| Chooses panelboard, motor, or generic load symbol |
| Defines engineering label without renaming OpenDSS |
| Forces bus as physical busbar, logical connection, or auto |
| Adds label, protection, conductor, and ATS/UPS annotations |
| Returns the visual metadata of the active circuit |
| Adds a genset via the OpenDSS |
| Solves bus voltages and losses |
| Runs |
| Opens an element and leaves the model solved in that state |
| Closes an element and re-solves |
| Runs an N-1 contingency with optional restoration |
| Lists buses and main elements |
| Exports and returns the DSS files with their content |
| Generates a standalone technical SVG/HTML one-line diagram |
| Educational incident energy estimation by Lee |
| 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;
Datatab;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:
ordered main power flow;
clearly hierarchical physical busbars;
orthogonal and ordered feeders;
head-of-line protection;
consistent symbology for source, transformer, panelboard, motor, ATS, UPS, generator, and ground;
engineering labels independent of the internal OpenDSS name;
distinguishable visual protections: breaker, MCCB, ACB, fuse, and disconnector;
clean
ingenieriamode anddiagnosticomode with additional information;vertical or horizontal orientation;
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.txtserver.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 toolsabrir_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
Scored across 127 tools
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.
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.
127 tools far exceeds typical scope; even for a complex engineering server this is an extreme mismatch that makes discovery and selection difficult.
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
Related MCP Connectors
Protocol-native energy infrastructure orchestration for AI data centers. Provides 46 MCP tools across 8 grid protocols (IEC-61850, DNP3, Modbus, OCPP, OpenADR, IEEE 2030.5, IEC 60870-5-104, ICCP) with 5 core API primitives: connect, dispatch, settle, comply, and intel. Enables AI agents to programmatically interact with substations, grid interfaces, and energy assets for real-time workload-grid coordination.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server for aerospace calculations: orbital mechanics, ephemeris, DSN operations, ...
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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
- AlicenseNot gradedqualityDmaintenanceConnects Claude AI with EPRI's OpenDSS power system simulator, enabling conversational power system analysis for distribution planning.4MIT
- FlicenseNot gradedqualityCmaintenanceMCP server that exposes the UAM vertiport simulator as tools for AI-assisted analysis, enabling simulations, KPI analysis, and what-if studies via Claude Desktop.-
- AlicenseNot gradedqualityCmaintenanceMCP 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 npm5AGPL 3.0