TrustMRR CLI

A zero-install command-line interface for browsing verified startup revenue data from TrustMRR.

Usage

Run it directly with npx:

npx trustmrr-cli top

The first time you run the CLI, it will ask for your TrustMRR API key and save it locally to:

~/.trustmrr-cli.json

You can also provide your API key through the TRUSTMRR_API_KEY environment variable.

To remove the saved key:

npx trustmrr-cli logout

Global Flags

These flags work across the list-style commands:

• --json — Output raw JSON instead of formatted tables
• --limit <n> — Override the default result count
• --country <cc> — Filter by 2-letter country code
• --min-mrr <n> — Minimum MRR filter in dollars
• --max-mrr <n> — Maximum MRR filter in dollars

Examples:

npx trustmrr-cli --json top 3
npx trustmrr-cli --country US top 10
npx trustmrr-cli --limit 25 search "customer support"
npx trustmrr-cli --min-mrr 1000 --max-mrr 5000 top

Commands

top [count]

Leaderboard sorted by monthly recurring revenue.

npx trustmrr-cli top
npx trustmrr-cli top 20
npx trustmrr-cli --country US top 10

search <query>

Searches startup names and descriptions.

npx trustmrr-cli search billing
npx trustmrr-cli --limit 25 search "customer support"

startup <slug>

Shows the full detail card for one startup.

npx trustmrr-cli startup stan

compare <slug1> <slug2>

Renders a side-by-side comparison table.

npx trustmrr-cli compare stan beehiiv

trending [count]

Sorts by 30-day growth percentage.

npx trustmrr-cli trending
npx trustmrr-cli trending 15

category <name> [count]

Filters by category and sorts by MRR.

npx trustmrr-cli category "Content Creation"
npx trustmrr-cli category Fintech 20

acquisitions [count]

Shows for-sale startups with financials and asking price.

npx trustmrr-cli acquisitions
npx trustmrr-cli acquisitions 12

countries

Lists countries represented in the dataset, including counts.

npx trustmrr-cli countries
npx trustmrr-cli countries --json

categories

Lists categories represented in the dataset, including counts.

npx trustmrr-cli categories
npx trustmrr-cli categories --json

Legacy Commands

These older commands are still available:

list

List startups from TrustMRR.

npx trustmrr-cli list
npx trustmrr-cli list --page 2 --limit 5
npx trustmrr-cli --json list

view <slug>

View detailed information for a specific startup.

npx trustmrr-cli view shipfast
npx trustmrr-cli view shipfast --raw

logout

Remove the saved TrustMRR API key.

npx trustmrr-cli logout

Agent / Automation Usage

Use --json when another tool, script, or agent needs structured output:

npx trustmrr-cli --json top 3
npx trustmrr-cli --json search "billing"
npx trustmrr-cli --json startup stan
npx trustmrr-cli --json compare stan beehiiv
npx trustmrr-cli --json countries
npx trustmrr-cli --json categories