BlazeBLOCK
Local-first, line-accurate search for blazing-fast lookups of llms.txt documentation. Human-friendly, Agent-ready.
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
blaze /bleɪz/ (verb, noun) 1. verb – Move or proceed at high speed; achieve something rapidly 2. noun – A trail marker, typically painted on trees with specific colors and patterns; a mark to guide explorers on their journey 3. abbr. – BLZ – A local-first search tool that indexes llms.txt documentation for instant, line-accurate retrieval
What is BLZ?
A Rust + Tantivy-based CLI tool that downloads, parses, and indexes llms.txt files locally to enable fast documentation search with line-accurate retrieval.
Quick Start
# Install (one line) curl -fsSL https://blz.run/install.sh | sh # Add Bun's docs blz add bun https://bun.sh/llms.txt # Search (results in 6ms) blz find "test runner" # Or just: blz "test runner" # Browse documentation structure blz toc bun --tree -H 1-2 # Pull exact lines (citations auto-detected) blz find bun:304-324 --json # Or: blz bun:304-324 --json
MCP Server Setup
Enable BLZ in your AI coding assistant with one command:
# Claude Code claude mcp add blz blz mcp-server --scope user # Cursor, Windsurf, and others # See detailed setup: docs/mcp/SETUP.md
What you'll see:
✓ Added bun (1,926 headings, 43,150 lines) in 890ms Search results for 'test runner' (6ms): 1. bun:304-324 (score: 92%) 📍 Bun Documentation > Guides > Test runner ### Test runner Bun includes a fast built-in test runner...
Docs
- Documentation index – Overview of every guide, reference, and technical deep dive.
- Quickstart guide – Install BLZ and run your first searches in minutes.
- Agent playbook – Best practices for using BLZ inside AI workflows.
- Architecture overview – Core components, storage layout, and performance notes.
What's llms.txt?
`llms.txt` is a simple Markdown standard for making documentation accessible to AI agents. `ll
3517e1c9fcc3OBSERVED · 2026-10-08Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add test_with_ts -- npx -y [email protected]
{
"mcpServers": {
"test_with_ts": {
"command": "npx",
"args": [
"-y",
"[email protected]"
]
}
}
}Exposed tools (1)
0 read · 1 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
add | write |
Trust audit
BLOCKgrade D · trust 69/100 Do not install this without reading the findings. The audit found something that could harm you or your machine.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | FAIL |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (9 observation(s))
- Network
- declared (3 observation(s))
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (25)
"../../.ssh/id_rsa",
long_content.push_str("👨👩👧👦"); // Family emoji (complex grapheme cluster)long_content.push_str("🏳️🌈"); // Rainbow flag (another complex emoji).actrc
.coderabbit.yaml
.github-issue-draft.md
.markdownlint-cli2.jsonc
.prettierignore
.agents/logs/CLAUDE.md
CLAUDE.md
crates/CLAUDE.md
crates/blz-cli/CLAUDE.md
crates/blz-core/CLAUDE.md
let workspace_doc = manifest_dir.join("../../docs/llms/blz/llms-full.txt");"../../../etc/passwd",
"../../.ssh/id_rsa",
"../../../etc/passwd",
assert!(storage.tool_dir("../../passwd").is_err());- **SSRF vulnerability** in `source-add`: URL validation doesn't prevent fetching from internal IP addresses (127.0.0.1, 169.254.169.254, etc.)
- **Attack Vector**: User provides URL to internal service (e.g., <http://169.254.169.254/latest/meta-data/>)
- **Attack Vector**: User provides URL to internal service (e.g., <http://169.254.169.254/latest/meta-data/>)
const transport = new SSEClientTransport(new URL(`http://127.0.0.1:8000/sse`));
const transport = new StreamableHTTPClientTransport(new URL(`http://127.0.0.1:8001/mcp/`));
@modelcontextprotocol/sdk, eventsource-parser, express
You are a senior Rust engineer working on a production-ready search cache system using Tantivy. You combine principled engineering practices with pragmatic delivery, embracing Rust's unique strengths
Gates applied: no_behavioural_pass.
3517e1c9fcc3full audit observations/trust-audit/mcp-server/outfitter-dev__blaze.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-08 | 3517e1c9fcc3 | BLOCK | D | 69 | first audit |
Questions
What is the Blaze MCP server?
Local-first, line-accurate search for blazing-fast lookups of llms.txt documentation. Human-friendly, Agent-ready.
What tools does Blaze expose?
1 in total: 0 read-only, 1 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is Blaze safe to connect to an agent?
No — not without reading the findings first. The audit graded it D (69/100) and found 1 critical or high issue in the source. Each one is listed on this page with the file and line it is on.
What credentials does Blaze need?
No credential environment variables were found in its source, so it appears to need none.
How does Blaze run?
It speaks stdio and streamable-http, so it runs as a local process your client starts. It is published on npm as test_with_ts at 1.0.0.
How current is this page?
The grade is for one exact copy of the source (3517e1c9fcc3), read on 2026-10-08. The repository is watched and re-audited when it changes.