jstm mcp

Browsing the catalog

jstm mcp list
jstm mcp list --category productivity --limit 50
jstm mcp search github
jstm mcp show 3f21b8c0-91ad-4f6e-89b2-77c0a4e1d9f3
jstm mcp stats

Command	Options
`list`	`--category`, `-c`; `--limit`, `-l` (20); `--json`
`search <query>`	`--json`
`show <server-id>`	`--json`
`stats`	`--json`

Registering your own server

`mcp add-endpoint`

Register an MCP server you host or subscribe to. The server derives a qualified name of the form endpoint/<workspace_id>/<slug-of-name>.

jstm mcp add-endpoint ledger-tools \
  --transport streamable-http \
  --url https://tools.acme.internal/mcp \
  --scope workspace

For a stdio server:

jstm mcp add-endpoint local-indexer \
  --transport stdio \
  --command /usr/local/bin/indexer \
  --args --port --args 9001 \
  --env INDEX_ROOT=/data \
  --scope personal

Option	Description
`NAME` or `--name`	Server name. The qualified name is derived from it
`--transport`	`streamable-http`, `sse`, or `stdio`. Required unless `--update`
`--scope`	`personal`, `workspace`, or `org`. Required unless `--update`
`--url`	Endpoint URL, for the HTTP transports
`--command`	Executable to run, for `stdio`
`--args`	A command argument. Repeatable, `stdio` only
`--env`	An environment variable as `KEY=VALUE`. Repeatable, `stdio` only
`--connector`	Auth provider for an authenticated server
`--auth-scheme`	How a key is applied: `bearer`, `header`, or `query`
`--auth-name`	Header or query parameter name, for `header` and `query` schemes
`--update`	Re-validate and re-introspect an existing endpoint in place
`--json`	Emit as JSON

Registering succeeds even if the server can’t be reached yet — it registers with an empty tool list, and introspection fills it in once it can authenticate. Registering a duplicate name without --update is rejected.

`mcp connect-key`

Attach a bring-your-own API key to a registered endpoint, then introspect it automatically.

jstm mcp connect-key endpoint/acme-corp-finance/ledger-tools --api-key <key>
jstm mcp connect-key endpoint/acme-corp-finance/ledger-tools \
  --api-key <key> --auth-scheme header --auth-name X-API-Key

Option	Description
`--api-key`	Required. The key or secret
`--auth-scheme`	`bearer`, `header`, or `query`
`--auth-name`	Header or query parameter name
`--json`	Emit as JSON

This is an idempotent upsert — running it again replaces the key.

`mcp introspect`

Re-list a registered server’s tools.

jstm mcp introspect endpoint/acme-corp-finance/ledger-tools

Run this after the server’s tool set changes, or after fixing a credential.

`mcp disconnect-key`

Remove the stored key from an endpoint server.

jstm mcp disconnect-key endpoint/acme-corp-finance/ledger-tools

Idempotent — reports removed=false when there was nothing to remove.

`mcp remove-endpoint`

Delete an endpoint server.

jstm mcp remove-endpoint endpoint/acme-corp-finance/ledger-tools

All four of these commands accept the qualified name or the server’s UUID.

Repositories

Sync a GitHub repository of MCP servers into the catalog.

`mcp repo add`

jstm mcp repo add https://github.com/acme-corp/internal-mcp-servers --scope personal

jstm mcp repo add https://github.com/acme-corp/internal-mcp-servers \
  --scope selected --workspace acme-corp/finance --workspace acme-corp/revops

Option	Description
`--scope`	Required. `all`, `selected`, or `personal`
`--workspace`	Workspace ids for `--scope selected`. Repeatable
`--name`, `-n`	Display name. Defaults to the URL’s last path segment
`--no-sync`	Register without importing. For scripted flows
`--json`	Emit as JSON

Adding auto-imports the repository’s servers unless you pass --no-sync. Only GitHub URLs are accepted. Private repositories work using your own connected GitHub credential — see Importing private GitHub repositories.

The rest of the repo commands

jstm mcp repo list
jstm mcp repo list --scope personal
jstm mcp repo sync 3f21b8c0-91ad-4f6e-89b2-77c0a4e1d9f3
jstm mcp repo scope 3f21b8c0-91ad-4f6e-89b2-77c0a4e1d9f3 --scope all
jstm mcp repo remove 3f21b8c0-91ad-4f6e-89b2-77c0a4e1d9f3

repo scope takes the same --scope and repeatable --workspace options as repo add.

When a sync needs a credential

A private repository sync with no usable GitHub credential returns a typed error:

{
  "error": "credential_required",
  "provider": "github",
  "required_scope": "repo",
  "connect_url": "/settings/connections"
}

With --json this prints as pure JSON on stdout so a script can branch on it. See Credential problems.

Using the CLI

Commands

Browsing the catalog

Registering your own server

`mcp add-endpoint`

`mcp connect-key`

`mcp introspect`

`mcp disconnect-key`

`mcp remove-endpoint`

Repositories

`mcp repo add`

The rest of the repo commands

When a sync needs a credential

See also

​Browsing the catalog

​Registering your own server

​mcp add-endpoint

​mcp connect-key

​mcp introspect

​mcp disconnect-key

​mcp remove-endpoint

​Repositories

​mcp repo add

​The rest of the repo commands

​When a sync needs a credential

​See also

Browsing the catalog

Registering your own server

`mcp add-endpoint`

`mcp connect-key`

`mcp introspect`

`mcp disconnect-key`

`mcp remove-endpoint`

Repositories

`mcp repo add`

The rest of the repo commands

When a sync needs a credential

See also