Skip to main content
Glama
GET-Technology-Inc

Jamf Docs MCP Server

Get Documentation Table of Contents

jamf_docs_get_toc
Read-onlyIdempotent

Retrieve the table of contents for any Jamf product or publication to explore available documentation topics before searching or fetching specific articles.

Instructions

Get the table of contents for Jamf documentation.

Browse the navigation structure of either a Jamf product or any single Jamf publication - release notes, technical papers, courses, evaluation guides and configuration guides all live on the publication axis rather than the product one. Exactly one of product and publication is required.

Args:

  • product (string): Product ID - one of: jamf-pro, jamf-school, jamf-connect, jamf-protect, jamf-now, jamf-safe-internet, jamf-insights, jamf-rapididentity, jamf-trust, jamf-routines, self-service-plus, jamf-app-catalog, jamf-account, jamf-security-cloud, elevate, composer, jamf-parent, jamf-teacher, jamf-setup-reset, jamf-assessment, title-editor, jamf-infrastructure-manager, jamf-adcs-connector, jamf-pki-proxy, jamf-migrate, jamf-remote-assist, jamf-cloud-distribution-service, healthcare-listener

  • publication (string): Bundle family id of any single publication, e.g. "technical-paper-laps" or "jamf-pro-release-notes". Call jamf_docs_list_products for the available ids

  • version (string, optional): Specific version (e.g., "11.13.0") or "current" (defaults to latest), at most 50 characters

  • language (string, optional): Documentation language/locale (default: en-US). A product or publication Jamf does not publish in it is served as its en-US edition, and localeNote says so

  • page (number, optional): Page number for pagination 1-100 (default: 1)

  • maxTokens (number, optional): Maximum tokens in response 100-50000 (default: 5000)

  • outputMode ('full' | 'compact'): Output detail level (default: 'full'). Use 'compact' for flat list without nested children

  • responseFormat ('markdown' | 'json'): Output format (default: 'markdown')

