AgentMRR CLI

A tiny, dependency-free CLI for the AgentMRR API. Look up an agent's verified MRR, all-time revenue, leaderboard rank and verification status, discover top agents, grab badge snippets, and monitor your own listings — all as clean JSON, ideal for scripts, CI, dashboards, and AI agents.

It is a thin HTTP client: it talks only to https://agentmrr.com/api/v1 with your own API key. It never touches a database or any admin credential.

Quickstart

# Install the skill
npx skills add thijssmudde/agentmrr-cli

# Install the CLI
npm install -g agentmrr

# Set your API key
export AGENTMRR_API_KEY=amrr_your_key

# Top agents by MRR
amrr leaderboard:list

# Look up any agent's verified MRR
amrr agent:lookup acme

Get a free key in your AgentMRR dashboard — the free tier includes 100 calls/month; an active Growth subscription raises the limit. Requires Node.js ≥ 18. If global installs are unavailable, run any command through npx agentmrr ….

Every command needs a key and is metered against your monthly quota; remaining quota and your tier are printed to stderr (and returned as X-API-Quota-Remaining / X-API-Tier headers). Pass --key amrr_… instead of the env var on any command.

Commands

Commands follow a resource:action shape.

# Public discovery — works for ANY listed agent
amrr agent:lookup acme                 # MRR, all-time revenue, rank, verification
amrr discover:find --category "Developer Tools" --min-mrr 1000 --verified-only --limit 10
amrr leaderboard:list --limit 20       # the public MRR leaderboard
amrr badge:snippets acme               # badge / embed snippets
amrr categories:list                   # valid category values

# Your own agents (owner-scoped)
amrr agents:list                       # list your agents + metrics
amrr agents:get acme                   # one agent with rank + authority
amrr agents:export acme                # machine-readable export
amrr agents:monitor --daily            # watch all your agents for changes
amrr agents:monitor acme               # watch one agent
amrr agents:submit https://acme.com --name "Acme" --description "..." --category SaaS --logo https://acme.com/logo.png

The pre-0.2 verbs (lookup, find, leaderboard, agents, monitor, …) still work as hidden aliases, so existing scripts keep running.

What's public vs. private

• Public fields, any agent (agent:lookup, discover:find, leaderboard:list, badge:snippets): verified MRR, all-time revenue, subscribers, rank, momentum, category, verification status, badge links. Never owner identity or billing state.
• Owner-scoped (agents:*): only the agents you own (claimed in the dashboard).

Output

Everything is JSON on stdout with an ok boolean; quota and diagnostics go to stderr. Pipe into jq:

amrr agent:lookup acme | jq '.lookup.revenue'

Errors

• 401 missing/invalid key · 402 monthly quota exhausted (free tier = 100 calls/month) · 404 unknown agent (or not owned, for owner-scoped commands).

License

MIT