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.
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/PKG-INFO +1 -1
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/pyproject.toml +1 -1
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/__init__.py +1 -1
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/core/context.py +6 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/client.py +1 -1
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_publication_stats.py +2 -2
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_traffic_sources.py +2 -2
- substack_api_mcp-1.0.5/uv.lock +1022 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/.github/workflows/ci.yml +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/.github/workflows/publish.yml +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/.gitignore +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/AGENTS.md +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/CLAUDE.md +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/LICENSE +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/README.md +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/assets/logo-white.svg +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/assets/logo.svg +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/add_subscribers.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/daily_stats.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/draft_from_markdown.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/export_subscribers.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/get_post.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/list_posts.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/list_subscribers.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/post_stats.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/publish_note.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/reply_to_comment.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/schedule_post.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/traffic_sources.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/unanswered_comments.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/examples/weekly_report.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/glama.json +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/mcp.json +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/api.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/app.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/cli.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/core/__init__.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/core/account_guard.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/core/errors.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/core/helpers.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/core/tools.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/mcp_context.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/mcp_server.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/runner.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/scripting.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/session.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/__init__.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/auth.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/feed.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/markdown.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/publishing.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/subscribers.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/__init__.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/add_subscriber.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/cancel_scheduled_post.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/create_draft.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/create_post_tag.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/create_subscriber_tag.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/delete_comment.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/delete_post.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/duplicate_post.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/export_subscribers.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/follow_user.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_audience_insights.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_conversation.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_daily_stats.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_feed.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_post.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_post_engagement.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_post_stats.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_post_traffic.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/get_unread_counts.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/like_comment.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/like_post.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_activity.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_comments.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_conversations.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_note_replies.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_notes.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_post_tags.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_posts.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_recommendations.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_sections.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_subscriber_tags.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_subscribers.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/list_subscriptions.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/pin_comment.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/publish_note.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/publish_post.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/recommend_publication.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/remove_comment.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/remove_subscriber.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/reply_to_comment.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/reply_to_note.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/schedule_post.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/search_substack.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/send_message.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/tag_post.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/tag_subscribers.py +0 -0
- {substack_api_mcp-1.0.4 → substack_api_mcp-1.0.5}/substack_api_mcp/substack/tools/unpublish_post.py +0 -0
- {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.
|
|
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.
|
|
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"
|
|
@@ -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
|
|
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
|
-
|
|
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
|
-
|
|
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(),
|