English Français العربية

OwnerSpec

Official registry AI and agents

Cited home water treatment answers, part matching and sizing calculators for AI agents.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http ownerspec 'https://ownerspec.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "ownerspec": {
            "type": "http",
            "url": "https://ownerspec.com/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. OwnerSpec MCP Server
  2. Connect
  3. Tools
  4. A2A agent
  5. Markdown for agents
  6. Transparency
  7. Self-hosting
  8. License

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/mcp

Claude.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/mcp

Tools

ToolWhat it does
search_pagesFull-text search over every page, filterable by layer (guides, calculators, parts, reviews) and topic
get_pageFetch one page as clean Markdown with canonical URL, dates and sources
get_quick_answerThe 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_problemSymptom or lab result in, the matching diagnosis guides and their quick answers out
find_replacement_partModel or part number in, the cartridges, lamps or parts that fit out, with product links
get_product_picksThe picks from the review and parts pages that match a need, with Amazon product links
convert_water_hardnessgpg, mg/L, dH, fH, Clark and mmol/L, with the USGS band
size_water_softenerGrain 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:

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:

  1. Deploy the functions/ directory with a Cloudflare Pages project in front of a static site.
  2. 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 the SITE constant at your deployment.
  3. Replace the calculator constants in mcp.js with 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

MIT

Frequently asked questions

What is OwnerSpec?

Cited home water treatment answers, part matching and sizing calculators for AI agents.

How do I install OwnerSpec?

It runs as a remote server. In Claude Code: claude mcp add --transport http ownerspec 'https://ownerspec.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does OwnerSpec need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is OwnerSpec open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains OwnerSpec?

It is published by ownerspec-com. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.