Grades are a hygiene check, not a security guarantee.

MCP, MCP server

uspto_enriched_citation_mcp

A high-performance Model Context Protocol (MCP) server providing access to two USPTO patent citation APIs — the Enriched Citations v3 (AI-extracted passage locations, claim mapping) and the Office Action Citations v2 (raw Form 892/1449 citation data) — with token-

Compatibility: Not stated.

Grade C

One Medium finding. Read the report before installing.

Graded by PlugVetRubric v2

Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.

INSTALL_REMOTE_SCRIPT

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 34 if curl -LsSf https://astral.sh/uv/install.sh | sh; then

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

    Note

    requests shell access. The manifest names this permission.

    PERMISSION_SHELL_DECLARED

    SECURITY_GUIDELINES.md, line 468

    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 786

    curl -LsSf https://astral.sh/uv/install.sh | sh

    INSTALL.md, line 926

    # Linux/macOS: curl -LsSf https://astral.sh/uv/install.sh | sh

    deploy/linux_setup.sh, line 34

    if curl -LsSf https://astral.sh/uv/install.sh | sh; then

    Show more

    deploy/linux_setup.sh, line 44

    echo -e "${YELLOW} curl -LsSf https://astral.sh/uv/install.sh | sh${NC}"

  • Network

    Concern

    can reach a host that is not written as a fixed address.

    NETWORK_NO_FIXED_HOST

    src/uspto_enriched_citation_mcp/util/citation_links.py, line 49

    `curl -s -o /dev/null -w "%{http_code}" -L <url>`:

    src/uspto_enriched_citation_mcp/util/citation_links.py, line 65

    `curl -s -o /dev/null -w "%{http_code}" -L <url>`:

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    deploy/linux_setup.sh, line 130

    api_key = os.environ.get('SETUP_USPTO_KEY', '')

    deploy/windows_setup.ps1, line 31

    api_key = os.environ.get('TEMP_API_KEY_STORAGE', '')

    deploy/windows_setup.ps1, line 76

    api_key = os.environ.get('TEMP_API_KEY_STORAGE', '')

    Show more

    src/uspto_enriched_citation_mcp/middleware.py, line 70

    or os.environ.get("INTERNAL_AUTH_SECRET")

    .env.example, line 2

    # Copy to .env and fill in your values:

    .env.example, line 3

    # cp .env.example .env

    .env.tester.example, line 2

    # Copy this file to .env.tester and fill in your actual key.

    .env.tester.example, line 3

    # .env.tester is gitignored - never commit it.

    .env.tester.example, line 4

    # After creating: chmod 600 .env.tester

    .gitignore, line 45

    # Environment variables

    .gitignore, line 46

    .env

    .gitignore, line 48

    !.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 05a78732dba7. 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. 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:

View source

github.com

Commit graded: 05a78732dba7870a65cb0f90ce859a6989ec5222

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.

Read how this letter is chosen