Returns: For JSON format: { "product": string, "version": string, "mapId": string, // absent for a concepts.jamf.com or support.jamf.com TOC, // and when a TOC provider names no map "toc": [...], // each entry: title, url, and contentId when from a map "tokenInfo": { "tokenCount": number, "truncated": boolean, "maxTokens": number }, "pagination": { "page": number, "pageSize": number, "totalPages": number, "totalItems": number, "hasNext": boolean, "hasPrev": boolean }, "truncatedEntry"?: { // only on a page cut to fit; see the Note "title": string, "shownEntries": number, "totalEntries": number, "estimatedTokens": number } }

For Markdown format: A hierarchical list of documentation topics with pagination and token info.

Examples:

  • Browse Jamf Pro documentation: product="jamf-pro"

  • Get page 2 of TOC: product="jamf-pro", page=2

  • Limit response size: product="jamf-pro", maxTokens=2000

Errors:

  • "Invalid option: expected one of ..." (an input validation error) if product is not a known product ID

  • 'Version "" not found', followed by the available versions, if that version is not published

Note: Use this to discover what topics are available before searching or retrieving specific articles. Large TOCs are paginated by top-level entry: a page holds up to 10 of them, each with everything under it, as many as fit maxTokens, and the next page starts at the first that did not fit. Every top-level entry is on exactly one page, but which page depends on maxTokens, so keep maxTokens the same while paging; the markdown footer names it beside the next page when it is not the default. A top-level entry larger than maxTokens on its own is alone on its page, cut to the entries under it that fit; only that page has tokenInfo.truncated, and truncatedEntry.estimatedTokens is what the whole entry costs. If maxTokens makes more pages than page accepts (100), page 100 offers no next page and paginationNote names a maxTokens that reaches the rest. The response-level mapId and an entry's contentId together form the pair jamf_docs_get_article accepts for a direct fetch. Full markdown shows the mapId only, and compact markdown shows neither; use responseFormat="json" (or read structuredContent) for both. A concepts.jamf.com or support.jamf.com TOC has neither: it names no map, and its entries carry only title, url and children. Read any of its entries by url with jamf_docs_get_article; a support.jamf.com subcollection's url is its collection page, which reads as the list of its articles. structuredContent also carries what to send back for the next page: productId (or publicationId), version, language (when one was asked for) and maxTokens. The JSON text has no id or language, and has the budget as tokenInfo.maxTokens. structuredContent.entries is the TOC flattened in document order and always carries every descendant; each entry's depth (0 for top level) is what restores the nesting. The markdown is not the same view: outputMode="full" shows that nesting as indentation, while outputMode="compact" lists only the top-level entries and shows no nesting at all.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
pageNoPage number for pagination (1-100, default: 1)
productNoProduct ID: jamf-pro, jamf-school, jamf-connect, jamf-protect, jamf-now, jamf-safe-internet, jamf-insights, jamf-rapididentity, jamf-trust, jamf-routines, self-service-plus, jamf-app-catalog, jamf-account, jamf-security-cloud, elevate, composer, jamf-parent, jamf-teacher, jamf-setup-reset, jamf-assessment, title-editor, jamf-infrastructure-manager, jamf-adcs-connector, jamf-pki-proxy, jamf-migrate, jamf-remote-assist, jamf-cloud-distribution-service, healthcare-listener
versionNoSpecific version (e.g. "11.13.0"), at most 50 characters; defaults to latest
languageNoDocumentation language/locale (default: en-US). Options: en-US, ja-JP, zh-TW, de-DE, es-ES, fr-FR, nl-NL, th-TH, it-IT, pt-BR, zh-CN
maxTokensNoMaximum tokens in response (100-50000, default: 5000)
outputModeNoOutput detail level: "full" for detailed output or "compact" for brief outputfull
publicationNoBundle family id for any Jamf publication, e.g. "technical-paper-laps" or "jamf-pro-release-notes". Use this for the documents that are not one of the products in `product` — release notes, technical papers, courses, evaluation and configuration guides. Exactly one of `product` or `publication` is required. Call jamf_docs_list_products to see the available ids.
responseFormatNoOutput format: "markdown" for human-readable or "json" for machine-readablemarkdown

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
pageYes
mapIdNo
entriesYes
hasMoreYes
productYes
versionYes
languageNo
maxTokensYes
productIdNo
localeNoteNo
totalPagesYes
versionNoteNo
totalEntriesYes
publicationIdNo
paginationNoteNo
truncatedEntryNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv6.0.14
    • changedInput schema / properties / version / description
      Previous value: -"Specific version (e.g. \"11.13.0\"); defaults to latest"New value: +"Specific version (e.g. \"11.13.0\"), at most 50 characters; defaults to latest"
    • addedInput schema / properties / version / maxLength
      Added value: +50
  2. Changed4 schema fields changedv6.0.12
    • addedOutput schema / properties / language
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / maxTokens
      Added value: +{
      +  "exclusiveMinimum": 0,
      +  "maximum": 9007199254740991,
      +  "type": "integer"
      +}
    • addedOutput schema / properties / truncatedEntry
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "estimatedTokens": {
      +      "type": "number"
      +    },
      +    "shownEntries": {
      +      "type": "number"
      +    },
      +    "title": {
      +      "type": "string"
      +    },
      +    "totalEntries": {
      +      "type": "number"
      +    }
      +  },
      +  "required": [
      +    "title",
      +    "shownEntries",
      +    "totalEntries",
      +    "estimatedTokens"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "product",
      -  "version",
      -  "totalEntries",
      -  "page",
      -  "totalPages",
      -  "hasMore",
      -  "entries"
      -]New value: +[
      +  "product",
      +  "version",
      +  "totalEntries",
      +  "page",
      +  "totalPages",
      +  "hasMore",
      +  "maxTokens",
      +  "entries"
      +]
  3. Changed11 schema fields changedv5.10.1
    • changedInput schema / properties / language / description
      Previous value: -"Documentation language/locale (default: en-US). Options: en-US, ja-JP, zh-TW, de-DE, es-ES, fr-FR, nl-NL, th-TH"New value: +"Documentation language/locale (default: en-US). Options: en-US, ja-JP, zh-TW, de-DE, es-ES, fr-FR, nl-NL, th-TH, it-IT, pt-BR, zh-CN"
    • changedInput schema / properties / language / enum
      Previous value: -[
      -  "en-US",
      -  "ja-JP",
      -  "zh-TW",
      -  "de-DE",
      -  "es-ES",
      -  "fr-FR",
      -  "nl-NL",
      -  "th-TH"
      -]New value: +[
      +  "en-US",
      +  "ja-JP",
      +  "zh-TW",
      +  "de-DE",
      +  "es-ES",
      +  "fr-FR",
      +  "nl-NL",
      +  "th-TH",
      +  "it-IT",
      +  "pt-BR",
      +  "zh-CN"
      +]
    • changedInput schema / properties / product / description
      Previous value: -"Product ID: jamf-pro, jamf-school, jamf-connect, jamf-protect, jamf-now, jamf-safe-internet, jamf-insights, jamf-rapididentity, jamf-trust, jamf-routines, self-service-plus, jamf-app-catalog"New value: +"Product ID: jamf-pro, jamf-school, jamf-connect, jamf-protect, jamf-now, jamf-safe-internet, jamf-insights, jamf-rapididentity, jamf-trust, jamf-routines, self-service-plus, jamf-app-catalog, jamf-account, jamf-security-cloud, elevate, composer, jamf-parent, jamf-teacher, jamf-setup-reset, jamf-assessment, title-editor, jamf-infrastructure-manager, jamf-adcs-connector, jamf-pki-proxy, jamf-migrate, jamf-remote-assist, jamf-cloud-distribution-service, healthcare-listener"
    • changedInput schema / properties / product / enum
      Previous value: -[
      -  "jamf-pro",
      -  "jamf-school",
      -  "jamf-connect",
      -  "jamf-protect",
      -  "jamf-now",
      -  "jamf-safe-internet",
      -  "jamf-insights",
      -  "jamf-rapididentity",
      -  "jamf-trust",
      -  "jamf-routines",
      -  "self-service-plus",
      -  "jamf-app-catalog"
      -]New value: +[
      +  "jamf-pro",
      +  "jamf-school",
      +  "jamf-connect",
      +  "jamf-protect",
      +  "jamf-now",
      +  "jamf-safe-internet",
      +  "jamf-insights",
      +  "jamf-rapididentity",
      +  "jamf-trust",
      +  "jamf-routines",
      +  "self-service-plus",
      +  "jamf-app-catalog",
      +  "jamf-account",
      +  "jamf-security-cloud",
      +  "elevate",
      +  "composer",
      +  "jamf-parent",
      +  "jamf-teacher",
      +  "jamf-setup-reset",
      +  "jamf-assessment",
      +  "title-editor",
      +  "jamf-infrastructure-manager",
      +  "jamf-adcs-connector",
      +  "jamf-pki-proxy",
      +  "jamf-migrate",
      +  "jamf-remote-assist",
      +  "jamf-cloud-distribution-service",
      +  "healthcare-listener"
      +]
    • addedInput schema / properties / publication
      Added value: +{
      +  "description": "Bundle family id for any Jamf publication, e.g. \"technical-paper-laps\" or \"jamf-pro-release-notes\". Use this for the documents that are not one of the products in `product` — release notes, technical papers, courses, evaluation and configuration guides. Exactly one of `product` or `publication` is required. Call jamf_docs_list_products to see the available ids.",
      +  "maxLength": 200,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • changedInput schema / properties / version / description
      Previous value: -"Specific version (defaults to latest)"New value: +"Specific version (e.g. \"11.13.0\"); defaults to latest"
    • addedInput schema / properties / version / pattern
      Added value: +"^(?:current|\\d+(?:\\.\\d+)*)$"
    • removedInput schema / required
      Removed value: -[
      -  "product"
      -]
    • addedOutput schema / properties / localeNote
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / publicationId
      Added value: +{
      +  "type": "string"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "product",
      -  "productId",
      -  "version",
      -  "totalEntries",
      -  "page",
      -  "totalPages",
      -  "hasMore",
      -  "entries"
      -]New value: +[
      +  "product",
      +  "version",
      +  "totalEntries",
      +  "page",
      +  "totalPages",
      +  "hasMore",
      +  "entries"
      +]
  4. Changed2 schema fields changedv4.3.1
    • addedOutput schema / properties / entries / items / properties / depth
      Added value: +{
      +  "maximum": 9007199254740991,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • changedOutput schema / properties / entries / items / required
      Previous value: -[
      -  "title",
      -  "url"
      -]New value: +[
      +  "title",
      +  "url",
      +  "depth"
      +]
  5. Changed8 schema fields changedv4.0.6
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • changedInput schema / properties / product / description
      Previous value: -"Product ID: jamf-pro, jamf-school, jamf-connect, jamf-protect"New value: +"Product ID: jamf-pro, jamf-school, jamf-connect, jamf-protect, jamf-now, jamf-safe-internet, jamf-insights, jamf-rapididentity, jamf-trust, jamf-routines, self-service-plus, jamf-app-catalog"
    • changedOutput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • addedOutput schema / properties / mapId
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / paginationNote
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / productId
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / versionNote
      Added value: +{
      +  "type": "string"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "product",
      -  "version",
      -  "totalEntries",
      -  "page",
      -  "totalPages",
      -  "hasMore",
      -  "entries"
      -]New value: +[
      +  "product",
      +  "productId",
      +  "version",
      +  "totalEntries",
      +  "page",
      +  "totalPages",
      +  "hasMore",
      +  "entries"
      +]
  6. Addedv3.0.34
  7. Removedv3.0.30
  8. First observedv3.0.25

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, open-world), but the description goes well beyond them: pagination is by top-level entry with maxTokens affecting page boundaries, truncation is signalled via tokenInfo.truncated and truncatedEntry, concepts/support TOCs lack mapId/contentId, and language fallback to en-US surfaces as localeNote. These are non-obvious operational behaviors an agent needs.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Structure is sound (Args/Returns/Examples/Errors/Note), but the Args section reproduces the schema's parameter descriptions and full enum lists verbatim, adding no value, and the trailing Note is an undifferentiated wall of prose mixing pagination mechanics, id and format rules. It is over-sized for what must be conveyed.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Even though an output schema exists and return values needn't be explained, the definition covers errors, examples, pagination edge cases and follow-up tool wiring. Nothing needed to invoke this 8-parameter tool correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3, and the description does repeat the enum lists nearly verbatim. However it adds genuine meaning the schema lacks: the product-vs-publication mutual exclusivity and their semantic split, the language fallback behavior, and that outputMode='compact' yields only top-level entries with no nesting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Get the table of contents'), then immediately scopes it to two axes (product vs publication) and clarifies that release notes, technical papers and guides live on the publication axis. It also contrasts itself with siblings by saying this is for discovery 'before searching or retrieving specific articles,' so an agent can distinguish it from jamf_docs_search and jamf_docs_get_article.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit routing guidance: call jamf_docs_list_products for available publication ids, use jamf_docs_get_article with the mapId/contentId pair for a direct fetch, and use this tool to discover topics before searching. The when-to-use condition is stated outright rather than inferred.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.