Glean
Arcade MCP server exposing Glean Client API search over custom OAuth2.
0.2.0Glean Toolkit
The Glean toolkit connects Arcade to the Glean Client API, enabling search over an enterprise Glean index with results permission-filtered to the authenticated user.
Capabilities
- Enterprise search: Query the user's Glean index and retrieve ranked, permission-filtered results via
Glean.Search. - Offset pagination: Page through results using
offsetandlimit;has_next_pagesignals more results are available, up to ~2,000 results (≈20 pages × 100 items) — deeper offsets raise an error rather than return misleading empty pages. - Budget-aware result trimming: When items are large, the result list is trimmed to a size budget;
truncatedflags this condition andhas_next_pageremainstrueso callers can page forward or narrow the query. - Fail-loud guarantees: If the fetch budget is exhausted before the requested window is filled, the tool raises an error rather than silently returning a partial page.
OAuth
This toolkit uses OAuth 2.0 for user-level authentication. The provider is configured as custom OAuth2 against Glean's authorization server. See the Arcade auth provider reference for setup details — note that no standard Arcade provider slug is available; consult your Glean administrator for the OAuth application credentials and authorization endpoint.
Secrets
GLEAN_API_URL— The base URL for your organization's Glean API endpoint (e.g.,https://<your-instance>.glean.com/api). Glean deployments are tenant-specific, so this value differs per organization. Obtain it from your Glean administrator or from the Glean admin console under Setup → API. This is not a credential but a required URL override so the toolkit routes requests to the correct tenant instance.
See the Arcade secrets docs for how to store and reference secrets: https://docs.arcade.dev/en/guides/create-tools/tool-basics/create-tool-secrets. You can manage secrets at https://api.arcade.dev/dashboard/auth/secrets.
Available tools(1)
| Tool name | Description | Secrets | |
|---|---|---|---|
Search the user's Glean enterprise index and return ranked results.
Results are permission-filtered to the authorized user. Use 'offset' with
'limit' to page; 'has_next_page' indicates more results remain. Offset
paging is supported up to roughly 2000 results (20 pages x 100 items);
deeper offsets raise an error rather than return a misleading empty page.
When the fetch budget is exhausted before the requested window is filled,
the tool raises rather than return a partial page (fail loud over mislead).
The result list is trimmed to a size budget when items are large;
'truncated' flags it and 'has_next_page' stays true so the caller can page
or narrow the query. | 1 |
Selected tools
No tools selected.
Click "Show all tools" to add tools.
Requirements
Select tools to see requirements
Glean.Search
Execution hints
Signals for MCP clients and agents about how this tool behaves.
Reads data without modifying any state in the target system.
May permanently delete or overwrite data in the target system.
Repeated calls with the same inputs produce no additional effect.
Communicates with external APIs, databases, or other services.
Search the user's Glean enterprise index and return ranked results. Results are permission-filtered to the authorized user. Use 'offset' with 'limit' to page; 'has_next_page' indicates more results remain. Offset paging is supported up to roughly 2000 results (20 pages x 100 items); deeper offsets raise an error rather than return a misleading empty page. When the fetch budget is exhausted before the requested window is filled, the tool raises rather than return a partial page (fail loud over mislead). The result list is trimmed to a size budget when items are large; 'truncated' flags it and 'has_next_page' stays true so the caller can page or narrow the query.
Parameters
| Parameter | Type | Req. | Description |
|---|---|---|---|
query | string | Required | Natural-language search query to run against the user's Glean index. |
limit | integer | Optional | Maximum number of results to return (1-100). Defaults to 10. |
offset | integer | Optional | 0-indexed position of the first result to return. Defaults to 0 (first result). |
Requirements
Output
json— Ranked Glean results plus pagination metadata. 'has_next_page' is true when more results are available (page with a larger 'offset'); 'truncated' is true when the result list was trimmed to fit a response-size budget.