simulation-harness

Simulate MCP tools and skills โ€” no backends, credentials or side effects.

View on GitHub

  • LanguagePython 3.11+
  • Statusearly (phase 1)
  • LicenseApache-2.0

The Simulation Harness is a platform-agnostic, LLM-driven environment for simulating MCP tools and skills. Agent developers and DevOps engineers can execute tools without real backends, credentials, or the risk of irreversible side effects.

Use cases

  • Catalog exploration โ€” click โ€œTryโ€ in a catalog and see realistic responses in seconds.
  • Skill/tool optimization โ€” run hundreds of optimization trials per hour without burning real API budgets.
  • Course-of-action rehearsal โ€” let agents rehearse potentially irreversible actions before doing them for real.

Highlights

  • One OpenAPI spec โ†’ one simulation โ€” generates a simulation skill and serves schema-valid, plausible responses.
  • MCP-native โ€” exposes tools over SSE and Streamable HTTP to any MCP-capable consumer.
  • Stateful sessions โ€” multi-call coherence with configurable limits and idle timeouts.
  • Zero setup โ€” no credentials, sandboxes or test data required.