OwnerSpec for AI agents: MCP server, A2A agent and discovery files
Connect an AI assistant to OwnerSpec's cited answers: an MCP server at /mcp with 8 read-only tools and no authentication, plus A2A, Markdown and discovery files.
- Updated
- 4 min read
OwnerSpec publishes its content for agents the same way it publishes it for people: the figure, the formula and the source, with the canonical URL and the date the facts were last checked. This page is the technical reference for connecting an assistant to it.
Endpoint
The MCP (Model Context Protocol) server is https://ownerspec.com/mcp. It is a stateless
Streamable HTTP server: JSON-RPC 2.0 over POST, one JSON response per request, no sessions,
no SSE stream, no authentication. GET returns 405 by design.
Adding it to a client
| Client | Steps |
|---|---|
| Claude (web or desktop) | Settings, Connectors, Add custom connector, paste https://ownerspec.com/mcp, choose “No authentication” |
| Claude Code | claude mcp add --transport http ownerspec https://ownerspec.com/mcp |
| ChatGPT | Settings, Connectors, Advanced, Developer mode, add https://ownerspec.com/mcp, no authentication |
| Perplexity (Pro, Max, Enterprise) | Settings, Connectors, Custom connector, Remote, paste the endpoint, authentication “None” |
| MCP Inspector | npx @modelcontextprotocol/inspector https://ownerspec.com/mcp |
The tools
| Tool | What it returns |
|---|---|
search_pages | Full-text search over every page, filterable by layer (guides, calculators, parts, reviews) and topic |
get_page | One page as clean Markdown with its canonical URL, dates and sources |
get_quick_answer | The page’s cited quick answer (134 to 167 words), the facts-verified date and the source list: the passage to quote |
diagnose_water_problem | A symptom or lab result in, the matching diagnosis guides and their quick answers out |
find_replacement_part | A model or part number in, the replacement cartridges, lamps or parts that fit, 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 | Any hardness reading converted to gpg, mg/L, dH, fH, Clark and mmol/L with the USGS band |
size_water_softener | Grain capacity between regenerations from people, use, hardness, iron and days, with the nominal size and the salt-efficient Fleck 5600SXT row |
Every tool answer ends with the URL to cite and, where the page carries one, the date its facts were verified. The two calculator tools use exactly the formulas and constants printed on the calculator pages, so a number from the tool and a number from the page always agree.
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, that
walks an assistant through search, quick answer and citation.
Example prompts
- “My well water smells like rotten eggs. Which treatment class handles that?” (diagnose, then cite the guide)
- “Which filters fit an iSpring RCC7AK?” (part match with product links)
- “Size a softener for 4 people at 18 gpg with 1 mg/L iron, regenerating weekly.”
- “Convert 14 dH to grains per gallon and tell me if that is hard water.”
What it does not do
It does not sell, install or service anything, and it never fetches live prices or stock. Product links go to the retailer’s ordinary product page. It gives no medical advice: contaminant figures are EPA, WHO or state limits quoted from the page that cites them.
Limits
Read-only, public, no rate limit published. Be a good citizen: identify your client with a
descriptive User-Agent and cache index.json rather than searching a hundred times a minute.
A2A agent
An A2A (Agent-to-Agent) endpoint at https://ownerspec.com/a2a accepts a plain-language
question in a SendMessage (or message/send) call and returns a completed task whose
artifact holds the best-matching pages, their quick answers and the URLs to cite. The agent
card is /.well-known/agent-card.json.
Affiliate disclosure
OwnerSpec is funded by affiliate commission. Product links returned by
find_replacement_part and get_product_picks are Amazon Associates links: a purchase may
earn OwnerSpec a commission at no extra cost to the buyer. Every response that carries such a
link says so, and an assistant presenting them should say so once too. Editorial content is
free to read, with no paywall and no account.
Discovery files
| File | Purpose |
|---|---|
/.well-known/mcp/server-card.json | MCP server card (SEP-1649) |
/.well-known/agent-card.json | A2A agent card |
/.well-known/agent-skills/index.json | Agent Skills discovery index with the ownerspec skill |
/.well-known/api-catalog | RFC 9727 API catalog |
/.well-known/ard.json | Agentic Resource Discovery manifest |
/openapi.json | OpenAPI 3.1 description of the read-only endpoints |
/auth.md | Authentication policy: none required |
/llms.txt, /llms-full.txt | Site index and full text for language models |
/index.json | The search index the tools read |
Every page is also served as Markdown: append index.md to its URL, or send
Accept: text/markdown.
Source code
The server is a single Cloudflare Pages Function, published under the MIT licence at github.com/ownerspec-com/mcp-server.
Policies
Editorial policy, affiliate disclosure, terms of use (quoting with attribution and a link is permitted), privacy. Questions: [email protected].