Skip to content

idfkit-mcp

A production-ready MCP server for EnergyPlus workflows: schema discovery, model editing, integrity checks, QA diagnostics, peak-load analysis, and simulation via idfkit.

Release Build status License

Install & Configure Tool Reference

35 MCP tools Schema-aware edits Validation + integrity checks Weather search + download Simulation QA diagnostics Peak loads + report viewers Geometry + schedule viewers Codex + Claude workflows

What You Get

  • A single MCP server that covers the EnergyPlus model lifecycle:
  • schema exploration
  • model read/write operations
  • schema validation and domain integrity checks
  • weather station search and EPW download
  • simulation runs with structured QA diagnostics
  • peak-load analysis and tabular report browsing
  • interactive geometry, schedule, and simulation viewers
  • Predictable, structured tool responses for autonomous agents.
  • Workflow compatibility across Codex, Claude, and other MCP-capable clients.
  1. load_model or new_model (or read idfkit://model/summary resource)
  2. describe_object_type before edits
  3. batch_add_objects for bulk creation
  4. validate_model after modifications
  5. check_model_integrity
  6. run_simulation
  7. Read idfkit://simulation/results, then analyze_peak_loads or view_simulation_report

Quick Workflow Example

1) new_model(version="24.1.0")
2) describe_object_type(object_type="Zone")
3) batch_add_objects(objects=[...])
4) validate_model(check_references=True)
5) check_model_integrity()
6) download_weather_file(query="Chicago")
7) run_simulation(annual=True)
8) read idfkit://simulation/results resource
9) analyze_peak_loads()

Explore the Docs

  • Get Started

    Install the server, configure MCP clients, and run your first end-to-end session.

    Get Started

  • Agent Workflows

    Practical patterns for Codex, Claude, and multi-agent orchestration.

    Agent Workflows

  • Tool Reference

    Parameter-by-parameter guidance for all tools and expected outputs.

    Tool Reference

  • Concepts

    Understand state management, safety constraints, and failure semantics.

    Concepts

  • Troubleshooting

    Resolve setup, schema, weather, and simulation issues quickly.

    Troubleshooting

  • API Reference

    Module-level reference generated from source docstrings.

    API Reference