ai.manpage/mcp

Tools

• get_man_page

  Read a manual. Required fields depend on the retrieval mode: 1. Name lookup: name. Example: {"name":"ls"}. Optional product pins a distro. Without OS/version filters, select the newest upstream version across active catalogs. Different packages or sections remain ambiguous; provenance identifies the chosen distro. 2. ID lookup: page_id copied from a previous result; omit name-based filters. 3. Continuation: cursor copied from get_man_page.next_cursor; omit name-based filters. A matching page_id may also be supplied. max_chars is optional in every mode. With product, os_version defaults to latest (null also means latest): the newest numbered release with readable documentation for the requested architecture/locale. Pass an explicit release such as 44 to pin it. Responses identify the actual OS release. A missing manual never falls back to an older OS. page_id and cursor retain their own release. Version accepts exact EVR (2:1.35-9.fc44), version-release (1.35-9.fc44), or upstream version (1.35). No operators or ranges: >=1.35 is invalid. RPM ~ and ^ characters are allowed in exact versions. Omit version for current documentation. An unavailable version never falls back; alternatives list only readable manuals. Ambiguity returns page_id choices. Alternatively pass only page_id from search, or only cursor to continue a long page. max_chars bounds each response; next_cursor=null means finished.

  shallow
• get_manual

  Get full manual text by name, e.g. manual_name="ls"; no package needed. manual_name is the command name (also matches aliases); package is an optional filter. Tries exact casing first, then a case-insensitive name/alias match. Search API selects latest indexed packages per scope, preferring Fedora when distribution is omitted, then newest Fedora RPM version across scopes. Explicit filters always apply; package_version can select historical manuals. Exact command names (sections 1/8) precede other names and aliases within the preferred distro. No locale fallback. Returns manual text with a distro/release and package/version header. Source-only manuals raise an error with extraction status.

  shallow
• get_targets

  List indexed distribution/release/repository/architecture scopes and counts. Use the returned values verbatim; targets such as CentOS 8, EPEL 9 or Fedora 43 are available only if they have been indexed.

  shallow
• give_feedback

  Report unexpected tool errors, missing capabilities, confusing output, or unclear docs. Only message is required. Describe your goal, what you tried, what you expected, and any workaround. Feedback is saved for the maintainers to review.

  shallow
• list_targets

  List OS releases with readable manuals. Required fields: none; call with {}. Use product and os_version from a result in get_man_page or search_man_pages. An empty list means no current documentation is available.

  shallow
• search

  Search manual text/metadata; return ranked hits, snippets and exact identities. Latest indexed package versions are used unless package_version is supplied. Omitted scope filters include all indexed distributions and releases. Supply query for relevance-ranked text search, or manual_name without query for name/alias lookup with Fedora-preferred recommendations and case-insensitive fallback. Pass next_cursor with identical arguments for the next live page; results can shift as indexing progresses. Filters are exact and case-sensitive.

  shallow
• search_man_pages

  Find manuals by topic, command prefix or literal option such as --recursive. Required field: query, including when continuing a search. All other fields are optional. Example: {"query":"compress files"}. Read a result with get_man_page(page_id=...). Returns context-preserving excerpts and page_id values for get_man_page. Aliases of the same document are grouped. Without product, an exact manual-name match selects the newest upstream version per package/name/section across active OS catalogs. Equal versions use deterministic distro ties; unrelated implementations stay separate. Topic/prefix searches use the newest numbered release per product for architecture/locale. Pass os_version=null to search all releases without collapsing distro variants. An explicit release pins OS selection. Current package builds are searched by default. Set historical=true to include readable older package versions within the selected OS releases, without automatic upstream-version selection. Responses name the actual OS targets searched. Repeat the query/filters with next_page to continue; null means finished or the configured page cap was reached.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/54e6264c-e842-4f78-a341-18d60996cc3b/badge.svg)](https://vouch.tools/servers/54e6264c-e842-4f78-a341-18d60996cc3b)