Metorial CLI

Metorial ships two command line tools:

• metorial — consumer / agent CLI for discovering integrations and calling MCP tools
• metorial-admin — generated admin CLI for Magnetar API resources, raw requests, and examples

Both are agent-first: they are meant to be used by developers and by agents.

Install

npm

npm install -g @metorial/cli
npm install -g @metorial/admin

npx

npx @metorial/cli@latest
npx @metorial/admin@latest

Bash installer

curl -fsSL https://cli.metorial.com/install.sh | bash

Homebrew

brew install metorial/tap/metorial
brew install metorial/tap/metorial-admin

Scoop

scoop bucket add metorial https://github.com/metorial/scoop-bucket
scoop install metorial
scoop install metorial-admin

Start from an example

npm create metorial@latest
npm create metorial@latest <identifier> [path]

create-metorial delegates to metorial-admin example.

Consumer CLI (metorial)

Sign in, then work with integrations and MCP tools:

metorial login
metorial integrations list
metorial integrations catalog list
metorial integrations tools <integration-id>
metorial integrations call <integration-id> <tool> -d '{"query":"..."}'
metorial open

Resource administration, fetch/curl, and example moved to metorial-admin.

Admin CLI (metorial-admin)

metorial-admin login
metorial-admin providers list
metorial-admin providers deployments list
metorial-admin sessions list
metorial-admin magic-mcp servers list
metorial-admin integrations setup
metorial-admin outposts credentials create <outpost-id> --name laptop
metorial-admin fetch /providers
metorial-admin example list

Admin commands are generated from the Magnetar API. To regenerate them (requires a running API):

make generate

The generator reads manifest/admin.yaml and writes internal/generated/admin/catalog.go.

Help

metorial --help
metorial-admin --help
metorial <command> --help
metorial-admin <command> --help

Learn More

• Metorial docs
• Providers
• Server deployments
• Sessions
• Projects and organizations

For a shorter install-first guide, see cli.metorial.com/cli.md in this repository or visit cli.metorial.com.