# Ampworth documents

> Ampworth documents is a free MCP server for home energy. Search and read UK solar, heat pump, battery and MCS certification guides as Markdown. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API
- **Website:** https://ampworth.com/developers
- **MCP Registry name:** com.ampworth/documents
- **Categories:** home energy, solar energy
- **Listing updated:** 2026-11-16

## About

This is the documents half of Ampworth's open API. Three tools do the work: search_documents ranks results across titles, summaries and text, get_document returns one document in full as Markdown, and list_documents can be filtered by kind, category, level or perspective. When a query matches a single question in a question set, the search returns that question with its answer.

Each document comes with the MCS documents it draws on and links to the calculators that do its arithmetic, which suits an assistant answering UK home-energy questions from published standards. Guides include material such as sizing a heat pump. The server is stateless over Streamable HTTP, needs no key or sign-up and sends instructions about caveats every answer should carry.

A separate calculators server and a combined server are available from the same site, and an open-source command line can run it as a local server. Request logs hold the address, IP and user agent for 30 days.

## Features

- **Ranked search:** Searches titles, summaries and full text of every document.
- **Question matching:** Returns a specific question and answer when one matches the query.
- **Markdown documents:** Fetch a guide in full with its MCS references.
- **Filtered listing:** Browse by kind, category, level or perspective.
- **Open access:** No key or sign-up is needed.

## Good for

- Answer a homeowner's heat pump question from published guidance
- Look up what MCS requires for a solar installation
- Find a guide on flow temperature or sizing
- Give an assistant citeable UK source material

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http documents https://ampworth.com/mcp/documents
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://ampworth.com/mcp/documents
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "documents": {
      "url": "https://ampworth.com/mcp/documents"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "documents": {
      "type": "http",
      "url": "https://ampworth.com/mcp/documents"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "documents": {
      "serverUrl": "https://ampworth.com/mcp/documents"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "documents": {
      "type": "http",
      "url": "https://ampworth.com/mcp/documents"
    }
  }
}
```

## Tools

- `search_documents`: Search and rank documents
- `get_document`: Return one document in full as Markdown
- `list_documents`: List documents with filters

## FAQ

### What tools does it have?

search_documents, get_document and list_documents.

### Do I need an account?

No. It is open and unauthenticated.

### Is there a calculator server too?

Yes, a separate calculators server and a combined server are offered.

### What is logged?

The requested address, IP address and user agent, kept for 30 days.

### Is Ampworth documents free?

Yes. Ampworth documents is free to use.

### How do I add Ampworth documents to Claude Code?

Run this command in your terminal: claude mcp add --transport http documents https://ampworth.com/mcp/documents

### What are the best alternatives to Ampworth documents?

The closest alternatives to Ampworth documents are ElectricityFinder, Solrapport, DéclaClic : panneaux solaires, SparkReady and Sky Solar.

## Alternatives

- [ElectricityFinder](https://ai-powered.com/mcp/electricityfinder): ElectricityFinder is a freemium MCP server for energy and smart home.
- [Solrapport](https://ai-powered.com/mcp/solrapport): Solrapport is a freemium MCP server for solar energy.
- [DéclaClic : panneaux solaires](https://ai-powered.com/mcp/declaclic-panneaux-solaires): DéclaClic : panneaux solaires is a free MCP server for solar energy.
- [SparkReady](https://ai-powered.com/mcp/sparkready): SparkReady is a free MCP server for solar energy.
- [Sky Solar](https://ai-powered.com/mcp/sky-solar): Sky Solar is an MCP server for solar energy.
- [Opa Haardhout](https://ai-powered.com/mcp/opa-haardhout): Opa Haardhout is a free MCP server for local services.
- [Renewably](https://ai-powered.com/mcp/renewably): Renewably is a free MCP server for home energy.
- [VettedHome property guides](https://ai-powered.com/mcp/vettedhome-property-guides): VettedHome property guides is a free MCP server for home services.

---
Source: https://ai-powered.com/mcp/ampworth-documents
