Skip to content
MCP server

Ampworth documents

Search and read UK solar, heat pump, battery and MCS certification guides as Markdown

Pricing
Free
Platforms
Web, API
Runs
Remotely
Version
1.0.20261016
Listing updated
1 day ago

About Ampworth documents

Ampworth documents is a free MCP server for home energy. It runs as a hosted remote server, so there is nothing to install locally.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://ampworth.com/mcp/documents
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "documents": {
      "url": "https://ampworth.com/mcp/documents"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Free

Free, no key or sign-up

Prices change. Check ampworth.com before you buy.

Ampworth documents 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 to Ampworth documents

  1. Rank Texas electricity plans by yearly cost at your own monthly usage

    • 3 tools
    • Remote
    • Freemium
    • Energy and smart home
  2. Solrapport

    MCP server

    Yearly direct-sun hours for Norwegian addresses, computed against terrain and trees

    Not checked yet
    • Remote
    • Freemium
    • Solar energy
  3. Checks a French address for rooftop solar rules: parcel, PLU zone and heritage protection

    Not checked yet
    • 2 tools
    • Remote
    • Free
    • Solar energy
  4. SparkReady

    MCP server

    Plain-language NSW and Australian guides to solar, battery and home energy loans

    Not checked yet
    • Remote
    • Free
    • Solar energy
  5. Sky Solar

    MCP server

    Munich-area solar installer with a roof check, local subsidy lookup and feed-in guide

    Not checked yet
    • Remote
    • Contact sales
    • Solar energy
  6. Opa Haardhout

    MCP server

    Find Dutch firewood sellers by postcode and compare price bands per wood type

    Not checked yet
    • 5 tools
    • Remote
    • Free
    • Local services