MCP, MCP server
io.github.Bristlecone2026/bristlecone-logic
Document Status: Production Baseline Approved Date Range: July 20, 2026 — August 1, 2026 Core Toolchain: Linux, uv (Astral), Python 3.12+, FastAPI, Pydantic v2, PostgreSQL 16, Redis, Nginx, Docker, Streamlit, Web3.py, AWS KMS (secp256k1) Engineering Philosophy: F
Compatibility: Not stated.
Grade B
Minor issues only, no Medium or High. Worth a quick look at the findings below before installing.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
Rescanned at commit 8a73b6b0d65d, unchanged since the check below.
NETWORK_NO_FIXED_HOST SECRETS_PATH_DOTENV SECRETS_ENV_READ OBFUSCATION_FILE_OVER_READ_CAP
Why this grade
- NETWORK_NO_FIXED_HOST Low
Makes a network call whose host is not written as a fixed address.
dashboard.py, line 13
r = requests.get(f"{API_URL}/health", timeout=2) - SECRETS_PATH_DOTENV Low
Mentions a .env file.
config.py, line 4
# Load environment variables from .env file - SECRETS_ENV_READ Note
Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.
config.py, line 7
API_KEY = os.getenv("API_KEY", "default_key") - OBFUSCATION_FILE_OVER_READ_CAP Note
A file was over the read cap and was not fully read.
uv.lock, line 1
version = 1
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
Concern
can reach a host that is not written as a fixed address.
NETWORK_NO_FIXED_HOST
dashboard.py, line 13
r = requests.get(f"{API_URL}/health", timeout=2)
dashboard.py, line 28
res = requests.post(f"{API_URL}/execute", json={"command": prompt}, timeout=5)
run_demo.sh, line 36
curl -s -i -X POST "${ENDPOINT}" \
Show more
run_demo.sh, line 58
curl -s -i -X POST "${ENDPOINT}" \
run_demo.sh, line 82
curl -s -i -X POST "${ENDPOINT}" \
sweeper_daemon.py, line 43
resp = json.loads(urllib.request.urlopen(req, timeout=5).read().decode('utf-8'))
watchdog.py, line 34
urllib.request.urlopen(req, timeout=10)
watchdog.py, line 41
with urllib.request.urlopen(req, timeout=8) as response:
scripts/reload.sh, line 12
curl -s http://127.0.0.1/api/v1/health | jq .
docker-compose.yml, line 34
test: ["CMD", "python3", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8000/docs', timeout=3)"]
Secrets
Concern
reads a credential or environment file.
SECRETS_ENV_READ SECRETS_PATH_DOTENV
config.py, line 4
# Load environment variables from .env file
config.py, line 7
API_KEY = os.getenv("API_KEY", "default_key")
config.py, line 8
HMAC_SECRET_KEY = os.getenv("HMAC_SECRET_KEY", "default_secret_key")
Show more
kms_signer.py, line 8
load_dotenv('/opt/bristlecone/bristlecone-logic/.env')
kms_signer.py, line 122
kms_id = os.getenv('AWS_KMS_KEY_ID')
run.sh, line 15
# 2. Check for .env file or generate default secret
run.sh, line 16
if [ ! -f ".env" ]; then
run.sh, line 17
echo "[WARN] No .env file detected. Generating production .env with secure HMAC secret..."
run.sh, line 19
echo "HMAC_SECRET_KEY=$SECRET" > .env
run.sh, line 20
echo "[OK] Created .env file."
sweeper_daemon.py, line 9
load_dotenv('/opt/bristlecone/bristlecone-logic/.env')
sweeper_daemon.py, line 152
kms_id = os.getenv('AWS_KMS_KEY_ID')
app/config.py, line 4
OPENAI_API_KEY: str = os.getenv("OPENAI_API_KEY", "your_openai_api_key_here")
app/config.py, line 5
HMAC_SECRET: str = os.getenv("HMAC_SECRET", "bristlecone-zero-trust-secret-key")
app/api/v1/endpoints/billing.py, line 15
WEBHOOK_SECRET = os.getenv("WEBHOOK_SECRET", "bl_webhook_secret_2026")
app/core/config.py, line 3
SECRET_KEY = os.getenv("SECRET_KEY", "bristlecone_dev_secret_key_change_in_production_32char")
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
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 8a73b6b0d65d. 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. no licence file found.
Date and source
Date checked:
github.com
Commit graded: 8a73b6b0d65d1af8d32ae95ec1d4703d907ec715
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.