MCP, MCP server
Substack Gateway Oss
A stateless Python gateway for Substack that exposes a REST API and an MCP server on top of the same service layer.
Compatibility: Not stated.
Grade B
Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
Rescanned at commit 539cc9038450, unchanged since the check below.
NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV SECRETS_ENV_READ OBFUSCATION_FILE_OVER_READ_CAP
Why this grade
- NETWORK_NO_FIXED_HOST Low
Makes a network call whose host is not written as a fixed address.
packages/gateway_stats/src/gateway_stats/dashboard.py, line 87
async def fetch() -> dict[str, Any]: - SECRETS_PATH_DOTENV Low
Mentions a .env file.
CHANGELOG.md, line 3766
<code>set</code> and <code>unset</code> used to reset the file mode of the modified .env file to - SECRETS_ENV_READ Note
Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.
packages/gateway_oss/e2e/steps/common.py, line 23
os.environ.get("SUBSTACK_GATEWAY_TOKEN", "").strip() - OBFUSCATION_FILE_OVER_READ_CAP Note
A file was over the read cap and was not fully read.
CHANGELOG.md, line 1
# CHANGELOG
Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.
Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.
What was checked
Plain notes from the hygiene checks.
Permissions
Pass
No shell or command execution found, and no extra permission was declared.
Install and update
Pass
No install-time script found, and dependencies are pinned or absent.
Network
Concern
can reach a host that is not written as a fixed address.
NETWORK_NO_FIXED_HOST
packages/gateway_stats/src/gateway_stats/dashboard.py, line 87
async def fetch() -> dict[str, Any]:
packages/gateway_stats/src/gateway_stats/dashboard.py, line 97
async def fetch() -> dict[str, Any]:
packages/gateway_stats/src/gateway_stats/dashboard.py, line 115
async def fetch() -> dict[str, Any]:
Show more
packages/gateway_stats/src/gateway_stats/dashboard.py, line 134
async def fetch() -> dict[str, Any]:
packages/gateway_stats/src/gateway_stats/post_stats.py, line 38
async def fetch() -> dict[str, Any]:
packages/gateway_stats/src/gateway_stats/service.py, line 147
async def fetch() -> dict[str, int]:
packages/gateway_stats/src/gateway_stats/snapshot.py, line 23
data = await fetch()
.github/workflows/e2e.yml, line 171
with urllib.request.urlopen(request) as response:
Secrets
Concern
reads a credential or environment file.
SECRETS_ENV_READ SECRETS_PATH_DOTENV
packages/gateway_oss/e2e/steps/common.py, line 23
os.environ.get("SUBSTACK_GATEWAY_TOKEN", "").strip()
packages/gateway_oss/e2e/steps/common.py, line 24
or os.environ.get("SUBSTACK_TOKEN", "").strip()
CHANGELOG.md, line 3766
<code>set</code> and <code>unset</code> used to reset the file mode of the modified .env file to
Show more
packages/gateway_oss/e2e/steps/mcp.py, line 11
os.environ.get("SUBSTACK_GATEWAY_TOKEN", "").strip()
packages/gateway_oss/e2e/steps/mcp.py, line 12
or os.environ.get("SUBSTACK_TOKEN", "").strip()
.gitignore, line 14
.DS_Store
CHANGELOG.md, line 3817
<code>set</code> and <code>unset</code> used to reset the file mode of the modified .env file to
Agent instructions
Pass
No instruction to ignore earlier instructions or to hide a step.
Obfuscation
Note
a file was over the read cap and was not fully read.
OBFUSCATION_FILE_OVER_READ_CAP
CHANGELOG.md, line 1
# CHANGELOG
uv.lock, line 1
version = 1
Licence
Pass
A licence file is present (LICENSE).
Maintainer activity
Pass
The latest commit is within the last 365 days.
Note
Hygiene check of commit 539cc9038450. can reach a host that is not written as a fixed address. reads a credential or environment file. a file was over the read cap and was not fully read.
Date and source
Date checked:
github.com
Commit graded: 539cc903845066b864ec8c47c2b25bfeaee7a249
This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.