Skip to main content
Glama
PocketShell MCP

PocketShell MCP

Official

MCP hub

Retired 2026-10-26 (archived, read-only). This MCP hub (mcp.dtcdev.click/mcp) is no longer deployed. DataOps tools now live in the dedicated DataOps MCP in the dataops repo (mcp/, tools dataops_read/dataops_write/dataops_guide), deployed by the DataOps pipeline: https://frzdkakcapcyf6ywflhieyimgu0vtclr.lambda-url.eu-west-1.on.aws/mcp (the McpUrl output of the dataops-v1 stack; DataOps bearer auth). Dapier and AISL namespaces were removed; the PocketShell MCP tools are not needed. Last commit with all four namespaces: ca2eca6. Intake F10 (78b95a1b).

One generic MCP server for every registered CLI, at one public HTTPS /mcp endpoint. Assistant computers need no saved CLI login, SSH key or host pins. A persistent service holds that state and connects through the existing PocketShell gateway front door.

The server uses standard Streamable HTTP and MCP OAuth: discovery, dynamic client registration, authorization code with S256 PKCE, audience binding, short access tokens and rotating refresh tokens. It has no ChatGPT-specific transport or token exchange. The same endpoint can be connected by ChatGPT/dots, Claude, Grok Bot, Cursor, Codex and other OAuth-capable MCP clients.

Status: deployed to its public endpoint; protocol tests and Inspector HTTPS tests pass (including a multiplexed-gateway Inspector run for DataOps tools). Live discovery, DCR, consent page and real device-start flows are verified for PocketShell and DataOps. (Dapier and AISL namespaces were removed on 2026-10-26, intake F10.) Actual ChatGPT/dots, Claude and Grok Bot account tests remain required: the first browser approval and CLI linking need the operator. Protocol compatibility is not a claim that those account tests have passed.

Tools

One gateway serves every registered CLI. Instead of one MCP tool per subcommand (roughly 100 definitions), it exposes catalog plus one short tool per CLI, for example pocketshell and dataops. Each CLI tool takes CLI-like argv (an array, never a shell string):

Call

Result

argv: [] or ["help"]

The CLI's description, its command groups and top-level commands

["help", "tasks"]

Only the next level below tasks

["help", "tasks", "create"]

That command's JSON schema, scope and read/write classification

["tasks", "list", "--mine"]

Runs a reviewed, allowlisted command

["connect"]

A single-use browser link that connects this CLI's account

Every command comes from a reviewed manifest with a closed argument schema, its own OAuth scope and a read, write or destructive classification. Writes return approvalRequired until the call repeats with approved: true. Read-only connections never receive write scopes.

PocketShell operations invoke the same psc runtime used by the terminal client. Account/device/gateway functions come from @pocketshell/tui-client/core. The public entry point lives in the upstream client package; it re-exports the existing implementations. The lower-level host contract remains in @pocketshell/core. The build pins both upstream source revisions. Generated bundles stay outside Git because upstream defaults can contain deployment details.

Other CLIs run their own executables in a fresh, sandboxed per-call worker that receives only that user's credential for that CLI. Each CLI has a pluggable auth type. For device-flow CLIs, the gateway logs in as its own device, labelled with the assistant's name. For token CLIs, the user pastes the token once on the gateway's HTTPS page. Credentials never pass through chat.

Related MCP server: OpenXNet MCP Server

Development

Requires Node 24, npm, Git and OpenSSL for the HTTPS tests. SSH operations also require OpenSSH.

npm ci
node scripts/build-client.mjs
node scripts/build-dataops.mjs
npm test

The build downloads pinned public client/core sources into a temporary directory, compiles the shared code, and removes the sources. To use an existing checkout, pass its path as the first argument.

Configure the gateway using the variables in configuration, then run npm start. Infrastructure belongs in the infrastructure repository; this repository does not create AWS resources.

See connection steps for ChatGPT/dots, Claude, Grok Bot, Cursor, Codex and Inspector. Security and limits describes credential storage, host trust and operating limits.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Exposes a Windows or Linux host terminal to remote MCP clients via Streamable HTTP, enabling command execution, tunnel management, and privileged operations with security features like OAuth and audit logging.
    16 npm
    3
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables MCP clients to securely access authorized computers and VPSs for scoped file operations, Git operations, and administrator-defined quality gates through an outbound-polling gateway.
    2
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables an agent to search approved MCP integrations and expose only the tools a given task needs, signing the user in once via browser-based OAuth and enforcing scopes, effects and budgets in code. It also acts as a single gateway connection so existing hosts can reach many servers with per-tenant isolation and audit events.
    MIT