HPE Knowledgebase MCP server
Read HPE Support Center documents as text for LLM agents, covering retrieval, topic listing, keyword search, and Morpheus release lookup.
Read HPE documents (
get_hpe_document): fetch the full text of any support.hpe.com document by baredocIdor URL; returns a topic list for multi-page docs, or passpage/include_all_topics=trueandmax_charsto control output.List document topics (
list_hpe_document_topics): get a cheap table of contents for a document when you only need one section (e.g. "Fixes").Search the HPE knowledgebase (
search_hpe_kb): keyword search withmax_results— requires a signed-in HPE session, otherwise returnsauthentication_required.Find the latest Morpheus release (
get_latest_morpheus_release): report the newest known release formorpheus-enterpriseormorpheus-vm-essentials, with version, month, and link.Session-free document reading: public documents need no credentials; caching, throttling, explicit truncation, and error objects are handled server-side.
Provides tools for reading HPE Support Center knowledgebase documents as text, listing document topics, searching the knowledgebase when an authenticated session is available, and checking the latest known HPE Morpheus release.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@HPE Knowledgebase MCP server What changed in the latest Morpheus Enterprise release?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
HPE Knowledgebase MCP server
An MCP server that reads HPE Support Center documents and hands them to an LLM agent as text. Built for HPE Morpheus Enterprise Agents, but it is a plain MCP server and works with any client.
Independent community project. Not an official HPE product, and neither endorsed by nor affiliated with Hewlett Packard Enterprise.
Why this exists
An agent with a web search tool can find HPE documentation but cannot read
it. support.hpe.com/hpesc/public/docDisplay?docId=... is a JavaScript viewer:
fetch that URL and you get about 9 KB of navigation chrome and no document text.
So an agent asked "what changed in the latest release" ends up reasoning from
search-result snippets, and says it could not confirm anything.
Underneath the viewer is a plain, unauthenticated API that serves the same documents as HTML and JSON. This server talks to it.
Endpoint | Returns |
| the whole document ( |
| topic list, each with a render link |
| one topic, as JSON with a |
| needs a signed-in HPE account |
The asymmetry is the thing to understand: HPE serves documents anonymously but
gates search behind a login. So discovery and retrieval are split — a local
document catalog (find_hpe_document, if you configure one) or the agent's own
web search finds the docId, and this server reads the document.
Related MCP server: Jamf Docs MCP Server
Tools
Tool | What it does |
| Reads a document as text. Takes a bare |
| Table of contents only — cheap when you want just "Fixes". |
| Keyword search. Requires |
| Finds HPE documents by title in a local catalog you point |
| Newest release this server knows about, with version, month and link. |
About find_hpe_document
No catalog ships with this server. Build a JSON file of the documents you care
about and set HPE_KB_CATALOG to its path:
{
"snapshot": "2026-10-15",
"documents": [
{"doc_id": "sd00008803en_us", "title": "HPE Morpheus Enterprise Software v9.1.0 Release Notes",
"kind": "release-notes", "products": ["enterprise"], "date": "2026-10-15"}
]
}It holds ids, titles, kinds, products and dates only, never document text;
get_hpe_document reads the text live. One way to fill it is the document list
of an HPE Support Center product page, which a browser can export; keep only
public documents, since restricted ones need a signed-in account to read.
Every query word must match the start of a title word (9.1 finds v9.1.0).
product is one of enterprise, advanced, vm-essentials, all,
cloudops, other; kind is one of release-notes, documentation, guide,
advisory, notice, bulletin, kb-article. Documents tagged all match any
product filter. The file is read on every call, so replacing it needs no restart.
About get_latest_morpheus_release
It compares a configured list of release-notes documents rather than querying HPE, because there is no anonymous search API to query. Seeded with the Morpheus Enterprise and VM Essentials release notes that exist today.
Point HPE_KB_DOCUMENTS at your own JSON file to extend it:
[
{"product": "morpheus-enterprise", "doc_id": "sd00008803en_us"},
{"product": "morpheus-enterprise", "doc_id": "dp00008463en_us"}
]Document ids are not sequential and the prefix changes between releases
(sd…, then dp… for 9.0.2, then sd… again for 9.1.0), so a new release
means a new entry — nothing here guesses a URL pattern. The tool says so in its own output, and the agent can always find a
newer document id with one narrow web search and read it with get_hpe_document.
Install and run
Run it from a checkout:
git clone https://github.com/tgessendorfer/hpe-kb-mcp
cd hpe-kb-mcp
python3 -m venv .venv
./.venv/bin/pip install -e .
# For Morpheus (network-reachable):
./.venv/bin/python -m hpe_kb_mcp.server --transport streamable-http --host 0.0.0.0 --port 8081
# For local testing with a stdio client:
./.venv/bin/python -m hpe_kb_mcp.server --transport stdioThere is no published package — this is not on PyPI and is not meant to be installed by name.
Flag / variable | Default | Notes |
|
| |
|
| |
|
| endpoint path |
| off | try it if the Morpheus client fails to hold a session |
| off | turns on DNS-rebinding protection; repeatable. Off means any |
| unset | only needed for |
|
| seconds |
|
| seconds between upstream requests |
Nothing here needs credentials for public product documentation. Set
HPE_SESSION_COOKIE (the Cookie header value from a signed-in browser
session) only if you need search or a gated document; sessions expire, so treat
that as a convenience, not infrastructure.
As a service
# /etc/systemd/system/hpe-kb-mcp.service
[Unit]
Description=HPE knowledgebase MCP server
After=network-online.target
[Service]
User=hpe-kb
WorkingDirectory=/opt/hpe-kb-mcp
ExecStart=/opt/hpe-kb-mcp/.venv/bin/python -m hpe_kb_mcp.server \
--transport streamable-http --host 0.0.0.0 --port 8081
Restart=on-failure
Environment=HPE_KB_CACHE_TTL=3600
[Install]
WantedBy=multi-user.targetWiring it into HPE Morpheus
Tools > AI Services > MCP Servers → add this server's URL (
http://<host>:8081/mcp).Tools > AI Services > Agents → edit the agent and add it alongside
Morpheus (Built-in).Leave Read-only mode unchecked on the agent — see below.
Start a new conversation — an existing one keeps the tool catalog it opened with.
Read-only agents cannot call external tools. Verified against Morpheus 9.0.1: an agent with Read-only mode checked discovers and loads these tools happily, then fails every call with
Write operations are disabled for this agent (read-only mode). Morpheus classifies every external MCP tool as a write. Declaring the tools read-only does not help — they all carryreadOnlyHint, and 9.0.1 ignores it. The setting only ever guarded Morpheus's own write tools, so unchecking it exposes nothing about this server, whose four tools are GETs againstsupport.hpe.com. To keep that guard, run two agents: a read-only one without this server, and a documentation one with it.
Do not verify a registration by asking the agent whether it has
get_hpe_document — it will say no even when everything works. Morpheus does
not put external tools in the model's prompt; it exposes them through
search_external_tools and load_external_tools, and renames them
external__<id>__<tool>. Ask it to run search_external_tools instead. Nothing
reaches this server between registration and the first real call, so a quiet
access log is expected.
Worth adding to the agent's system prompt, since it steers the split cleanly:
For questions about HPE product releases, documentation or known issues, use the HPE knowledgebase tools. Use the Morpheus tools for what is actually deployed on this appliance. Never state a release version from memory. When citing a document, print its full URL as plain text on its own line — not markdown link syntax, and not the bare document id.
That last line is a workaround for the chat UI, which renders neither markdown
links nor bare URLs as anchors (Morpheus 9.0.1). Nothing here can produce a
clickable link; a full URL is at least selectable in one go, where a bare
dp00008463en_us leaves the reader to assemble it. Drop the line if a later
release renders markdown — the tools already return a url field, so proper
links come back for free.
The appliance must be able to reach this server. Runs happily next to the appliance or on it.
HPE Morpheus 9.1.0 refuses MCP servers on private addresses. If this server
has an RFC1918, IPv6 ULA or CGNAT address, every tool call fails on 9.1.0 with
Blocked MCP connection to unsafe destination … Destination resolves to a private address in /var/log/morpheus/morpheus-ui/current, while the server still shows
OK. The switch is the undocumented, appliance-wide setting
morpheus.mcp.allowPrivateDestinations; setting it as a JVM system property
(-Dmorpheus.mcp.allowPrivateDestinations=true in
/opt/morpheus/lib/tomcat/bin/setenv.sh, then restart morpheus-ui) worked.
It opens private destinations for every MCP server on the appliance, so weigh
that before using it. Loopback stays blocked, so running this server on the
appliance itself does not work on 9.1.0.
Behaviour worth knowing
Caching and throttling. Responses are cached (15 minutes by default) and upstream requests are serialised with a minimum interval, so an agent that fans out does not turn into a burst of traffic against HPE's portal.
Errors are returned, not raised. Tools answer with
{"error": "...", "detail": "..."}so the model can read what went wrong and adjust, rather than seeing a transport failure.Truncation is explicit. Long documents come back with
truncated: trueand a[truncated]marker instead of silently losing the tail.This reads a vendor portal. It is polite by construction — cached, throttled, honestly identified in its
User-Agent— and reads only documents HPE serves publicly. Keep it that way if you extend it.
Tests
./.venv/bin/python -m unittest discover -s tests -t .Offline: the fixtures mimic the shape of HPE's payloads, not their content, so the suite needs no network and carries none of HPE's documentation. That is also why CI needs no secrets — GitHub Actions runs the same command on 3.10, 3.12 and 3.13 on every push and pull request.
tests/test_server.py covers what the appliance actually reads: that every tool
is annotated read-only, that each carries a description, and that the server
reports a version. A tool added without those would pass every other test and
fail only once it reached Morpheus.
Versioning
__version__ in hpe_kb_mcp/__init__.py is the single source — pyproject.toml
reads it, and the server reports it as serverInfo.version. Bump that one line
and everything follows. Deployments track this repository directly; there is no
build or publish step.
Available Tools
4 toolsget_hpe_documentA
Read the full text of an HPE Support Center document.
Use this for any support.hpe.com document - release notes, advisories,
customer notices, product documentation. Fetching a
support.hpe.com/hpesc/public/docDisplay?docId=... URL with a normal web
fetch returns an empty JavaScript shell with no document text; this tool
reads the API underneath it and returns the real content.
document accepts either a bare document id (dp00008463en_us) or any
URL containing one, so a link pasted from a browser works as-is.
Large documents are split into topics. Called without page, this returns
the topic list so you can pick one; call it again with that topic's page
value to read it, or pass include_all_topics=true to read the whole
document at once.
Inputs: document (required), page, max_chars, include_all_topics.
get_latest_morpheus_releaseA
Report the newest HPE Morpheus release this server knows about.
Compares the release-notes documents in the server's configured list and returns the highest version, with its publication month and document link.
Important: this reflects the documents the server has been told about, not
a live query of everything HPE has published - HPE has no anonymous search
API. If you have reason to think a newer release exists, find its release
notes with your own web search and read it with get_hpe_document; the
appliance's own build version comes from the Morpheus tools, not this one.
product is morpheus-enterprise or morpheus-vm-essentials.
Inputs: product.
list_hpe_document_topicsA
List the topics (table of contents) of an HPE document.
Cheaper than reading a whole document when you only need one section - "Fixes" or "New features" of a release notes document, for instance. Accepts a document id or a URL containing one.
Inputs: document (required).
search_hpe_kbA
Search the HPE Support Center knowledgebase by keyword.
Requires a signed-in HPE account: HPE serves documents anonymously but
gates search behind a login. If this returns authentication_required,
find the document with your own web search instead - HPE documents are
indexed publicly, and search results carry the docId=... you need - then
read it properly with get_hpe_document.
Inputs: query (required), max_results.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Most tools have clearly distinct jobs: searching, reading, listing topics, and checking latest release. The only real ambiguity is that `get_hpe_document` can also return a topic list when called without `page`, which overlaps with `list_hpe_document_topics`, but the descriptions clarify the intended use.
All tool names follow a predictable verb-first snake_case pattern: get, list, search. Minor inconsistencies exist, such as `search_hpe_kb` using the abbreviation `kb` and `get_latest_morpheus_release` shifting to a product-specific name, but the overall pattern is still easy to follow.
Four tools is a reasonable size for a focused knowledgebase reader. Each tool has a purpose, though `get_hpe_document` and `list_hpe_document_topics` are slightly redundant in one mode, and the Morpheus-specific release tool is narrower than the rest of the server.
The core document workflow is covered: search for documents, list topics, and read page content. Gaps are minor—there is no general browse-by-product tool, and search depends on a signed-in HPE account—but the server documents a workaround and offers a useful release-specific helper.
Related MCP Connectors
Read, edit and improve shared documents and knowledge with people and agents.
Ingest, manage, and retrieve documents for RAG-powered AI applications
Gives AI assistants read access to your Dedox help centre and knowledge base articles.
Document conversion and OCR for AI agents: PDF, Office docs, images to text.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search and fetch documentation content from Adobe Experience League, allowing natural language queries to retrieve Adobe product documentation and articles.ISC
- AlicenseAqualityBmaintenanceProvides AI assistants with direct access to Jamf official documentation, enabling them to answer Jamf-related questions by searching, retrieving articles, and browsing product documentation.6241 npm5MIT
- AlicenseAqualityBmaintenanceEnables searching and reading AVEVA Customer Support Portal knowledge base articles, including tech notes, known issues, and error-message diagnostics, to ground AI answers in support content not found in public documentation.3MIT
- FlicenseNot gradedqualityCmaintenanceEnables AI agents to query a governed knowledge base and receive cited answers, or explicitly decline when the record does not cover the question, preventing improvisation over gaps.-