MCP, MCP server
uspto_pfw_mcp
A high-performance Model Context Protocol (MCP) server for the USPTO Patent File Wrapper API with token saving context reduction capabilities, smart field mapping, and secure browser-accessible downloads.
Compatibility: Not stated.
Grade D
Two or more Medium findings, or a High. Only try it in a sandbox.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
INSTALL_REMOTE_SCRIPT NETWORK_HOST_FROM_INPUT
Why this grade
- INSTALL_REMOTE_SCRIPT Medium
Fetches a script from the network and runs it (a pipe to a shell, or an install hook with a URL).
deploy/linux_setup.sh, line 38
if curl -LsSf https://astral.sh/uv/install.sh | sh; then - NETWORK_HOST_FROM_INPUT Medium
A file takes a URL or endpoint as input and has no fixed host list.
scripts/pip_audit_gate.py, line 31
with urllib.request.urlopen(OSV_URL.format(advisory_id), timeout=20) as response:
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.
If you think this grade is wrong, email [email protected] with the entry link and your evidence. We aim to acknowledge within two working days and decide within seven. If we confirm an error, we aim to correct it within 24 hours of confirming it. These are aims, not guarantees.
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
Note
requests shell access. The manifest names this permission.
PERMISSION_SHELL_DECLARED
src/patent_filewrapper_mcp/middleware.py, line 20
BLOCKING subprocess.run with a 15-second timeout, on the ASGI event loop,
src/patent_filewrapper_mcp/util/linux_secret_store.py, line 37
result = subprocess.run(
.security/check_env_file_perms.py, line 19
subprocess.run(
Show more
.security/check_env_file_perms.py, line 26
subprocess.run(
SECURITY_GUIDELINES.md, line 463
result = subprocess.run([
Install and update
Serious
install fetches a script from the network. The docs document an installer that pipes a download into a shell.
INSTALL_REMOTE_SCRIPT INSTALL_DOCUMENTED_INSTALLER
INSTALL.md, line 771
curl -LsSf https://astral.sh/uv/install.sh | sh
INSTALL.md, line 917
# Linux/macOS: curl -LsSf https://astral.sh/uv/install.sh | sh
deploy/linux_setup.sh, line 38
if curl -LsSf https://astral.sh/uv/install.sh | sh; then
Show more
deploy/linux_setup.sh, line 47
echo -e "${YELLOW} curl -LsSf https://astral.sh/uv/install.sh | sh${NC}"
Network
Serious
accepts a host from input, with no fixed list in this file.
NETWORK_HOST_FROM_INPUT
scripts/pip_audit_gate.py, line 31
with urllib.request.urlopen(OSV_URL.format(advisory_id), timeout=20) as response:
src/patent_filewrapper_mcp/main.py, line 343
response = httpx.get(proxy_url, timeout=10.0)
src/patent_filewrapper_mcp/server_bootstrap.py, line 64
response = httpx.get(
Show more
src/patent_filewrapper_mcp/ui/views.py, line 887
const resp = await fetch(`${proxyBaseUrl}/api/recent-downloads`);
src/patent_filewrapper_mcp/util/citation_links.py, line 20
`curl -s -o /dev/null -w "%{http_code}" -L <url>`:
src/patent_filewrapper_mcp/util/security_logger.py, line 264
httpx.post(
Secrets
Concern
reads a credential or environment file.
SECRETS_ENV_READ SECRETS_PATH_DOTENV
deploy/linux_setup.sh, line 157
uspto_key = os.environ.get('SETUP_USPTO_KEY', '')
deploy/linux_setup.sh, line 167
mistral_key = os.environ.get('SETUP_MISTRAL_KEY', '')
scripts/manual_checks/simple_test.py, line 6
os.environ['USPTO_API_KEY'] = os.getenv('TEST_USPTO_API_KEY', 'test_fallback_key')
Show more
src/patent_filewrapper_mcp/middleware.py, line 39
raw = get_internal_auth_secret() or os.environ.get("INTERNAL_AUTH_SECRET")
src/patent_filewrapper_mcp/server_bootstrap.py, line 328
_auth_secret_check = get_internal_auth_secret() or os.environ.get("INTERNAL_AUTH_SECRET")
src/patent_filewrapper_mcp/api/enhanced_client.py, line 755
self.api_key = os.getenv("USPTO_API_KEY")
src/patent_filewrapper_mcp/api/enhanced_client.py, line 818
raw_mistral_key = os.getenv("MISTRAL_API_KEY")
src/patent_filewrapper_mcp/api/oa_base.py, line 56
self.api_key = api_key or os.getenv("USPTO_API_KEY", "")
.gitignore, line 23
# Virtual environments
.gitignore, line 30
venv.bak/
.gitignore, line 57
secrets.json
.gitignore, line 58
.env.local
.pre-commit-config.yaml, line 39
name: Check .env* files are untracked and 0600
.security/check_env_file_perms.py, line 2
"""Pre-commit guard for .env* files.
.security/check_env_file_perms.py, line 4
Fails if any .env* file (except .env.example) is either tracked by git or
.security/check_env_file_perms.py, line 14
ALLOWED_TRACKED = {".env.example"}
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
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 996f2a457650. requests shell access. The manifest names this permission. install fetches a script from the network. The docs document an installer that pipes a download into a shell. accepts a host from input, with no fixed list in this file. 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: 996f2a457650712bcc896caa65cdd7e84f35e055
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.