release: v0.3.1

Author: Guotong

CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.3.1 - 2026-03-18
+
+- CI: publish workflow now skips PyPI upload when `PYPI_API_TOKEN` is not configured.
+- Docs: added explicit PyPI token vs trusted publisher guidance to publish runbook.
+
 ## 0.3.0 - 2026-03-18
 
 - Added external `$ref` resolution across local files and URLs.

README.md

@@ -148,6 +148,7 @@ CI and release workflows are provided in `.github/workflows/`.
 - [docs/launch-checklist.md](docs/launch-checklist.md)
 - [docs/post-template.md](docs/post-template.md)
 - [docs/release/v0.3.0-release-notes.md](docs/release/v0.3.0-release-notes.md)
+- [docs/release/v0.3.1-release-notes.md](docs/release/v0.3.1-release-notes.md)
 - [docs/release/launch-copies.md](docs/release/launch-copies.md)
 - [docs/release/repo-branding.md](docs/release/repo-branding.md)
 - [docs/release/publish-runbook.md](docs/release/publish-runbook.md)

docs/release/publish-runbook.md

@@ -1,4 +1,4 @@
-# Publish Runbook (v0.3.0)
+# Publish Runbook
 
 ## 0) Fill placeholders
 
@@ -34,19 +34,19 @@ conda run -n openapi-mcp openapi-to-mcp list examples/swagger2.yaml --json
 ```bash
 git init
 git add .
-git commit -m "release: v0.3.0"
+git commit -m "release: vX.Y.Z"
 git branch -M main
 git remote add origin https://github.com/vect-G/openapi-to-mcp.git
 git push -u origin main
-git tag v0.3.0
-git push origin v0.3.0
+git tag vX.Y.Z
+git push origin vX.Y.Z
 ```
 
 ## 3) Create GitHub Release
 
-- Tag: `v0.3.0`
-- Title: `openapi-to-mcp v0.3.0`
-- Body: copy `docs/release/v0.3.0-release-notes.md`
+- Tag: `vX.Y.Z`
+- Title: `openapi-to-mcp vX.Y.Z`
+- Body: copy matching release notes from `docs/release/`
 
 ## 4) Publish announcement
 

docs/release/v0.3.1-release-notes.md

@@ -0,0 +1,34 @@
+# openapi-to-mcp v0.3.1
+
+Release date: 2026-03-18
+
+## TL;DR
+
+This is a release-process patch.
+
+- Publish workflow no longer fails when `PYPI_API_TOKEN` is missing.
+- If token is not configured, PyPI upload is skipped with a clear message.
+- Publish runbook now documents API token mode vs Trusted Publisher mode.
+
+## Why this release
+
+Some users saw failed checks on tag pushes due PyPI Trusted Publisher mismatch (`invalid-publisher`).
+This patch prevents unnecessary red checks for repositories that haven't configured PyPI yet.
+
+## What changed
+
+- `.github/workflows/publish.yml`
+  - Skip publish step when `PYPI_API_TOKEN` is not set.
+  - Print guidance message instead of failing.
+- `docs/release/publish-runbook.md`
+  - Added setup guidance for PyPI token and Trusted Publisher.
+
+## Upgrade
+
+```bash
+pip install -U openapi-to-mcp
+```
+
+## Notes
+
+Core feature behavior is unchanged from v0.3.0.

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "openapi-to-mcp"
-version = "0.3.0"
+version = "0.3.1"
 description = "Turn any OpenAPI/Swagger spec into a runnable MCP server in one command."
 readme = "README.md"
 requires-python = ">=3.10"

src/openapi_to_mcp/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"

src/openapi_to_mcp/runtime.py

@@ -25,7 +25,7 @@ class RuntimeConfig:
     server_version: str
     base_url: str
     timeout_seconds: float = 30.0
-    user_agent: str = "openapi-to-mcp/0.3"
+    user_agent: str = "openapi-to-mcp/0.3.1"
 
 
 class OpenAPIMCPRuntime: