diff --git a/mypy.ini b/mypy.ini
new file mode 100644
index 0000000..be02493
--- /dev/null
+++ b/mypy.ini
@@ -0,0 +1,11 @@
+[mypy]
+python_version = 3.13
+explicit_package_bases = True
+show_error_codes = True
+warn_unused_configs = True
+ignore_missing_imports = True
+# Expand to the whole workspace; temporarily exclude obvious duplicates to get broader feedback
+files = .
+
+# The API directory now defines a package root so we can run mypy on it directly.
+# Per-package overrides can be added here later as we gradually expand coverage