MCP, MCP server
agentplaybooks
One playbook, every agent. A portable operating environment for AI agents — persona, skills, MCP servers, project instructions, and memory in one source of truth.
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.
NETWORK_NO_FIXED_HOST NETWORK_UNNAMED_HOST SECRETS_PATH_DOTENV SECRETS_ENV_READ OBFUSCATION_FILE_OVER_READ_CAP OBFUSCATION_FILE_CAP_REACHED
Why this grade
- NETWORK_NO_FIXED_HOST Low
Makes a network call whose host is not written as a fixed address.
worker-generated.d.ts, line 6
const worker: { fetch(request: Request, env: Record<string, unknown>, ctx: unknown): Promise<Response> }; - NETWORK_UNNAMED_HOST Low
Calls a fixed host that the description does not name.
worker-generated.d.ts, line 6
const worker: { fetch(request: Request, env: Record<string, unknown>, ctx: unknown): Promise<Response> }; - SECRETS_PATH_DOTENV Low
Mentions a .env file.
packages/cli/src/adopt.js, line 40
* from `~/.hermes/.env`. Note it keeps an unset placeholder verbatim rather than - SECRETS_ENV_READ Note
Reads an environment variable whose name contains KEY, SECRET, TOKEN, PASSWORD or CREDENTIAL.
packages/cli/src/cli.js, line 383
const key = process.env.AGENTPLAYBOOKS_PLAYBOOK_KEY - OBFUSCATION_FILE_OVER_READ_CAP Note
A file was over the read cap and was not fully read.
package-lock.json, line 1
{ - OBFUSCATION_FILE_CAP_REACHED Note
The 400 file cap was reached before every file was read.
package-lock.json, line 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 call was found in the code. This check does not read permissions an entry declares. A permission line to write or edit files was found in this repository, and it may apply to this entry.
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. can reach api.github.com. The description does not name that host.
NETWORK_NO_FIXED_HOST NETWORK_UNNAMED_HOST
worker-generated.d.ts, line 6
const worker: { fetch(request: Request, env: Record<string, unknown>, ctx: unknown): Promise<Response> };
worker.ts, line 17
async fetch(request: Request, env: Record<string, unknown>, ctx: unknown): Promise<Response> {
worker.ts, line 32
return next.fetch(request, env, ctx);
Show more
packages/cli/src/auth-command.js, line 25
throw new Error(`No connection template '${id}'. List them with: curl ${url}/api/connections`);
packages/cli/src/cli.js, line 168
providers need it: curl <url>/api/connections
packages/hermes-memory/agentplaybooks/__init__.py, line 156
return self.recall.fetch([self.client, *self.teams.values()], query)
packages/hermes-memory/agentplaybooks/recall.py, line 40
def fetch(self, clients, query):
scripts/generate-public-html.ts, line 100
const response = await fetch(origin + path, {
public/docs/skills.md, line 103
skills_response = requests.get("https://apbks.com/api/playbooks/YOUR_GUID?format=anthropic")
Secrets
Concern
reads a credential or environment file.
SECRETS_ENV_READ SECRETS_PATH_DOTENV
packages/cli/src/adapters.js, line 269
lines.push("", `[mcp_servers.${name}.env]`);
packages/cli/src/adopt.js, line 40
* from `~/.hermes/.env`. Note it keeps an unset placeholder verbatim rather than
packages/cli/src/cli.js, line 383
const key = process.env.AGENTPLAYBOOKS_PLAYBOOK_KEY
Show more
packages/cli/src/checks.js, line 139
// Matches both `[mcp_servers.name]` and its `.env` sub-table.
packages/cli/src/checks.js, line 140
const sectionPattern = /^\[mcp_servers\.([A-Za-z0-9_-]+)(\.env)?\]\s*$/gm;
packages/cli/src/cli.js, line 121
the managed .env). --env-file adds credentials from a protected
packages/cli/src/cli.js, line 810
const apiKey = process.env.AGENTPLAYBOOKS_API_KEY
packages/cli/src/hermes-bundle.js, line 12
* managed/.env managed environment, loaded last by Hermes.
packages/cli/src/hermes-bundle.js, line 338
const home = await hermesProfile({ env: options.hermesHome ? { ...env, HERMES_HOME: options.hermesHome } : env });
packages/cli/src/hermes-bundle.js, line 375
// The managed .env. A bundle is readable by everyone who can reach the
scripts/github-skill-parser.ts, line 427
const token = process.env.GITHUB_TOKEN;
scripts/import-anthropic-skills.ts, line 493
const supabaseKey = process.env.SUPABASE_SERVICE_ROLE_KEY;
scripts/import-anthropic-skills.ts, line 494
const githubToken = process.env.GITHUB_TOKEN;
scripts/seed-data.ts, line 641
const supabaseKey = process.env.SUPABASE_SERVICE_ROLE_KEY;
scripts/seed-data.ts, line 642
const githubToken = process.env.GITHUB_TOKEN;
scripts/seed-reviewer-account.mjs, line 25
const API_KEY = process.env.AGENTPLAYBOOKS_API_KEY || "";
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. the file cap was reached before every file was read.
OBFUSCATION_FILE_OVER_READ_CAP OBFUSCATION_FILE_CAP_REACHED
package-lock.json, line 1
{
src/components/playbook/CollaborationManager.tsx, line 1
"use client";
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 f31e9c3af652. can reach a host that is not written as a fixed address. can reach api.github.com. The description does not name that host. reads a credential or environment file. a file was over the read cap and was not fully read. the file cap was reached before every file was read.
Date and source
Date checked:
github.com
Commit graded: f31e9c3af6520cebda1c0712447b4b487ffc12a7
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.