Python client + MCP server adapter for Glean (search, chat, read documents). Provides a reusable HTTP client plus simple sync helper functions.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"glean-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Glean MCP Server & Python Package Simple, focused implementation providing: - Cookie-based client (`glean_mcp.cookie_client.GleanClient`) — uses browser session cookies - Token-based client (`glean_mcp.token_client.TokenBasedGleanClient`) — uses API tokens for server-to-server auth - MCP server (`python -m glean_mcp.server`) — auto-detects authentication method; ready for Docker Links: [Releases](https://github.com/alankyshum/glean-mcp-server/releases) · [Cookie Guide](docs/COOKIES.md) · [Token Auth Guide](docs/TOKEN_BASED_AUTH.md) ## Install ```bash pip install -U glean-mcp ``` ## Package Layout ``` src/ └── glean_mcp/ ├── cookie_client.py # Cookie-based authentication client ├── token_client.py # Token-based authentication client ├── server.py # MCP server with auto-detection └── glean_filter.py # Response filtering utilities ``` ## Quick Start ### MCP Server (local or Docker) The MCP server automatically detects your authentication method. ```bash # Choose ONE (token preferred) export GLEAN_API_TOKEN="your-api-token" # preferred # OR export GLEAN_COOKIES="your-browser-cookies" # Set your Glean instance export GLEAN_BASE_URL="https://your-company-be.glean.com" # or set GLEAN_INSTANCE=your-company # Run the MCP server locally python -m glean_mcp.server ``` Docker (example): ```bash docker run --pull always --rm \ -e GLEAN_API_TOKEN="$GLEAN_API_TOKEN" \ -e GLEAN_BASE_URL="$GLEAN_BASE_URL" \ ghcr.io/alankyshum/glean-mcp-server:latest ``` Upgrade: use `--pull always` (Docker) or `pip install -U glean-mcp` (pip). ### Library Usage (async) Cookie-based: ```python from glean_mcp import GleanClient client = GleanClient(base_url, cookies) results = await client.search("onboarding docs") await client.close() ``` Token-based: ```python from glean_mcp import TokenBasedGleanClient client = TokenBasedGleanClient(base_url, api_token) results = await client.search("onboarding docs") await client.close() ``` …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.