Grades are a hygiene check, not a security guarantee.

MCP, MCP server

Usp Mcp

Feito por Caio Castro & João Pedro Gunthen

Compatibility: Not stated.

Grade B

Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.

Graded by PlugVetRubric v2

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

Rescanned at commit 488e27149a53, unchanged since the check below.

INSTALL_UNPINNED NETWORK_NO_FIXED_HOST NETWORK_UNNAMED_HOST SECRETS_PATH_DOTENV PERMISSION_SHELL_DECLARED SECRETS_ENV_READ OBFUSCATION_FILE_OVER_READ_CAP

Why this grade

  • INSTALL_UNPINNED Low

    Dependencies use a range or git URL with no lockfile.

    requirements.txt, line 13 mcp>=2,<3

  • NETWORK_NO_FIXED_HOST Low

    Makes a network call whose host is not written as a fixed address.

    CLAUDE.md, line 98 curl -s -X POST https://uspdigital.usp.br/rucard/servicos/menu/6 -d "hash=$RUCARD_HASH"

  • NETWORK_UNNAMED_HOST Low

    Calls a fixed host that the description does not name.

    CLAUDE.md, line 98 curl -s -X POST https://uspdigital.usp.br/rucard/servicos/menu/6 -d "hash=$RUCARD_HASH"

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    CLAUDE.md, line 90 # Normalizar MOODLE_TOKEN no .env: aceita a URL crua do fluxo de launch (§8) e grava

  • PERMISSION_SHELL_DECLARED Note

    Runs shell commands, and the manifest or description says so.

    scripts/_gate_segredos.py, line 69 rastreados = subprocess.run(

  • SECRETS_ENV_READ Note

    Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.

    usp_mcp/moodle/server.py, line 698 token=os.environ.get("MOODLE_TOKEN", ""),

  • OBFUSCATION_FILE_OVER_READ_CAP Note

    A file was over the read cap and was not fully read.

    SPEC1.md, line 1 # usp-mcp - documento de partida

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

    scripts/_gate_segredos.py, line 69

    rastreados = subprocess.run(

    usp_mcp/token/cli.py, line 349

    p = subprocess.run(

    usp_mcp/token/cli.py, line 547

    processo = subprocess.Popen(

    Show more

    usp_mcp/token/cli.py, line 770

    p = subprocess.run(

    usp_mcp/token/cli.py, line 1004

    p = subprocess.run(

    docs/superpowers/specs/2026-09-10-check-ignore-em-caminho-nfd-design.md, line 44

    r = subprocess.run(["git", "check-ignore", "-q", str(p)], cwd=RAIZ, ...)

    docs/superpowers/specs/2026-09-10-check-ignore-em-caminho-nfd-design.md, line 67

    r = subprocess.run(

    docs/superpowers/specs/2026-09-18-windows-design.md, line 82

    | testes que executam o script | 58 (em `test_token_navegador.py`, `test_token_decode.py`, `test_token_fora_do_argv.py`) | todos fazem `subprocess.run(["bash", "scripts/token.sh"])

  • Install and update

    Concern

    dependencies are not pinned.

    INSTALL_UNPINNED

    requirements.txt, line 13

    mcp>=2,<3

  • Network

    Concern

    can reach uspdigital.usp.br. The description does not name that host. can reach a host that is not written as a fixed address.

    NETWORK_NO_FIXED_HOST NETWORK_UNNAMED_HOST

    CLAUDE.md, line 98

    curl -s -X POST https://uspdigital.usp.br/rucard/servicos/menu/6 -d "hash=$RUCARD_HASH"

    scripts/compatibilidade.sh, line 53

    resposta=$(curl -sSL -m 20 -H 'Content-Type: application/json' \

    scripts/ws.sh, line 49

    # Nada do corpo da requisição vai pelo argv do `curl`: tudo entra por `curl -K -`,

    Show more

    scripts/ws.sh, line 97

    } | curl -sS -K - "$MOODLE_URL/webservice/rest/server.php"

    usp_mcp/jupiter/cliente.py, line 150

    with urllib.request.urlopen(pedido, timeout=_TEMPO_LIMITE) as resposta:

    usp_mcp/jupiter/cliente.py, line 177

    with urllib.request.urlopen(pedido, timeout=_TEMPO_LIMITE) as resposta:

    usp_mcp/moodle/cliente.py, line 112

    with urllib.request.urlopen(requisicao, timeout=_TIMEOUT_PADRAO_SEGUNDOS) as resp:

    usp_mcp/moodle/cliente.py, line 181

    with urllib.request.urlopen(requisicao, timeout=_TIMEOUT_DOWNLOAD_SEGUNDOS) as resp:

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    CLAUDE.md, line 76

    # Obter o MOODLE_TOKEN e gravar no .env. Manual por padrao (copiar o endereco do

    CLAUDE.md, line 90

    # Normalizar MOODLE_TOKEN no .env: aceita a URL crua do fluxo de launch (§8) e grava

    usp_mcp/moodle/server.py, line 698

    token=os.environ.get("MOODLE_TOKEN", ""),

    Show more

    CLAUDE.md, line 102

    # cria .env. Prefira isto a `git worktree add` na mão.

    CLAUDE.md, line 127

    # Gate antes de commit: .env presente, segredo no git, cru ignorado, suíte offline. Não toca a rede.

    scripts/_decodificar_token.py, line 21

    o checkout de verdade (e o `achar_env` de lá, para o `.env` de verdade).

    scripts/_gate_segredos.py, line 2

    """Checagem 1 do `scripts/gate.sh`: nenhum segredo do `.env` em arquivo rastreado.

    scripts/_gate_segredos.py, line 35

    ("RUCARD_HASH", ".env.example"),

    scripts/_gate_segredos.py, line 41

    # `achar_env` e NÃO `cwd/.env`: o `.env` é gitignorado, então um worktree

    usp_mcp/moodle/server.py, line 1105

    token=os.environ.get("MOODLE_TOKEN", ""),

    usp_mcp/moodle/server.py, line 1186

    token = os.environ.get("MOODLE_TOKEN") or ""

  • 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

    SPEC1.md, line 1

    # usp-mcp - documento de partida

    fixtures/moodle/action_events.json, line 1

    {"events":[{"id":1715342,"name":"Resultados Exp. 2 está marcado(a) para esta data","description":"","descriptionformat":1,"location":"","categoryid":null,"groupid":null,"userid":nu

  • 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 488e27149a53. requests shell access. The manifest names this permission. dependencies are not pinned. can reach uspdigital.usp.br. The description does not name that host. 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: 488e27149a53b48d2a5f0d93f27be23d67428f58

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