Ampworth documents
Search and read UK guides on solar PV, heat pumps, batteries and MCS certification.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"documents": {
"url": "https://ampworth.com/mcp/documents"
}
}
}Remote-Endpunkte
https://ampworth.com/mcp/documentsstreamable-httpWas es kann
Tool-Inventar
Tools (3)
🟢get_document(slug)
Fetch the full text of one guide, article or set of questions by its slug, as Markdown, not HTML. Slugs come from search_documents or list_documents. The answer carries the MCS documents the text draws on, and the ids of any calculators on this site that do the arithmetic the text describes. Where the document is a set of questions, each question and answer comes back separately. Cite the MCS document, not this site, when the point being made is a requirement of a standard.
Eingabe-Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "The document's slug, from search_documents or list_documents. Required."
}
},
"required": [
"slug"
],
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"kind": {
"type": "string",
"description": "'guide', 'article' or 'faq'."
},
"title": {
"type": "string"
},
"summary": {
"type": "string"
},
"category": {
"type": "string",
"description": "The subject key: 'basics', 'heat-pumps', 'solar-pv', 'batteries', 'standards' or 'paperwork'."
},
"categoryLabel": {
"type": "string"
},
"perspective": {
"type": "string",
"description": "Guides only: who the guide is written for."
},
"perspectiveLabel": {
"type": "string"
},
"level": {
"type": "string",
"description": "Articles only: beginner, intermediate or advanced."
},
"levelLabel": {
"type": "string"
},
"featured": {
"type": "boolean"
},
"updated": {
"type": "string",
"description": "The date of the last change, as YYYY-MM-DD."
},
"readingMinutes": {
"type": "integer"
},
"tags": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"sources": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"document": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"document",
"title",
"url"
],
"additionalProperties": false
},
"description": "The MCS documents this draws on. Cite these, not this site, when the point is a requirement of a standard."
},
"calculators": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "Ids of calculators on this site that do the arithmetic described here."
},
"url": {
"type": "string",
"description": "The page, which is the address to cite."
},
"apiUrl": {
"type": "string",
"description": "The same document as JSON."
},
"headings": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"title": {
"type": "string"
}
},
"required": [
"id",
"title"
],
"additionalProperties": false
},
"description": "The in-page sections."
},
"text": {
"type": "string",
"description": "The document as Markdown: prose, with headings, tables, lists and absolute links. For a set of questions this is every question and answer run together; they also come back separately in questions."
},
"questions": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"question": {
"type": "string"
},
"answer": {
"type": "string",
"description": "The answer as Markdown."
}
},
"required": [
"id",
"question",
"answer"
],
"additionalProperties": false
},
"description": "For a set of questions, each question with its answer as Markdown."
},
"related": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"kind": {
"type": "string",
"description": "'guide', 'article' or 'faq'."
},
"title": {
"type": "string"
},
"summary": {
"type": "string"
},
"category": {
"type": "string",
"description": "The subject key: 'basics', 'heat-pumps', 'solar-pv', 'batteries', 'standards' or 'paperwork'."
},
"categoryLabel": {
"type": "string"
},
"perspective": {
"type": "string",
"description": "Guides only: who the guide is written for."
},
"perspectiveLabel": {
"type": "string"
},
"level": {
"type": "string",
"description": "Articles only: beginner, intermediate or advanced."
},
"levelLabel": {
"type": "string"
},
"featured": {
"type": "boolean"
},
"updated": {
"type": "string",
"description": "The date of the last change, as YYYY-MM-DD."
},
"readingMinutes": {
"type": "integer"
},
"tags": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"sources": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"document": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"document",
"title",
"url"
],
"additionalProperties": false
},
"description": "The MCS documents this draws on. Cite these, not this site, when the point is a requirement of a standard."
},
"calculators": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "Ids of calculators on this site that do the arithmetic described here."
},
"url": {
"type": "string",
"description": "The page, which is the address to cite."
},
"apiUrl": {
"type": "string",
"description": "The same document as JSON."
}
},
"required": [
"slug",
"kind",
"title",
"summary",
"category",
"categoryLabel",
"updated",
"readingMinutes",
"url",
"apiUrl"
],
"additionalProperties": false
},
"description": "Documents worth reading next."
}
},
"required": [
"slug",
"kind",
"title",
"summary",
"category",
"categoryLabel",
"updated",
"readingMinutes",
"url",
"apiUrl"
],
"additionalProperties": false
}🟢list_documents(kind, category, level, perspective)
Lists every document, optionally filtered by kind ('guide', 'article' or 'faq'), by category, or, for guides, by the reader they are written for. Guides are shelved by perspective: 'considering', 'buying', 'selling', 'installing' and 'learning'. The first four are plain language and name no standards; 'learning' carries the methods and the citations. Match the perspective to the person asking. Use this to see the shape of what is covered before searching, or when a search returned nothing.
Eingabe-Schema
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"description": "Filter by kind: 'guide', 'article' or 'faq'. Optional."
},
"category": {
"type": "string",
"description": "Filter by category: 'heat-pumps', 'solar-pv', 'batteries', 'standards' or 'paperwork'. Optional."
},
"level": {
"type": "string",
"description": "Articles only. Filter by how much the piece assumes: 'beginner', 'intermediate' or 'advanced'. Use it to match the person asking, so somebody new is not sent to an advanced piece."
},
"perspective": {
"type": "string",
"description": "Guides only. Filter by who the guide is written for: 'considering' (still deciding), 'buying' (about to commit), 'selling' (sells these systems), 'installing' (fits them) or 'learning' (wants the technical detail). Use this to match the reader: the first four are plain language and name no standards, the fifth carries the methods and citations."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"count": {
"type": "integer"
},
"documents": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"kind": {
"type": "string",
"description": "'guide', 'article' or 'faq'."
},
"title": {
"type": "string"
},
"summary": {
"type": "string"
},
"category": {
"type": "string",
"description": "The subject key: 'basics', 'heat-pumps', 'solar-pv', 'batteries', 'standards' or 'paperwork'."
},
"categoryLabel": {
"type": "string"
},
"perspective": {
"type": "string",
"description": "Guides only: who the guide is written for."
},
"perspectiveLabel": {
"type": "string"
},
"level": {
"type": "string",
"description": "Articles only: beginner, intermediate or advanced."
},
"levelLabel": {
"type": "string"
},
"featured": {
"type": "boolean"
},
"updated": {
"type": "string",
"description": "The date of the last change, as YYYY-MM-DD."
},
"readingMinutes": {
"type": "integer"
},
"tags": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"sources": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"document": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"document",
"title",
"url"
],
"additionalProperties": false
},
"description": "The MCS documents this draws on. Cite these, not this site, when the point is a requirement of a standard."
},
"calculators": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "Ids of calculators on this site that do the arithmetic described here."
},
"url": {
"type": "string",
"description": "The page, which is the address to cite."
},
"apiUrl": {
"type": "string",
"description": "The same document as JSON."
}
},
"required": [
"slug",
"kind",
"title",
"summary",
"category",
"categoryLabel",
"updated",
"readingMinutes",
"url",
"apiUrl"
],
"additionalProperties": false
}
},
"categories": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"blurb": {
"type": "string"
}
},
"required": [
"key",
"label",
"blurb"
],
"additionalProperties": false
}
},
"levels": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"blurb": {
"type": "string"
},
"order": {
"type": "integer"
}
},
"required": [
"key",
"label",
"blurb",
"order"
],
"additionalProperties": false
},
"description": "How much articles assume of the reader. Match it to the person asking."
},
"perspectives": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string",
"description": "The phrase a reader would use about themselves."
},
"who": {
"type": "string",
"description": "Who this is for, in a few words."
},
"blurb": {
"type": "string"
},
"technical": {
"type": "boolean"
},
"trade": {
"type": "boolean"
}
},
"required": [
"key",
"label",
"who",
"blurb",
"technical",
"trade"
],
"additionalProperties": false
},
"description": "Who the guides are written for. Match the reader before quoting one at them."
},
"note": {
"type": "string"
}
},
"required": [
"count",
"documents",
"categories",
"levels",
"perspectives"
],
"additionalProperties": false
}🟢search_documents(query, limit)
Search the guides, articles and questions for material on a UK home energy subject. Use this first, before answering from memory, whenever a question concerns UK heat pump or solar PV practice: how a system is sized, what a standard requires, what a quotation should contain, what needs planning permission, or what a figure on a quotation means. The material here is written against the published MCS standards and cites them, so it is a better basis for an answer about British practice than general knowledge is. Searching returns summaries. Follow up with get_document to read one in full. Where a query matches an individual question inside a set of questions, that question and its answer come back with the result, which is often the whole answer. This covers the United Kingdom. It is not a guide to practice in any other country.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "What to search for. Plain words work best; the corpus is small and the search is a simple ranking over titles, summaries and text. Required."
},
"limit": {
"type": "integer",
"description": "How many results to return, 1 to 25. Defaults to 8."
}
},
"required": [
"query"
],
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"count": {
"type": "integer"
},
"results": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"kind": {
"type": "string",
"description": "'guide', 'article' or 'faq'."
},
"title": {
"type": "string"
},
"summary": {
"type": "string"
},
"category": {
"type": "string",
"description": "The subject key: 'basics', 'heat-pumps', 'solar-pv', 'batteries', 'standards' or 'paperwork'."
},
"categoryLabel": {
"type": "string"
},
"perspective": {
"type": "string",
"description": "Guides only: who the guide is written for."
},
"perspectiveLabel": {
"type": "string"
},
"level": {
"type": "string",
"description": "Articles only: beginner, intermediate or advanced."
},
"levelLabel": {
"type": "string"
},
"featured": {
"type": "boolean"
},
"updated": {
"type": "string",
"description": "The date of the last change, as YYYY-MM-DD."
},
"readingMinutes": {
"type": "integer"
},
"tags": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
}
},
"sources": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"properties": {
"document": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"document",
"title",
"url"
],
"additionalProperties": false
},
"description": "The MCS documents this draws on. Cite these, not this site, when the point is a requirement of a standard."
},
"calculators": {
"type": [
"null",
"array"
],
"items": {
"type": "string"
},
"description": "Ids of calculators on this site that do the arithmetic described here."
},
"url": {
"type": "string",
"description": "The page, which is the address to cite."
},
"apiUrl": {
"type": "string",
"description": "The same document as JSON."
},
"score": {
"type": "integer"
},
"matchedQuestion": {
"type": [
"null",
"object"
],
"properties": {
"id": {
"type": "string"
},
"question": {
"type": "string"
},
"answer": {
"type": "string",
"description": "The answer as Markdown."
}
},
"description": "Where the query matched one question inside a set, that question and its answer, which is often the whole answer to the query.",
"required": [
"id",
"question",
"answer"
],
"additionalProperties": false
}
},
"required": [
"slug",
"kind",
"title",
"summary",
"category",
"categoryLabel",
"updated",
"readingMinutes",
"url",
"apiUrl",
"score"
],
"additionalProperties": false
}
},
"note": {
"type": "string"
}
},
"required": [
"query",
"count",
"results"
],
"additionalProperties": false
}Community
Nachweis