A read-only CLI tool to retrieve data from the Mantle platform, including metrics, customers, and subscriptions.

Install

mkdir -p .claude/skills/mcli && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/12052" && unzip -o skill.zip -d .claude/skills/mcli && rm skill.zip

Installs to .claude/skills/mcli

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Query the Mantle Core API using the mcli CLI tool. Use this skill when the user asks to look up, query, list, get, or investigate data from the Mantle platform — customers, subscriptions, metrics (MRR, ARR, churn, etc.), apps, plans, deals, contacts, usage events, charges, transactions, affiliates, tickets, meetings, email campaigns, email deliveries, or any other Mantle resource. Triggers on: "look up customer", "check MRR", "find subscription", "get metrics", "query usage events", "list deals", "search entities", "list email campaigns", "check email deliveries", or any request to read data from the Core API. This skill is READ-ONLY — never use mcli to create, update, or delete data.
693 chars✓ has a “when” triggerlonger than Claude Code's old 250-char listing cap (fine on current versions)
Beginner

Key capabilities

  • Query customer data from Mantle Core API
  • Retrieve MRR/ARR metrics
  • List usage events
  • Search across contacts and customers
  • List email campaigns and deliveries

How it works

The skill executes `mcli` commands with specified subcommands and filters, always using the `--json` flag to retrieve data from the Mantle Core API.

Inputs & outputs

You give it
MCLI subcommands with optional filters and `--json` flag
You get back
JSON formatted data from the Mantle Core API

When to use mcli

  • Look up customer data
  • Check current MRR or ARR
  • Query usage events
  • List email campaigns

About this skill

mcli — Mantle Core API CLI

Query Mantle data via the mcli command. This skill covers read-only operations only.

Key Rules

  • Read-only: Only use list, get, search, timeline, and metrics subcommands. Never use create, update, delete, add-*, remove-*, or any mutating command.
  • Always use --json when you need to parse or analyze the output programmatically.
  • Pagination: Most list commands default to 25 items. Use --take to get more (up to 100) and --cursor or --page for pagination.
  • The CLI is pre-authenticated. Run mcli whoami if you need to confirm the current profile.

Quick Patterns

Look up a customer

mcli customers list --search "acme" --json
mcli customers get <id> --json
mcli customers get <id> --includes subscriptions --json
mcli customers timeline <id> --json

Check metrics

mcli metrics mrr --date-range last_30_days --json
mcli metrics arr --app-id <id> --json
mcli metrics revenue-churn --date-range this_month --json
mcli metrics sales --json

Find subscriptions

mcli subscriptions list --customer-id <id> --json
mcli subscriptions get <id> --json

Search across contacts and customers

mcli entities search --search "[email protected]" --json

View app events / usage

mcli apps list-events --app-id <id> --take 50 --json
mcli usage-events list --customer-id <id> --event-name "page_view" --json
mcli metrics usage-event --app-id <id> --event-name "api_call" --date-range last_7_days --json

Deals and pipeline

mcli deals list --status open --json
mcli deals get <id> --json
mcli deals timeline <id> --json

Charges and transactions

mcli charges list --customer-id <id> --json
mcli transactions list --customer-id <id> --app-id <id> --json

Full Command Reference

See references/commands.md for the complete list of read-only commands and their options.

Tips

  • Use mcli <resource> help <subcommand> to see all options for any command.
  • Pipe --json output to jq for filtering: mcli customers list --json | jq '.customers[] | .name'
  • Date ranges accept presets (last_30_days, this_year, etc.) or custom ISO 8601 dates via --start-date / --end-date.
  • When investigating a customer, start with entities search to find them, then drill into customers get, subscriptions list, charges list, etc.

Email campaigns and deliveries

mcli email-campaigns list --status active --json
mcli email-campaigns get <id> --json
mcli email-campaigns preview <id> --customer-id <cust_id> --json
mcli email-deliveries list --email-id <campaign_id> --json
mcli email-deliveries get <id> --json
mcli email-layouts list --json
mcli email-senders list --json

When not to use it

  • To create, update, or delete data in the Mantle platform

Limitations

  • Only supports read-only operations (`list`, `get`, `search`, `timeline`, `metrics`)
  • Most list commands default to 25 items, requiring `--take` for more
  • The CLI is pre-authenticated, no explicit authentication steps are handled

How it compares

This skill provides read-only access to Mantle Core API resources through a command-line interface, allowing structured queries and JSON output, which is more programmatic than manual data retrieval.

Compared to similar skills

mcli side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
mcli (this skill)04moReviewBeginner
mirra-voice04moReviewIntermediate
korean-public-data-api59moNo flagsIntermediate
segment-cdp26moNo flagsIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry