From 7d38f1c75757f4cfd75b4887a084b3701e3fab80 Mon Sep 17 00:00:00 2001
From: Richard Gebhardt <richard.gebhardt@oracle.com>
Date: Mon, 24 Nov 2025 12:03:21 -0500
Subject: [PATCH] feat: add publish scripts

Signed-off-by: Richard Gebhardt <richard.gebhardt@oracle.com>
---
 Makefile  | 14 ++++++++++++++
 README.md | 27 +++++++++++++++++++++++++++
 2 files changed, 41 insertions(+)

diff --git a/Makefile b/Makefile
index 1b9467ee..69770941 100644
--- a/Makefile
+++ b/Makefile
@@ -62,6 +62,20 @@ combine-coverage:
 	uv run coverage html
 	uv run coverage report --fail-under=69
 
+test-publish:
+	@for dir in $(SUBDIRS); do \
+		cd $$dir && \
+		uv publish --publish-url https://test.pypi.org/legacy/ --check-url=https://test.pypi.org/simple/ && \
+		cd ../..; \
+	done
+
+publish:
+	@for dir in $(SUBDIRS); do \
+		cd $$dir && \
+		uv publish --check-url=https://pypi.org/simple/ && \
+		cd ../..; \
+	done
+
 format:
 	uv tool run --from 'tox==4.30.2' tox -e format
 
diff --git a/README.md b/README.md
index cb863a36..5531ec1c 100644
--- a/README.md
+++ b/README.md
@@ -337,6 +337,33 @@ make lint
 make test
 ```
 
+## Publishing
+
+### Publish & verify test packages
+
+Publish packages to PyPI test registry:
+```bash
+UV_PUBLISH_TOKEN=$(cat /path/to/testpypi/token-file) make test-publish
+```
+
+Verify installation:
+```bash
+uv run --index=https://test.pypi.org/simple <mcp server package>
+```
+example:
+```bash
+uv run --index=https://test.pypi.org/simple oracle.oci-api-mcp-server
+```
+
+### Publish packages
+
+>[!IMPORTANT]
+> NOTE: The `UV_PUBLISH_TOKEN` differs for Test PyPI and PyPI.
+
+```bash
+UV_PUBLISH_TOKEN=$(cat /path/to/pypi/token-file) make publish
+```
+
 ## Contributing
 
 This project welcomes contributions from the community. Before submitting a pull