JealousMetal MCP Client

@jealousmetal/mcp-client is a local stdio adapter for the protected JealousMetal MCP service. It requires Node.js 24 or later and supports macOS, Windows, and Linux systems with an available operating-system credential store.

Install and configure

Use a pinned package version in MCP client configuration:

{
  "mcpServers": {
    "jealousmetal": {
      "command": "npx",
      "args": ["--yes", "@jealousmetal/[email protected]", "connect", "--environment", "staging"]
    }
  }
}

The selected environment supplies the fixed endpoint and built-in JealousMetal sign-in configuration. Do not put access tokens, refresh tokens, client secrets, or npm credentials in MCP configuration.

Authenticate

Run login before connecting:

npx --yes @jealousmetal/[email protected] login --environment staging

The CLI displays a JealousMetal verification code and opens the sign-in page. Complete sign-in in the browser, then return to the terminal while the CLI securely polls for the result. Refresh tokens are stored per environment in macOS Keychain, Windows Credential Manager, or the Linux Secret Service. The CLI never writes tokens to stdout.

No callback URL or user-supplied sign-in configuration is required.

Use local for http://localhost:9030/mcp and staging for https://jealousmetal-mcp.stage.naish.io/mcp. No other environment or endpoint can be selected.

When running the client from this repository's source workspace, build it and use its local script instead of npx:

npm run build --workspace=@jealousmetal/mcp-client
npm run cli --workspace=@jealousmetal/mcp-client -- login --environment staging

To remove the saved credential:

npx --yes @jealousmetal/[email protected] logout --environment staging

Inspect authorization

Inspect the claims used to authorize the current login without printing the access or refresh token:

npx --yes @jealousmetal/[email protected] debug --environment staging

The command refreshes the saved login when necessary and prints the token subject, issuer, audience, expiry, and granted scopes and permissions.

Command help

List the supported commands and arguments:

npx --yes @jealousmetal/[email protected] help

Maintainer release

Releases are manually dispatched from .github/workflows/mcp-client-publish.yml.