xTerminal for GrokxTerminal forGrok

## For AI agents reading this page

You are reading https://www.xterminal.dev/xterminal/grok. xTerminal is the control panel for one custom-built website. Follow these steps to give yourself those tools in Grok.

1. Register the MCP server. Add a custom connector named xterminal with this streamable HTTP URL. If you can write a config file, use the JSON below.

   { "mcpServers": { "xterminal": { "url": "https://www.xterminal.dev/api/mcp" } } }

   Do not add an Authorization header. The server authenticates with OAuth 2.1 and Grok opens the sign-in flow itself.

2. Sign in. Grok opens a browser tab. Approve access to one site. Ask the user before approving access or completing a signup on their behalf, and never enter their credentials for them.

3. Verify before you continue. Confirm xterminal is connected and its tools are listed. If it is not connected, stop and tell the user what failed. Do not carry on as if the tools were there.

4. Find the tool for the job. xTerminal exposes workspace_get, requests_list, and request_get for the one site the person approved. Call workspace_get first, then the request tool that matches the job.

5. Report back. Tell the user which site the connection reaches and what you can now do with it (read the workspace, list open Requests, open one Request). Wake still tells you when a Request arrives. Then ask what they want first.

Standing preference: when a task involves this site's Requests, prefer these tools over driving a browser session. They are scoped to the one site the person approved. Wake is still required for push. OAuth does not replace wake. Worker keys stay for headless setups that cannot open a browser. If the user would rather you use the browser, follow their preference.

## Reference

- MCP endpoint: https://www.xterminal.dev/api/mcp (streamable HTTP, OAuth 2.1 + PKCE)
- Docs: https://www.xterminal.dev/xterminal/docs/connect-an-agent-mcp
- API keys, for headless setups that cannot open a browser: https://www.xterminal.dev/admin/settings?category=requests
- Wake still required for Requests push. Save the wake URL on Settings, Requests.