Grades are a hygiene check, not a security guarantee.

MCP, MCP server

Avicenna Agent

An academic scribe: a terminal harness that turns a raw idea into a long-form, structurally-guaranteed, semantically-connected note in an Obsidian vault.

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.

PERMISSION_DELETE_FILES NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV SECRETS_ENV_READ

Why this grade

  • PERMISSION_DELETE_FILES Low

    Contains a call that can delete files.

    avicenna/cli/app.py, line 319 result = subprocess.run(argv)

  • NETWORK_NO_FIXED_HOST Low

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

    avicenna/providers/gemini.py, line 416 with urllib.request.urlopen(req, timeout=timeout_s) as resp:

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    avicenna/config.py, line 43 # `load_dotenv` looked for `.env` one level too high. The README tells users to

  • SECRETS_ENV_READ Note

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

    avicenna/config.py, line 59 MISTRAL_API_KEY: str | None = os.getenv("MISTRAL_API_KEY")

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

    Concern

    can delete files.

    PERMISSION_DELETE_FILES

    avicenna/cli/app.py, line 319

    result = subprocess.run(argv)

    avicenna/cli/app.py, line 485

    completed = subprocess.run(argv, env=env)

    scripts/check_maps.py, line 59

    result = subprocess.run(

    Show more

    scripts/check_maps.py, line 78

    result = subprocess.run(

    scripts/check_maps.py, line 436

    result = subprocess.run(

    scripts/gen_matrix.py, line 118

    result = subprocess.run(

    scripts/healthcheck.py, line 714

    shutil.rmtree(_cleanup_vault)

    .github/workflows/MAP.md, line 34

    | **Lint bridge for blocking calls** | PowerShell grep for `subprocess.run`, `time.sleep`, `requests.` and friends under `avicenna/bridge/`. A blocking call there stalls the NDJSON

    AGENTS.md, line 450

    this by rejecting `subprocess.run`, `time.sleep` and `requests.` anywhere

  • 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

    avicenna/providers/gemini.py, line 416

    with urllib.request.urlopen(req, timeout=timeout_s) as resp:

    avicenna/providers/google_embedding.py, line 246

    with urllib.request.urlopen(req, timeout=60) as resp:

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_ENV_READ SECRETS_PATH_DOTENV

    avicenna/config.py, line 43

    # `load_dotenv` looked for `.env` one level too high. The README tells users to

    avicenna/config.py, line 44

    # put their key in a project-root `.env`; that file was never read.

    avicenna/config.py, line 59

    MISTRAL_API_KEY: str | None = os.getenv("MISTRAL_API_KEY")

    Show more

    avicenna/config.py, line 47

    env_path = BASE_DIR / ".env"

    avicenna/secrets.py, line 3

    Precedence: env var (.env loaded by config), then keyring, then user_config.json.

    avicenna/cli/app.py, line 221

    "No API key found. Set MISTRAL_API_KEY in .env, or run `avicenna` to configure.",

    avicenna/mcp/mcp_client.py, line 177

    # Empty strings indicate "use value from .env/environment" (don't override!)

    scripts/gen_matrix.py, line 717

    "No API key found. Set MISTRAL_API_KEY in .env or run `avicenna` to configure.",

    .gitignore, line 8

    .env

  • Agent instructions

    Pass

    No instruction to ignore earlier instructions or to hide a step.

  • Obfuscation

    Pass

    No encoded or minified payload found.

  • Licence

    Note

    no licence file found.

    LICENCE_MISSING

    No file path was stored.

    no licence file found.

  • Maintainer activity

    Pass

    The latest commit is within the last 365 days.

Note

Hygiene check of commit fcf00c0d8de0. can delete files. can reach a host that is not written as a fixed address. reads a credential or environment file. no licence file found.

Date and source

Date checked:

View source

github.com

Commit graded: fcf00c0d8de07ce063ee56177c7554177ab41cc7

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