# GlaziersEdge Knowledge

**GlaziersEdge Knowledge** is a free, hosted [Model Context Protocol](https://modelcontextprotocol.io) server that gives AI agents a
curated reference for **US commercial glass and glazing**: architectural glass makeups and performance
data, coated-glass and aluminum-framing "or equal" cross-references, safety-glazing, energy, impact and
fire code limits, and early-stage budget ranges. Every answer is cited to a topic and section and keeps
a confidence tag, so you can see how solid each item is.

```
https://glazing-mcp.glazingkb.workers.dev/mcp
```

Streamable HTTP · no sign-up, no API key · read-only · free during launch

> **Reference info; verify with manufacturer data, local code, and a licensed professional.**

This repository holds listing and connection information only. The server itself is hosted; there is
nothing to install.

---

## What it covers

- **Glass:** annealed, heat-strengthened, tempered, laminated, insulating glass, low-E and reflective
  coatings, spandrel, low-iron, heat soak, glass performance terms (VLT, SHGC, U-factor, LSG).
- **Glass performance data:** 227 one-inch insulating-glass makeups from Vitro, Guardian SunGuard and
  Viracon, filterable by maker, product, substrate, SHGC, VLT, U-value and LSG. Old product names are
  mapped to current ones.
- **Equivalents:** coated-glass equivalents across makers with a match rating
  (Close / Approximate / Not supported by the numbers), and storefront, curtain wall, entrance and window
  series equivalents across major aluminum framing manufacturers, with discontinued and renamed notices.
- **Codes and standards:** safety glazing (IBC 2406), energy (IECC, ASHRAE 90.1, Title 24),
  hurricane/impact, fire-rated glazing, wind load (ASTM E1300), railings and guards, testing standards.
- **Systems and practice:** storefront, curtain wall, all-glass/butt-glazed walls and doors, structural
  silicone, sealants, specs, submittals, warranties, lead times, estimating red flags.
- **Budget ranges:** experienced-estimator 2026 US installed budget ranges for early estimating and
  sanity checks. Never for bids.

32 topics in all, US national coverage.

### Confidence tags

Answers keep the knowledge base's tags. Agents are asked to pass them on to you.

| Tag | Meaning |
|---|---|
| `[V]` | Verified against a published source |
| `[V-mfr]` | Manufacturer-published claim |
| `[UNVERIFIED]` | Needs confirmation before you rely on it |
| `[inference]` | Reasoned from sources |
| `[Expert]` | Practitioner judgment (e.g. budget ranges) |

## Tools

| Tool | What it does |
|---|---|
| `list_topics` | Lists the 32 topics with one-line summaries and how many items in each are still unverified. |
| `get_topic` | Reads a full topic or one section (e.g. `30.4`, `sources`, `summary table`), with tables intact. Long topics are paged. |
| `search_glazing_knowledge` | Keyword (BM25) search across all topics. Returns cited snippets with topic and section ids, matching tables, and tags. |
| `lookup_glass_performance` | Filters center-of-glass data for 1 in. IGUs by maker, product, substrate, `max_shgc`, `min_vlt`, `max_u`, `min_lsg`. Returns VLT, reflectance, U (air/argon), SHGC, LSG and catalog status. |
| `cross_reference_glass` | Given a coating (e.g. `SNX 62/27`, `Solarban 70`, `VNE-53`), returns equivalents from other makers with a match rating. |
| `cross_reference_aluminum_system` | Given a framing series (e.g. `Kawneer Trifab 451`), returns equivalent series from other manufacturers with basis, status, and discontinued notices. |
| `budget_price_range` | `[Expert]` 2026 US installed budget ranges for a scope item (per SF, LF, each, or LS). Budget use only. |

All tools are read-only and idempotent (`readOnlyHint: true`, `destructiveHint: false`).

**Prompts:** `glazing_question` (answer a glazing question with citations) and `or_equal_substitution`
(find equivalents for a specified glass coating or framing series).
**Resources:** `glaziersedge://topics` (topic index) and `glaziersedge://disclaimer` (confidence tags and disclaimer).
**Server card:** `https://glazing-mcp.glazingkb.workers.dev/.well-known/mcp/server-card.json`

**Structured output:** every tool declares an `outputSchema` and returns matching `structuredContent`
(JSON records with the same data and tags), alongside the markdown text answer.

**Optional config:** none is required. Add `?detail_level=brief` to the endpoint URL to drop the
repeated confidence-tag legend from text answers (the tags on each item stay). Schema:
`https://glazing-mcp.glazingkb.workers.dev/.well-known/mcp-config`
Glass values are center-of-glass, not NFRC whole-product ratings.

## Example prompts

- "What's the Vitro equivalent of Guardian SunGuard SNX 62/27?"
- "Kawneer Trifab 451: what are the equals from other manufacturers?"
- "Max size for 1/2 in. tempered butt-glazed glass?"
- "IECC 2021 climate zone 2 fenestration SHGC and U-factor limits?"
- "List 1-inch IGUs with SHGC at or below 0.25 and VLT of at least 50%, sorted by LSG."
- "Which glazing locations does IBC 2406 treat as hazardous?"
- "Budget range per SF for exterior storefront?"

## Connect

The endpoint needs no headers or credentials.

**Claude (web, desktop, mobile):** Settings → Connectors → *Add custom connector* → paste
`https://glazing-mcp.glazingkb.workers.dev/mcp`.

**Claude Code:**

```bash
claude mcp add --transport http glazing https://glazing-mcp.glazingkb.workers.dev/mcp
```

**Claude Desktop config file** (`claude_desktop_config.json`, uses the `mcp-remote` bridge; needs Node.js):

```json
{
  "mcpServers": {
    "glazing": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://glazing-mcp.glazingkb.workers.dev/mcp"]
    }
  }
}
```

**Cursor** (`~/.cursor/mcp.json` or `.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "glazing": {
      "url": "https://glazing-mcp.glazingkb.workers.dev/mcp"
    }
  }
}
```

**VS Code** (`.vscode/mcp.json`):

```json
{
  "servers": {
    "glazing": {
      "type": "http",
      "url": "https://glazing-mcp.glazingkb.workers.dev/mcp"
    }
  }
}
```

**Windsurf** (`~/.codeium/windsurf/mcp_config.json`):

```json
{
  "mcpServers": {
    "glazing": {
      "serverUrl": "https://glazing-mcp.glazingkb.workers.dev/mcp"
    }
  }
}
```

**Gemini CLI** (`~/.gemini/settings.json`):

```json
{
  "mcpServers": {
    "glazing": {
      "httpUrl": "https://glazing-mcp.glazingkb.workers.dev/mcp"
    }
  }
}
```

**Codex CLI** (`~/.codex/config.toml`):

```toml
[mcp_servers.glazing]
url = "https://glazing-mcp.glazingkb.workers.dev/mcp"
```

**ChatGPT:** Settings → Apps & Connectors → Advanced settings → enable Developer mode → *Create*, then
paste the URL with authentication set to none.

**Any other client** that only supports local (stdio) servers:
`npx -y mcp-remote https://glazing-mcp.glazingkb.workers.dev/mcp`

Quick check from a terminal:

```bash
npx @modelcontextprotocol/inspector --cli https://glazing-mcp.glazingkb.workers.dev/mcp --transport http --method tools/list
```

## Pricing

**Free during launch.** Per-request agent payments (pay-per-call over the
[x402](https://www.x402.org) protocol, so agents can pay without an account) are planned for some
tools later. Topic browsing will stay free, and any change will be announced here before it takes
effect.

## Privacy and usage logging

Usage is logged anonymously to improve coverage: timestamp, tool name, a redacted and truncated query
(emails, phone numbers and long digit strings are masked), result count, latency, MCP client
name/version, a coarse user-agent family, and country. **No IP addresses, cookies, tokens or personal
data are stored.** Logs are deleted after 180 days. Don't put confidential project information in
queries.

## Disclaimer

This service provides general reference information for commercial glazing professionals. It is not
engineering, legal, or code-compliance advice, and it is not a substitute for manufacturer data,
the code adopted by your jurisdiction, project specifications, or review by a licensed professional.
Items tagged `[UNVERIFIED]` or `[inference]` need confirmation. Budget ranges are `[Expert]` estimates
that vary by region, scope and market, and must never be used for bids. Equivalents are screening aids:
"equivalent" does not mean identical, so check depth, glazing plane, glass thickness, thermal and
structural performance before substituting. Information may be out of date; product lines change.

**Reference info; verify with manufacturer data, local code, and a licensed professional.**

## License

The files in this repository are licensed under [CC BY-ND 4.0](LICENSE). The hosted service, its
knowledge base and its responses are proprietary, all rights reserved. See [NOTICE.md](NOTICE.md).
Product names are trademarks of their respective owners; this project is independent and not affiliated
with any manufacturer.

## Contact

Questions, corrections, or a product we got wrong:
[open an issue](https://github.com/shanethelion/glazing-mcp/issues).