diff --git a/README.md b/README.md
index f0c1eaa..ec0c104 100644
--- a/README.md
+++ b/README.md
@@ -75,6 +75,13 @@ Sporel.exe --libs-dir=<libs-path> --test-libs=lib-core.maps-test
 
 Output is TAP version 13 on stdout; exit-code = failure-count (0 = all pass).
 
+## API
+
+### `run_tests(ctx)`
+**Syntax:** `M.run_tests(ctx) → void` (test-lib entrypoint per ADR-0037)
+
+Executes the test-suite against `lib-core.maps`. Calls `engine.exit(engine.test.failures())` at end; exit-code = failure-count.
+
 ## References
 
 - ADR-0037 (Tests-as-Libs Convention)