Grades are a hygiene check, not a security guarantee.

MCP, MCP server

Beanquery Mcp

The Beancount MCP Server is an experimental implementation of the Model Context Protocol (MCP) designed to interface with Beancount ledger files.

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.

SECRETS_PATH_DOTENV OBFUSCATION_FILE_OVER_READ_CAP

Why this grade

  • SECRETS_PATH_DOTENV Low

    Mentions a .env file.

    server.py, line 19 env_prefix="BEANCOUNT_", env_file=".env"

  • OBFUSCATION_FILE_OVER_READ_CAP Note

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

    sample.bean, line 1 ;; -*- mode: org; mode: beancount; -*-

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

    Pass

    No network call found.

  • Secrets

    Concern

    reads a credential or environment file.

    SECRETS_PATH_DOTENV

    server.py, line 19

    env_prefix="BEANCOUNT_", env_file=".env"

    .gitignore, line 23

    # Virtual environments

    README.md, line 73

    uv run mcp install server.py -f .env --with beancount --with beanquery

  • 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

    sample.bean, line 1

    ;; -*- mode: org; mode: beancount; -*-

  • Licence

    Pass

    A licence file is present (LICENSE).

  • Maintainer activity

    Note

    the latest commit is more than 365 days old.

    MAINTAINER_STALE

    No file path was stored.

    2025-04-01T09:20:42+02:00

Note

Hygiene check of commit 92f54c5498d0. reads a credential or environment file. a file was over the read cap and was not fully read. the latest commit is more than 365 days old.

Date and source

Date checked:

View source

github.com

Commit graded: 92f54c5498d0877c0cf28c938a0fd47794dd7510

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