substack-api-mcp 1.0.4__tar.gz → 1.0.5__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (101) hide show
  1. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/PKG-INFO +1 -1
  2. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/pyproject.toml +1 -1
  3. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/__init__.py +1 -1
  4. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/core/context.py +6 -0
  5. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/client.py +1 -1
  6. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_publication_stats.py +2 -2
  7. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_traffic_sources.py +2 -2
  8. substack_api_mcp-1.0.5/uv.lock +1022 -0
  9. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/.github/workflows/ci.yml +0 -0
  10. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/.github/workflows/publish.yml +0 -0
  11. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/.gitignore +0 -0
  12. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/AGENTS.md +0 -0
  13. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/CLAUDE.md +0 -0
  14. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/LICENSE +0 -0
  15. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/README.md +0 -0
  16. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/assets/logo-white.svg +0 -0
  17. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/assets/logo.svg +0 -0
  18. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/add_subscribers.py +0 -0
  19. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/daily_stats.py +0 -0
  20. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/draft_from_markdown.py +0 -0
  21. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/export_subscribers.py +0 -0
  22. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/get_post.py +0 -0
  23. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/list_posts.py +0 -0
  24. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/list_subscribers.py +0 -0
  25. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/post_stats.py +0 -0
  26. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/publish_note.py +0 -0
  27. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/reply_to_comment.py +0 -0
  28. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/schedule_post.py +0 -0
  29. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/traffic_sources.py +0 -0
  30. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/unanswered_comments.py +0 -0
  31. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/weekly_report.py +0 -0
  32. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/glama.json +0 -0
  33. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/mcp.json +0 -0
  34. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/api.py +0 -0
  35. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/app.py +0 -0
  36. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/cli.py +0 -0
  37. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/core/__init__.py +0 -0
  38. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/core/account_guard.py +0 -0
  39. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/core/errors.py +0 -0
  40. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/core/helpers.py +0 -0
  41. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/core/tools.py +0 -0
  42. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/mcp_context.py +0 -0
  43. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/mcp_server.py +0 -0
  44. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/runner.py +0 -0
  45. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/scripting.py +0 -0
  46. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/session.py +0 -0
  47. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/__init__.py +0 -0
  48. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/auth.py +0 -0
  49. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/feed.py +0 -0
  50. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/markdown.py +0 -0
  51. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/publishing.py +0 -0
  52. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/subscribers.py +0 -0
  53. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/__init__.py +0 -0
  54. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/add_subscriber.py +0 -0
  55. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/cancel_scheduled_post.py +0 -0
  56. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/create_draft.py +0 -0
  57. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/create_post_tag.py +0 -0
  58. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/create_subscriber_tag.py +0 -0
  59. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/delete_comment.py +0 -0
  60. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/delete_post.py +0 -0
  61. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/duplicate_post.py +0 -0
  62. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/export_subscribers.py +0 -0
  63. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/follow_user.py +0 -0
  64. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_audience_insights.py +0 -0
  65. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_conversation.py +0 -0
  66. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_daily_stats.py +0 -0
  67. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_feed.py +0 -0
  68. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_post.py +0 -0
  69. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_post_engagement.py +0 -0
  70. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_post_stats.py +0 -0
  71. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_post_traffic.py +0 -0
  72. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_unread_counts.py +0 -0
  73. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/like_comment.py +0 -0
  74. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/like_post.py +0 -0
  75. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_activity.py +0 -0
  76. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_comments.py +0 -0
  77. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_conversations.py +0 -0
  78. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_note_replies.py +0 -0
  79. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_notes.py +0 -0
  80. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_post_tags.py +0 -0
  81. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_posts.py +0 -0
  82. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_recommendations.py +0 -0
  83. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_sections.py +0 -0
  84. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_subscriber_tags.py +0 -0
  85. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_subscribers.py +0 -0
  86. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_subscriptions.py +0 -0
  87. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/pin_comment.py +0 -0
  88. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/publish_note.py +0 -0
  89. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/publish_post.py +0 -0
  90. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/recommend_publication.py +0 -0
  91. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/remove_comment.py +0 -0
  92. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/remove_subscriber.py +0 -0
  93. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/reply_to_comment.py +0 -0
  94. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/reply_to_note.py +0 -0
  95. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/schedule_post.py +0 -0
  96. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/search_substack.py +0 -0
  97. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/send_message.py +0 -0
  98. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/tag_post.py +0 -0
  99. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/tag_subscribers.py +0 -0
  100. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/unpublish_post.py +0 -0
  101. {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/update_draft.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: substack-api-mcp
3
- Version: 1.0.4
3
+ Version: 1.0.5
4
4
  Summary: Self-hosted Substack API and MCP server on your own Chrome session. Noncommercial use (PolyForm Noncommercial 1.0.0).
5
5
  Project-URL: Homepage, https://cotlet.dev/integrations/substack-api-mcp-server
6
6
  Project-URL: Source, https://github.com/cotletdev/substack-api-mcp-server
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "substack-api-mcp"
3
- version = "1.0.4"
3
+ version = "1.0.5"
4
4
  description = "Self-hosted Substack API and MCP server on your own Chrome session. Noncommercial use (PolyForm Noncommercial 1.0.0)."
5
5
  readme = "README.md"
6
6
  license = "PolyForm-Noncommercial-1.0.0"
@@ -11,7 +11,7 @@ from __future__ import annotations
11
11
  import asyncio
12
12
  from typing import Any
13
13
 
14
- __version__ = "1.0.4"
14
+ __version__ = "1.0.5"
15
15
 
16
16
 
17
17
  def call(tool: str, args: dict[str, Any] | None = None, **kwargs: Any) -> Any:
@@ -9,6 +9,7 @@ from __future__ import annotations
9
9
  import json as jsonlib
10
10
  import time
11
11
  from dataclasses import dataclass, field
12
+ from datetime import UTC, datetime, tzinfo
12
13
  from typing import Any
13
14
  from urllib.parse import urljoin, urlsplit
14
15
 
@@ -89,6 +90,11 @@ class ToolContext:
89
90
  _cache: dict[str, tuple[float, str]] = field(default_factory=dict, repr=False)
90
91
  _http: AsyncSession | None = field(default=None, repr=False)
91
92
 
93
+ @property
94
+ def user_zone(self) -> tzinfo:
95
+ """This computer's time zone, for "today" and date ranges."""
96
+ return datetime.now().astimezone().tzinfo or UTC
97
+
92
98
  def _client(self) -> AsyncSession:
93
99
  if self._http is None:
94
100
  headers = {"accept-language": self.session.locale or "en-US,en;q=0.9"}
@@ -49,7 +49,7 @@ async def publication(ctx: ToolContext) -> dict[str, Any]:
49
49
  if await _suspended(ctx):
50
50
  raise TargetBlockedError(
51
51
  "Substack suspended this account and hid its publication. The notice and the appeal link are on "
52
- "substack.com in your Cloud Browser."
52
+ "substack.com in Chrome."
53
53
  )
54
54
  raise ToolError("This Substack account has no publication it can publish to.", ErrorCode.APP_PERMISSION_DENIED)
55
55
 
@@ -4,7 +4,6 @@ from __future__ import annotations
4
4
 
5
5
  from datetime import datetime, timedelta
6
6
  from typing import TYPE_CHECKING, Any
7
- from zoneinfo import ZoneInfo
8
7
 
9
8
  from substack_api_mcp.core.tools import tool
10
9
  from substack_api_mcp.substack.client import call, publication
@@ -55,7 +54,8 @@ async def get_publication_stats(ctx: ToolContext, args: dict[str, Any]) -> Any:
55
54
  pub = await publication(ctx)
56
55
  # The dashboard's summary for the last N days: subscribers and ARR at the start and the end.
57
56
  summary = await call(ctx, "GET", f"{pub['base']}/api/v1/publish-dashboard/summary-v2", params={"range": days})
58
- today = datetime.now(ZoneInfo("Europe/Warsaw")).date()
57
+ # The user's calendar day, so a US evening does not end the range on tomorrow (docs/05, 24.10.2026).
58
+ today = datetime.now(ctx.user_zone).date()
59
59
  window = {"from": (today - timedelta(days=days)).isoformat(), "to": today.isoformat(), "offset": 0, "limit": 1}
60
60
  # Cancelled paid subscriptions in the period (Analytics > Unsubscribes); Substack keeps no count of free ones.
61
61
  cancels = await call(ctx, "GET", f"{pub['base']}/api/v1/publication/stats/unsubscribes", params=window)
@@ -4,7 +4,6 @@ from __future__ import annotations
4
4
 
5
5
  from datetime import datetime, timedelta
6
6
  from typing import TYPE_CHECKING, Any
7
- from zoneinfo import ZoneInfo
8
7
 
9
8
  from substack_api_mcp.core.helpers import limit
10
9
  from substack_api_mcp.core.tools import tool
@@ -61,7 +60,8 @@ async def list_traffic_sources(ctx: ToolContext, args: dict[str, Any]) -> Any:
61
60
  wanted = limit(args, 20, 50) # Substack answers 400 above 50 (22.10.2026)
62
61
  offset = offset_cursor(args.get("cursor"))
63
62
  pub = await publication(ctx)
64
- today = datetime.now(ZoneInfo("Europe/Warsaw")).date()
63
+ # The user's calendar day, so a US evening does not end the range on tomorrow (docs/05, 24.10.2026).
64
+ today = datetime.now(ctx.user_zone).date()
65
65
  params = {
66
66
  "from_date": (today - timedelta(days=int(period[:-1]))).isoformat(),
67
67
  "to_date": today.isoformat(),