{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_wa6wxr5avvn3","handle":"glean-mcp","url":"https://wellknown.network/agents/glean-mcp","links":{"self":"https://wellknown.network/agents/glean-mcp/record.json","html":"https://wellknown.network/agents/glean-mcp","markdown":"https://wellknown.network/agents/glean-mcp/record.md","api":"https://wellknown.network/api/v1/agents/glean-mcp","status":"https://wellknown.network/api/v1/agents/glean-mcp/status","claim":"https://wellknown.network/agents/glean-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/glean-mcp/claim.json","badge":"https://wellknown.network/agents/glean-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:glean-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"glean-mcp","summary":"Python client + MCP server adapter for Glean (search, chat, read documents). Provides a reusable HTTP client plus simple sync helper functions.","description":"# Glean MCP Server & Python Package\n\nSimple, focused implementation providing:\n\n- Cookie-based client (`glean_mcp.cookie_client.GleanClient`) — uses browser session cookies\n- Token-based client (`glean_mcp.token_client.TokenBasedGleanClient`) — uses API tokens for server-to-server auth\n- MCP server (`python -m glean_mcp.server`) — auto-detects authentication method; ready for Docker\n\nLinks: [Releases](https://github.com/alankyshum/glean-mcp-server/releases) · [Cookie Guide](docs/COOKIES.md) · [Token Auth Guide](docs/TOKEN_BASED_AUTH.md)\n\n## Install\n```bash\npip install -U glean-mcp\n```\n\n## Package Layout\n```\nsrc/\n└── glean_mcp/\n    ├── cookie_client.py      # Cookie-based authentication client\n    ├── token_client.py       # Token-based authentication client\n    ├── server.py             # MCP server with auto-detection\n    └── glean_filter.py       # Response filtering utilities\n```\n\n## Quick Start\n\n### MCP Server (local or Docker)\nThe MCP server automatically detects your authentication method.\n\n```bash\n# Choose ONE (token preferred)\nexport GLEAN_API_TOKEN=\"your-api-token\"   # preferred\n# OR\nexport GLEAN_COOKIES=\"your-browser-cookies\"\n\n# Set your Glean instance\nexport GLEAN_BASE_URL=\"https://your-company-be.glean.com\"  # or set GLEAN_INSTANCE=your-company\n\n# Run the MCP server locally\npython -m glean_mcp.server\n```\n\nDocker (example):\n```bash\ndocker run --pull always --rm \\\n  -e GLEAN_API_TOKEN=\"$GLEAN_API_TOKEN\" \\\n  -e GLEAN_BASE_URL=\"$GLEAN_BASE_URL\" \\\n  ghcr.io/alankyshum/glean-mcp-server:latest\n```\nUpgrade: use `--pull always` (Docker) or `pip install -U glean-mcp` (pip).\n\n### Library Usage (async)\n\nCookie-based:\n```python\nfrom glean_mcp import GleanClient\n\nclient = GleanClient(base_url, cookies)\nresults = await client.search(\"onboarding docs\")\nawait client.close()\n```\n\nToken-based:\n```python\nfrom glean_mcp import TokenBasedGleanClient\n\nclient = TokenBasedGleanClient(base_url, api_token)\nresults = await client.search(\"onboarding docs\")\nawait client.close()\n```\n…","publisher":{"name":"Alan Shum","url":null},"homepage":"https://github.com/alankyshum/glean-mcp-server#readme","repository":"https://github.com/alankyshum/glean-mcp-server/releases","version":"3.3.0","license":null,"protocols":["mcp"],"tags":["glean","mcp","model-context-protocol","search"],"pricing":null,"endpoints":[{"url":"pypi:glean-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"security.identity","name":"Identity & Access","confidence":0.825,"provenance":"derived"}],"categories":["security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"glean-mcp","registry":"pypi","observedAt":"2026-09-09T16:25:30.163Z","publishedAt":"2025-08-16T05:20:59.471342Z","latestVersion":"3.3.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"glean-mcp","url":"https://pypi.org/project/glean-mcp/","firstSeenAt":"2026-09-09T16:24:03.672Z","fetchedAt":"2026-09-09T16:24:03.672Z","normalizedAt":"2026-09-09T16:24:03.672Z"}]},"firstSeenAt":"2026-09-09T16:24:03.672Z","updatedAt":"2026-09-09T16:25:30.163Z"}