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 ofershap/mcp-server-markdown --skill markdown-searchgit clone --depth 1 https://github.com/ofershap/mcp-server-markdownWrote 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/ofershap/mcp-server-markdown/markdown-search)<a href="https://agentmods.dev/skills/ofershap/mcp-server-markdown/markdown-search"><img src="https://agentmods.dev/badge/skills/ofershap/mcp-server-markdown/markdown-search/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/ofershap/mcp-server-markdown/markdown-search"><img src="https://agentmods.dev/badge/skills/ofershap/mcp-server-markdown/markdown-search.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.00052 | $0.00494 |
| Opus 5.5 | $0.00021 | $0.00198 |
| Sonnet 5.5 | $0.00010 | $0.00099 |
| Haiku 4.5 | $0.00005 | $0.00049 |
Grade A, and why
markdown-search 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 1mo 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 — 42 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Markdown Search via MCP
Use this skill when you need to search documentation, extract sections, list headings, or find code blocks across local markdown files.
Available Tools
| Tool | What it does |
|---|---|
list_files |
List all .md files in a directory recursively |
search_docs |
Full-text search across all .md files (case-insensitive, up to 50 results) |
get_section |
Extract a section by heading until the next heading of same/higher level |
list_headings |
List all headings as a table of contents |
find_code_blocks |
Find fenced code blocks, optionally filter by language |
get_frontmatter |
Parse YAML frontmatter metadata from a file |
Workflow
list_filesto discover documentation files in the projectsearch_docsfor full-text search across all docslist_headingsto get the table of contents for a specific fileget_sectionto extract a specific section by its heading textfind_code_blocksto find code examples, optionally filtered by language
Key Patterns
get_sectionextracts everything under a heading until the next heading of same or higher levelfind_code_blockswithlanguage: "typescript"filters to only TS examplessearch_docsis case-insensitive and returns up to 50 matches with surrounding context- Unlike the filesystem MCP, this server understands markdown structure (headings, sections, code fences)
Error Scenarios
- No matches from
search_docs: widen the query, check the directory path, or confirm files use.mdextension get_sectionnot found: heading text must match (including#level); uselist_headingsfirst- Permission or missing path errors: verify the directory exists and is readable on the host running the MCP server
- More than 50 search hits: refine the query or search a smaller subdirectory
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.
- 1mo ago First seen · 42 lines · 52 tokens per session scan A ec41d932c7a0
markdown-search is a skill published in the GitHub repository ofershap/mcp-server-markdown (8 stars, last pushed 9d ago), licensed MIT. It adds 52 tokens to every session and 494 once invoked, about $0.0002 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-31.
Other skills, from other repositories
ppt-creator
Create professional slide decks from topics or source documents, including structured content, charts, speaker notes, and complete PPTX outputs. Use when the user needs presentations, pitches, slide decks, or keynote-style materials.
Read, extract, merge, split, rotate, watermark, create, fill, encrypt, decrypt, and OCR PDF files. Use when the user mentions PDFs or needs any document workflow centered on .pdf files.
policy-drift-audit
Run the policy/process drift audit. Surfaces stale, superseded, duplicate, non-canonical, and conflicting policy documents using DocGraph's built-in drift engine. Presents findings and optional remediation suggestions without writing governance decisions.
pn-financial-model-audit
Audit a financial model (spreadsheet, structured table, or agent-produced model) for hardcoded values, broken formula logic, balance-sheet balance, circular references, and missing cross-checks. Use after any DCF, LBO, comps, or 3-statement model is built before it is used in a deliverable.
markitdown
Convert files and office documents to Markdown, including PDFs, Office files, images with OCR, audio with transcription, HTML, archives, and structured data. Use when the user needs markdown extraction or document-to-markdown conversion.
pn-create-mcp-architecture
Create MCP.md documenting MCP servers in use, purpose, and integration points. Use when project uses multiple MCPs or needs MCP documentation.