docs-mcp

Search the published Tandem docs index for relevant pages.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The Tandem question, task, or keyword query to search for."
    },
    "docs_ref": {
      "type": "string",
      "description": "Docs channel or immutable ref. Defaults to stable. Use next, refs/<sha>, or releases/<version> only when explicitly needed."
    },
    "engine_version": {
      "type": "string",
      "description": "Optional Tandem engine version hint. If supplied without docs_ref, the MCP still defaults to stable unless a matching versioned docs ref is configured."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Maximum number of matching docs pages to return."
    },
    "audience": {
      "type": "string",
      "description": "Optional audience filter such as developer, desktop user, or operator."
    }
  },
  "required": [
    "query"
  ]
}

Fetch and normalize a published Tandem docs page by path or URL.

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Docs path like /sdk/python/ or a full Tandem docs URL."
    },
    "docs_ref": {
      "type": "string",
      "description": "Docs channel or immutable ref. Defaults to stable."
    },
    "engine_version": {
      "type": "string",
      "description": "Optional Tandem engine version hint for compatibility checks."
    }
  },
  "required": [
    "path"
  ]
}

Recommend the best Tandem docs starting path for a desktop user, server admin, or developer.

{
  "type": "object",
  "properties": {
    "role": {
      "type": "string",
      "enum": [
        "desktop",
        "server_admin",
        "developer"
      ],
      "description": "The user role to optimize the docs starting point for."
    },
    "docs_ref": {
      "type": "string",
      "description": "Docs channel or immutable ref. Defaults to stable."
    }
  },
  "required": [
    "role"
  ]
}

Recommend the next Tandem docs to read after a current page, optionally biased toward a goal.

{
  "type": "object",
  "properties": {
    "current_path": {
      "type": "string",
      "description": "Current Tandem docs path the user has already read."
    },
    "docs_ref": {
      "type": "string",
      "description": "Docs channel or immutable ref. Defaults to stable."
    },
    "goal": {
      "type": "string",
      "description": "Optional goal such as install Tandem, use the Python SDK, or build workflows."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Maximum number of next-doc recommendations to return."
    }
  },
  "required": [
    "current_path"
  ]
}

Answer how to install or use Tandem, build workflows, or use the SDKs by synthesizing relevant published docs.

{
  "type": "object",
  "properties": {
    "task": {
      "type": "string",
      "description": "The Tandem task or question that needs a docs-grounded answer."
    },
    "docs_ref": {
      "type": "string",
      "description": "Docs channel or immutable ref. Defaults to stable."
    },
    "engine_version": {
      "type": "string",
      "description": "Optional Tandem engine version hint. Prefer stable docs for installed engines."
    },
    "audience": {
      "type": "string",
      "description": "Optional audience hint such as developer, desktop user, or operator."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Maximum number of supporting docs recommendations to include."
    }
  },
  "required": [
    "task"
  ]
}

Return a structured Tandem learning guide for install-engine, python-sdk, typescript-sdk, build-workflows, or headless-deploy.

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "enum": [
        "install-engine",
        "python-sdk",
        "typescript-sdk",
        "build-workflows",
        "headless-deploy"
      ],
      "description": "Named Tandem learning guide to return."
    },
    "docs_ref": {
      "type": "string",
      "description": "Docs channel or immutable ref. Defaults to stable."
    }
  },
  "required": [
    "topic"
  ]
}

Refresh the docs index and preload the most important Tandem docs pages into cache.

{
  "type": "object",
  "properties": {
    "force_refresh": {
      "type": "boolean",
      "description": "Whether to bypass cache and force fresh upstream fetches first."
    },
    "docs_ref": {
      "type": "string",
      "description": "Docs channel or immutable ref. Defaults to stable."
    }
  }
}

Inspect the current docs cache state for index sources and warmed pages.

{
  "type": "object",
  "properties": {}
}

Force-refresh docs indexes and report whether data came from the network, cache, or stale fallback.

{
  "type": "object",
  "properties": {
    "force_refresh": {
      "type": "boolean",
      "description": "Whether to bypass cache and force a network refresh attempt."
    },
    "docs_ref": {
      "type": "string",
      "description": "Docs channel or immutable ref. Defaults to stable."
    }
  }
}

Force-refresh a docs page and report whether content came from the network, cache, or stale fallback.

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Docs path like /start-here/ or /sdk/python/ to refresh."
    },
    "docs_ref": {
      "type": "string",
      "description": "Docs channel or immutable ref. Defaults to stable."
    },
    "force_refresh": {
      "type": "boolean",
      "description": "Whether to bypass cache and force a network refresh attempt."
    }
  },
  "required": [
    "path"
  ]
}

Invalidate docs cache entries for index data, all pages, or a specific page path.

{
  "type": "object",
  "properties": {
    "target": {
      "type": "string",
      "enum": [
        "all",
        "index",
        "pages",
        "page"
      ],
      "description": "Which cache area to invalidate."
    },
    "path": {
      "type": "string",
      "description": "Required when target is page; identifies the specific docs path to invalidate."
    },
    "docs_ref": {
      "type": "string",
      "description": "Optional docs ref to scope page/index cache invalidation."
    }
  }
}

Force-refresh the docs indexes and return before/after hashes so content changes can be proven.

{
  "type": "object",
  "properties": {
    "docs_ref": {
      "type": "string",
      "description": "Docs channel or immutable ref. Defaults to stable."
    }
  }
}

Force-refresh a docs page and return before/after hashes so page content changes can be proven.

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Docs path like /start-here/ or /sdk/python/ to compare before and after refresh."
    },
    "docs_ref": {
      "type": "string",
      "description": "Docs channel or immutable ref. Defaults to stable."
    }
  },
  "required": [
    "path"
  ]
}