python-substack 0.1.19__tar.gz → 0.1.21__tar.gz

{python_substack-0.1.19 → python_substack-0.1.21}/PKG-INFO

@@ -1,24 +1,23 @@
 Metadata-Version: 2.4
 Name: python-substack
-Version: 0.1.19
+Version: 0.1.21
 Summary: A Python wrapper around the Substack API.
 License: MIT
 License-File: LICENSE
 Keywords: substack
 Author: Paolo Mazza
 Author-email: mazzapaolo2019@gmail.com
-Requires-Python: >=3.9
+Requires-Python: >=3.10,<4.0
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Requires-Dist: PyYAML (>=6.0,<7.0)
-Requires-Dist: python-dotenv (>=0.21.0,<0.22.0)
-Requires-Dist: requests (>=2.31.0,<3.0.0)
+Requires-Dist: python-dotenv (>=1.2.1,<2.0.0)
+Requires-Dist: requests (>=2.32.0,<3.0.0)
 Project-URL: Homepage, https://github.com/ma2za/python-substack
 Project-URL: Repository, https://github.com/ma2za/python-substack
 Description-Content-Type: text/markdown
@@ -38,6 +37,12 @@ You can install python-substack using:
 
     $ pip install python-substack
 
+For the MCP server tools, install the extra dependency set:
+
+    $ poetry install --with mcp
+
+> NOTE: We had to upgrade the package requirements to support Python 3.10 because 3.9 is basically vintage now. If you still run 3.9, please join us in the future (or bring snacks).
+
 ---
 
 # Setup
@@ -237,7 +242,14 @@ for _, item in body.items():
     post.add(item)
 
 draft = api.post_draft(post.get_draft())
-api.put_draft(draft.get("id"), draft_section_id=post.draft_section_id)
+put_draft_kwargs = {
+    "draft_section_id": post.draft_section_id,
+    "search_engine_title": post_data.get("search_engine_title"),
+    "search_engine_description": post_data.get("search_engine_description"),
+    "slug": post_data.get("slug"),
+}
+put_draft_kwargs = {k: v for k, v in put_draft_kwargs.items() if v is not None}
+api.put_draft(draft.get("id"), **put_draft_kwargs)
 
 # Publish the draft
 api.prepublish_draft(draft.get("id"))
@@ -265,6 +277,22 @@ body:
     src: "local_image.jpg"  # Local images will be uploaded automatically
 ```
 
+## MCP FastMCP server
+
+This package now includes a FastMCP server in `substack/mcp_fastmcp.py` with the following tools:
+
+- `post_draft_from_markdown(...)`: create draft from markdown, optional tag/add/prepublish/publish, and control send/share_automatically.
+- `put_draft(draft_id, update_payload)`: update draft fields.
+- `add_tags(draft_id, tags)`: add tags to a draft/post.
+- `prepublish_draft(draft_id)`: prepublish a draft.
+- `publish_draft(draft_id, send=True, share_automatically=False)`: publish a draft.
+
+Use via stdio transport:
+
+```bash
+python -c "from substack.mcp_fastmcp import main; main()"
+```
+
 # Contributing
 
 Install pre-commit:

{python_substack-0.1.19 → python_substack-0.1.21}/README.md

@@ -13,6 +13,12 @@ You can install python-substack using:
 
     $ pip install python-substack
 
+For the MCP server tools, install the extra dependency set:
+
+    $ poetry install --with mcp
+
+> NOTE: We had to upgrade the package requirements to support Python 3.10 because 3.9 is basically vintage now. If you still run 3.9, please join us in the future (or bring snacks).
+
 ---
 
 # Setup
@@ -212,7 +218,14 @@ for _, item in body.items():
     post.add(item)
 
 draft = api.post_draft(post.get_draft())
-api.put_draft(draft.get("id"), draft_section_id=post.draft_section_id)
+put_draft_kwargs = {
+    "draft_section_id": post.draft_section_id,
+    "search_engine_title": post_data.get("search_engine_title"),
+    "search_engine_description": post_data.get("search_engine_description"),
+    "slug": post_data.get("slug"),
+}
+put_draft_kwargs = {k: v for k, v in put_draft_kwargs.items() if v is not None}
+api.put_draft(draft.get("id"), **put_draft_kwargs)
 
 # Publish the draft
 api.prepublish_draft(draft.get("id"))
@@ -240,6 +253,22 @@ body:
     src: "local_image.jpg"  # Local images will be uploaded automatically
 ```
 
+## MCP FastMCP server
+
+This package now includes a FastMCP server in `substack/mcp_fastmcp.py` with the following tools:
+
+- `post_draft_from_markdown(...)`: create draft from markdown, optional tag/add/prepublish/publish, and control send/share_automatically.
+- `put_draft(draft_id, update_payload)`: update draft fields.
+- `add_tags(draft_id, tags)`: add tags to a draft/post.
+- `prepublish_draft(draft_id)`: prepublish a draft.
+- `publish_draft(draft_id, send=True, share_automatically=False)`: publish a draft.
+
+Use via stdio transport:
+
+```bash
+python -c "from substack.mcp_fastmcp import main; main()"
+```
+
 # Contributing
 
 Install pre-commit:

{python_substack-0.1.19 → python_substack-0.1.21}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "python-substack"
-version = "0.1.19"
+version = "0.1.21"
 description = "A Python wrapper around the Substack API."
 authors = ["Paolo Mazza <mazzapaolo2019@gmail.com>"]
 license = "MIT"
@@ -16,15 +16,20 @@ homepage = "https://github.com/ma2za/python-substack"
 keywords = ["substack"]
 
 [tool.poetry.dependencies]
-python = ">=3.9"
+python = "<4.0,>=3.10"
 
-requests = "^2.31.0"
-python-dotenv = "^0.21.0"
+requests = "^2.32.0"
+python-dotenv = "^1.2.1"
 PyYAML = "^6.0"
 
-
 [tool.poetry.group.dev.dependencies]
 
+[tool.poetry.group.mcp]
+
+optional = true
+
+[tool.poetry.group.mcp.dependencies]
+fastmcp = "^3.1.1"
 
 [build-system]
 requires = ["poetry-core>=1.0.0"]

{python_substack-0.1.19 → python_substack-0.1.21}/substack/__init__.py

@@ -3,7 +3,7 @@
 __author__ = "Paolo Mazza"
 __email__ = "mazzapaolo2019@gmail.com"
 __license__ = "MIT License"
-__version__ = "1.0"
+__version__ = "0.1.21"
 __url__ = "https://github.com/ma2za/python-substack"
 __download_url__ = "https://pypi.python.org/pypi/python-substack"
 __description__ = "A Python wrapper around the Substack API"