F5 AI Security Docs MCP Server
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., "@F5 AI Security Docs MCP Server search for scan configuration options"
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.
F5 AI Security Docs MCP Server
An MCP server that provides search and fetch tools over the entire F5 AI Security documentation site, modeled after the Strands Agents MCP server.
It exposes two tools to MCP-compatible AI assistants:
search_docs– TF-IDF, Markdown-aware ranked search across all docs pages.fetch_doc– Token-efficient reader: page catalog → table of contents → individual sections.
How it enumerates the whole site
docs.aisecurity.f5.com is a VitePress static site. VitePress publishes a
complete page manifest at /hashmap.json whose keys are the markdown source
paths for every rendered page. The server downloads that file once at startup and
derives a URL for each page:
api-docs_first-steps.md -> /api-docs/first-steps.html
release-notes_2026-06-17-saas.md -> /release-notes/2026-06-17-saas.html
operations_get_scans.md -> /operations/get_scans.html
index.md -> /index.html(First _ becomes the section separator; .md becomes .html.)
This captures all ~219 pages — system-overview/, get-started/,
application-docs/, api-docs/, api-reference/, the full REST operations/
reference, integrations/, red-team/, use-cases/, reference/, glossary,
and release-notes/ — with no fragile HTML crawling.
Related MCP server: FastMCP Documentation Search Server
Architecture
src/f5_aisec_mcp_server/
config.py # base_url, allowed host, hashmap path, timeouts
server.py # search_docs + fetch_doc MCP tools
utils/
page_source.py # download /hashmap.json -> [(title, url), ...]
cache.py # global index + lazy page hydration
doc_fetcher.py # HTTP fetch + VitePress HTML -> clean text
indexer.py # lightweight TF-IDF inverted index (stdlib only)
text_processor.py # titles, snippets, TOC/section parsingFlow: at startup the hashmap is parsed and the TF-IDF index is seeded with
page titles only (no content fetched → fast start). search_docs ranks by title,
then lazily fetches the top results to build content snippets. fetch_doc lets
the model browse a page's TOC and pull just the section it needs.
Install / Run
Requires Python 3.13+ (developed and tested on 3.13.14).
cd f5-aisec-mcp
python3.13 -m venv venv && source venv/bin/activate
pip install -e ".[dev]"
# Quick-test with the MCP Inspector
npx @modelcontextprotocol/inspector python -m f5_aisec_mcp_serverMCP client configuration
Point command at the venv's Python (absolute path) so the right interpreter
and installed mcp package are used:
{
"mcpServers": {
"f5-aisec": {
"command": "/Users/<<USER>>/path/to/project/f5-aisec-mcp/venv/bin/python",
"args": ["-m", "f5_aisec_mcp_server"],
"env": { "FASTMCP_LOG_LEVEL": "INFO" },
"disabled": false,
"autoApprove": ["search_docs", "fetch_doc"]
}
}
}Tests
pytest tests/Available Tools
2 toolsfetch_docA
Read F5 AI Security documentation pages with smart sectioning.
Modes:
Catalog mode (omit uri): returns all available document URLs+titles.
TOC mode (uri, no section): returns the page preamble plus a table of contents with section IDs, titles and summaries.
Section mode (uri + section): returns the full content of one section identified by its TOC ID (e.g. "3" or "3.2").
Small documents (under ~8KB) are returned in full regardless of mode.
Recommended workflow:
search_docs("your query") - find relevant URLs
fetch_doc(uri="...") - see structure, preamble and section summaries
fetch_doc(uri="...", section="3") - read the section you need
Args: uri: Document URL (must be under https://docs.aisecurity.f5.com/). If empty, returns a catalog of all available document URLs. section: Section ID from the TOC (e.g. "3" or "3.2"). Omit to get the table of contents.
Returns: Catalog / TOC / section payload, or an error dict on failure.
Inputs: uri, section. Returns: result
search_docsA
Search the F5 AI Security documentation and return ranked results.
Indexes the entire docs.aisecurity.f5.com site (system overview, getting started/installation, application & API docs, the full REST API reference, integrations, red-team campaigns, use cases, glossary, and release notes).
Use this to find relevant F5 AI Security documentation for any question about scanners, providers, projects, campaigns, the API, deployment, etc.
Args: query: Search query string (e.g. "create a custom scanner", "openai compatibility", "guardrails pii", "get scans endpoint"). k: Maximum number of results to return (default: 5).
Returns: List of dictionaries containing: - url: Document URL - title: Display title - score: Relevance score (higher is better) - snippet: Contextual content preview
Inputs: query (required), k. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: fetch_doc retrieves documentation content (catalog, TOC, or section), while search_docs finds relevant documents via search. There is no overlap.
Both tool names follow a consistent verb_noun pattern (fetch_doc, search_docs), using snake_case and parallel structure.
With only 2 tools, the server is on the low end of the acceptable range. While they cover search and retrieval, a typical documentation server might include additional tools like list_docs or get_doc_metadata.
The tools cover the full lifecycle for documentation consumption: search to find documents, fetch_doc to browse catalog, get TOC, and read sections. There are no obvious gaps for the stated purpose.
Related MCP Connectors
Search and query nTop's knowledge base and engineering guides from AI applications.
Tailor Platform for AI assistants: search, list and read the platform documentation.
Search and read Vector Panda docs: API operations, pricing, storage tiers, measured benchmarks.
Access and search Branch's official API documentation directly within any AI agent or client.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context.71MIT
- FlicenseBqualityDmaintenanceEnables intelligent search through FastMCP documentation using TF-IDF indexing, along with utility tools for arithmetic operations, text hashing, and web page content extraction via Jina Reader.4-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to fetch, index, and perform semantic RAG-based searches on API documentation from various sources. It provides tools for hybrid search and collection management, allowing users to access up-to-date documentation from projects like Gemini and FastMCP.-
- 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