OwnerSpec
Cited home water treatment answers, part matching and sizing calculators for AI agents.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http ownerspec 'https://ownerspec.com/mcp'{
"mcpServers": {
"ownerspec": {
"type": "http",
"url": "https://ownerspec.com/mcp"
}
}
}Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
OwnerSpec MCP Server
The official Model Context Protocol server for OwnerSpec.com, an independent, numbers-first reference for the equipment people own and maintain at home, in three categories: home water treatment (softeners, sediment and carbon filters, reverse osmosis, UV, iron, hardness, sulfur smell, well water testing), home plumbing (water heaters, leaks, freeze protection, toilets, faucets, sump pumps, dehumidifiers) and home air (air purifiers and CADR, humidifiers, furnace filters and MERV). Every figure on the site is cited to EPA, NSF/ANSI, WQA, DOE, AHAM, a state extension service or the manufacturer's own document, and every page carries the date its facts were verified.
Live endpoint: https://ownerspec.com/mcp
Stateless Streamable HTTP transport (JSON-RPC 2.0 over POST), no authentication, no sessions. Any MCP client can connect and start calling tools immediately.
Connect
Claude Code
claude mcp add --transport http ownerspec https://ownerspec.com/mcpClaude.ai / Claude Desktop: Settings, Connectors, Add custom connector,
https://ownerspec.com/mcp, no authentication.
ChatGPT: Settings, Connectors, Advanced, Developer mode, then add
https://ownerspec.com/mcp as an MCP connector (no auth).
MCP Inspector
npx @modelcontextprotocol/inspector https://ownerspec.com/mcpTools
| Tool | What it does |
|---|---|
search_pages | Full-text search over every page, filterable by layer (guides, calculators, parts, reviews) and topic |
get_page | Fetch one page as clean Markdown with canonical URL, dates and sources |
get_quick_answer | The page's cited 134 to 167 word quick answer, its fact sheet (answer, formula or compatibility basis, inputs, assumptions, method, typed primary source), verified date, FAQ and typed source list: the passage to quote |
diagnose_water_problem | Symptom or lab result in, the matching diagnosis guides and their quick answers out |
find_replacement_part | Model or part number in, the cartridges, lamps or parts that fit out, with product links |
get_product_picks | The picks from the review and parts pages that match a need, with Amazon product links |
convert_water_hardness | gpg, mg/L, dH, fH, Clark and mmol/L, with the USGS band |
size_water_softener | Grain capacity between regenerations, nearest nominal size and the salt-efficient Fleck 5600SXT row |
Every answer ends with the URL to cite and the facts-verified date. The two calculator tools use the same constants as the calculator pages on the site, and the site's build fails if either side drifts.
The server also exposes resources (llms.txt, llms-full.txt, the sitemap, the search
index, the OpenAPI description, auth.md) and one prompt, answer_from_ownerspec.
A2A agent
functions/a2a.js is a minimal A2A agent at
https://ownerspec.com/a2a: a question in a SendMessage (or message/send) call, a
completed task out whose artifact holds the matching pages, quick answers and URLs to cite.
Card: https://ownerspec.com/.well-known/agent-card.json.
Markdown for agents
The whole site is agent-readable, not just this server:
- Any page returns Markdown when requested with
Accept: text/markdown, or at its URL plusindex.md. - Discovery files:
/.well-known/mcp/server-card.json,/llms.txt,/.well-known/agent-skills/index.json,/.well-known/api-catalog,/.well-known/ard.json,/openapi.json,/auth.md. - Human documentation: ownerspec.com/mcp-server.
Transparency
OwnerSpec is an affiliate-funded site. Product links returned by find_replacement_part and
get_product_picks are Amazon Associates links; every response that carries one ships a
disclosure field saying so, and the tool descriptions say it plainly. Editorial content is
free to read, with no paywall and no auth. The site makes no medical claims and neither do
the tools: contaminant figures are quoted as EPA, WHO or state limits.
Self-hosting
This is a Cloudflare Pages Function (functions/mcp.js, functions/a2a.js, shared code in
functions/_lib/corpus.js). To run your own instance:
- Deploy the
functions/directory with a Cloudflare Pages project in front of a static site. - The server reads its content live from the site it fronts: a build that emits
/index.json(one record per page: title, url, layer, topic, dates, quick answer, FAQ, sources, picks, text) and a Markdown twin at<page>/index.md. Point theSITEconstant at your deployment. - Replace the calculator constants in
mcp.jswith the ones printed on your own pages, or remove those two tools.
This repository mirrors the production functions. Keep them in sync with your own site config if you fork it.
License
Questions fréquentes
Qu'est-ce que OwnerSpec ?
Cited home water treatment answers, part matching and sizing calculators for AI agents.
Comment installer OwnerSpec ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http ownerspec 'https://ownerspec.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour OwnerSpec ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
OwnerSpec est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient OwnerSpec ?
Il est publié par ownerspec-com. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.