diff --git a/src/colony/base/vars.pyi b/src/colony/base/vars.pyi
new file mode 100644
index 00000000..c40795d9
--- /dev/null
+++ b/src/colony/base/vars.pyi
@@ -0,0 +1,9 @@
+from typing import Any, Mapping, TypeVar
+
+GLOBALS: Mapping[str, Any] = ...
+
+T = TypeVar("T")
+
+def set_global(name: str, value: Any) -> None: ...
+def get_global(name: str, default: T | None = ...) -> T | None: ...
+def has_global(name: str) -> bool: ...