diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0b6643a..ecda7d2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,19 @@ All notable changes to the SochDB Python SDK will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Fixed
+
+- **PEP 561 `py.typed` marker was missing from the built wheel.** The SDK is
+  fully type-annotated, but downstream `mypy` / Pyright silently skipped
+  analyzing `sochdb` (`"module is installed, but missing library stubs or
+  py.typed marker"`) because the marker was neither present under
+  `src/sochdb/` nor listed in `[tool.setuptools.package-data]`. Adds an empty
+  `src/sochdb/py.typed` and includes it in `package-data` so it lands inside
+  the wheel. Consumers now see the shipped type annotations. No API or ABI
+  change.
+
 ## [0.8.1] - 2026-06-24
 
 ### Changed
diff --git a/pyproject.toml b/pyproject.toml
index d0e4f43..6bda236 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -86,6 +86,8 @@ where = ["src"]
 [tool.setuptools.package-data]
 # Include bundled native libraries for each platform
 sochdb = [
+    # PEP 561 type-information marker (advertises this package as fully typed)
+    "py.typed",
     # Shared libraries (FFI) - platform-specific directories
     "lib/*/*.so",
     "lib/*/*.dylib", 
diff --git a/src/sochdb/py.typed b/src/sochdb/py.typed
new file mode 100644
index 0000000..e69de29