Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx skills add vladmdgolam/agent-skills --skill apple-books-mcpgit clone --depth 1 https://github.com/vladmdgolam/agent-skillsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/vladmdgolam/agent-skills/apple-books-mcp)<a href="https://agentmods.dev/skills/vladmdgolam/agent-skills/apple-books-mcp"><img src="https://agentmods.dev/badge/skills/vladmdgolam/agent-skills/apple-books-mcp/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/vladmdgolam/agent-skills/apple-books-mcp"><img src="https://agentmods.dev/badge/skills/vladmdgolam/agent-skills/apple-books-mcp.svg" alt="Reviewed on agentmods" width="80" height="20"></a>- NVIDIA SkillSpector warn
SkillSpector: 3 findings, up to medium
These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →
- medium MCP Rug Pull · line 14 npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.Fix: Pin the version: npx @scope/[email protected]
- medium MCP Rug Pull · line 14 uvx/uv tool run commands without ==version create a rug-pull risk.Fix: Pin the version: uvx package-name==1.2.3
- medium Memory Poisoning · line 50 Skill attempts to fill the context window with filler content, displacing legitimate instructions and safety constraints. This can degrade agent performance or bypass safety boundaries.Fix: Implement context-window management that detects and rejects padding or stuffing attempts. Prioritize system instructions over user-injected content.
What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00081 | $0.01603 |
| Opus 5.5 | $0.00032 | $0.00641 |
| Sonnet 5.5 | $0.00016 | $0.00321 |
| Haiku 4.5 | $0.00008 | $0.00160 |
Grade A, and why
apple-books-mcp scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 182 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Apple Books MCP
MCP server: vgnshiyer/apple-books-mcp
Install: npx -y @anthropic-ai/claude-code mcp add apple-books -- uvx apple-books-mcp
Tools Reference
| Tool | Purpose |
|---|---|
list_all_books |
List all books (ID, title, author) |
get_book_annotations |
All annotations for a book by ID. No color data. |
describe_annotation |
Full details for one annotation including color |
get_highlights_by_color |
All highlights of one color across entire library |
search_highlighted_text |
Search annotations by highlighted text |
search_notes |
Search by user-written notes |
list_all_annotations |
All annotations across all books |
list_all_collections |
List collections |
get_collection_books |
Books in a collection |
describe_book / describe_collection |
Details by ID |
recent_annotations |
Recently created annotations |
full_text_search |
Full text search across books |
Critical: Color Extraction Strategy
get_book_annotations does NOT return colors. describe_annotation returns colors but one at a time — 150+ calls for a single book.
Solution: Call get_highlights_by_color once per color (5 total calls), then cross-reference annotation IDs programmatically.
Available colors: PINK, BLUE, YELLOW, GREEN, PURPLE
Underlines: color = null, is_underline = 1
Build the Color Map
import json, glob
# After calling get_highlights_by_color for PINK, BLUE, YELLOW, GREEN, PURPLE
# Results save to files when they exceed token limits
ann_color = {}
colors = ["PINK", "BLUE", "YELLOW", "GREEN", "PURPLE"]
for color_file, color in zip(sorted(glob.glob("path/to/results/*.txt")), colors):
with open(color_file, 'r') as f:
data = json.load(f)
current_id = None
for line in data.get("text", "").split("\n"):
line = line.strip()
if line.startswith("ID: "):
current_id = line.split("ID: ")[1].strip()
elif line.startswith("Selected text: ") and current_id:
selected = line[len("Selected text: "):]
if selected and selected != "None":
ann_color[current_id] = color
# Look up: ann_color.get(str(annotation_id), None) # None = underline
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2mo ago First seen · 182 lines · 81 tokens per session scan A 1dd70ce7c90d
apple-books-mcp is a skill published in the GitHub repository vladmdgolam/agent-skills (9 stars, last pushed 23d ago), licensed MIT. It adds 81 tokens to every session and 1,603 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
apple-books-mcp compared with skills from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| apple-books-mcpvladmdgolam/agent-skills | Skill | 9 | 23d ago | MIT | A | 81 | Claude Code, Codex |
| hr-onboardingnexu-io/open-design | Skill | 106k | today | Apache-2.0 | A | 62 | Claude Code, Codex |
| book-mirrorgarrytan/gbrain | Skill | 32k | today | MIT | A | 138 | Claude Code |
| exam-forecastanthropics/claude-for-legal | Skill | 9.9k | today | Apache-2.0 | A | 73 | Claude Code |
| lean-formalizewanshuiyin/Auto-claude-code-research-in-sleep | Skill | 19k | yesterday | MIT | A | 81 | Claude Code |
| eli5companion-inc/feynman | Skill | 10k | 6d ago | MIT | A | 63 | Claude Code, Codex |
| deck-course-modulenexu-io/html-anything | Skill | 9.4k | yesterday | Apache-2.0 | A | 25 | Claude Code, Codex |