AppDirect + AI in 60 seconds
Unofficial. Community-built Claude Code Skill and MCP server for the AppDirect API. Not affiliated with, endorsed by, or sponsored by AppDirect, Inc.
Awaiting live verification - passes every mechanical gate (build, command-surface, claims, install). Be the first to confirm it against your tenant: report it works.
Ask ‘which AppDirect payments failed this week?’ or ‘reconcile billing before month-close’ and get an answer across every reseller company in one call. The skill syncs your whole AppDirect marketplace - subscriptions, invoices, payments, companies, pipeline - into a local mirror, so cross-company billing questions that take hundreds of console clicks return instantly, offline, from your terminal or your AI agent.
New to the term? An MCP server is the same thing ChatGPT calls an app or connector, Claude on the web calls a connector, and Claude Code calls a Skill. One thing, many names →
Install in 60s → View on GitHub →
Instead of clicking through AppDirect, just ask
Instead of Open the AppDirect console and filter each company’s billing screen one by one, copying failed payments into a spreadsheet for the weekly chase.
just ask: “Which AppDirect payments failed in the last 7 days, across every company?”
Your agent runs: appdirect-cli payments unpaid --since 7d --json
Instead of Export subscriptions and invoices separately, then VLOOKUP to find active subscriptions that were never invoiced before month-close.
just ask: “Reconcile AppDirect billing for the last 30 days - what’s active but unbilled, overdue, or failed?”
Your agent runs: appdirect-cli reconcile --since 30d --agent
Instead of Click through four console screens - users, subscriptions, invoices, opportunities - to brief one customer before a renewal call.
just ask: *“Show me everything on AppDirect company appdirect-cli company show
See it in 30 seconds
Demo data is simulated. Every command shown exists in the real CLI.
What it does
| Question your MSP keeps asking | Command your agent runs |
|---|---|
| Which payments failed or stalled in the last week, across every company? | appdirect-cli payments unpaid --since 7d --json |
| What’s active-but-unbilled, overdue, or failed before month-close? | appdirect-cli reconcile --since 30d --agent |
| What changed in subscriptions this week - new, ended, or suspended? | appdirect-cli subs changed --since 7d --json |
| Show one customer’s full picture - users, subscriptions, invoices, opportunities. | appdirect-cli company show <companyId> |
| What does my assisted-sales pipeline look like by status? | appdirect-cli pipeline --group-by status --agent |
| Which open opportunities have gone stale? | appdirect-cli pipeline stale --days 14 --json |
| Find any company, subscription, invoice, or opportunity by keyword. | appdirect-cli search "<text>" |
| Pull the whole marketplace into a local mirror for offline analysis. | appdirect-cli sync |
Full command reference at github.com/servosity/msp-skills/blob/main/skills/appdirect/guide.md.
What makes this one different
Most AppDirect integrations proxy each question into a live REST call and re-mint an hourly OAuth token every time - fine for one record, but it falls over the moment you ask something that spans every company. This skill syncs the marketplace into a local SQLite mirror, so cross-entity questions become one offline join: reconcile, subs changed, and pipeline answer in a single call what a stateless wrapper would need hundreds of paginated requests to attempt.
The AppDirect console shows one company, one screen at a time, with no cross-company billing-reconciliation view. This skill complements the portal by answering the aggregate, before-month-close questions the UI can’t - from your terminal or your AI agent.
The pain this closes
- Active subscriptions slip through un-invoiced and failed payments sit unnoticed for weeks, leaking margin every month-close - and the console has no cross-company view to catch them.
- Briefing one customer means clicking through users, subscriptions, invoices, and open opportunities on separate screens; multiply that by hundreds of companies and the monthly reconciliation never gets done.
- Every API call re-mints an hourly OAuth token and answers for one record at a time, so aggregate questions across the whole marketplace are effectively impossible from the portal.
Install
Works in any of these agents - pick yours:
| Agent | Quick install |
|---|---|
| Claude Desktop | Step-by-step → |
| ChatGPT (Plus/Pro+) | Step-by-step → |
| Claude Code | Step-by-step → |
| Codex CLI | Step-by-step → |
| Cursor, Windsurf, Cline, Continue, Zed, Copilot, Gemini, Hermes, OpenClaw | Which agent? → |
Quickest path for everyone else (terminal):
macOS / Linux:
bash <(curl -fsSL https://raw.githubusercontent.com/servosity/msp-skills/main/skills/appdirect/install.sh)
Windows (PowerShell):
iwr -useb https://raw.githubusercontent.com/servosity/msp-skills/main/skills/appdirect/install.ps1 | iex
After install, authenticate once with your AppDirect credentials, then verify with appdirect-cli --version.
Safety model
| Tier | Examples | Recommended agent policy |
|---|---|---|
| Read | payments unpaid, reconcile, subs changed, company show, pipeline, search, and every GET (companies, users, subscriptions, invoices, opportunities) | Allow |
| Write (routine) | create/update companies, users, memberships, groups, and opportunities; invite users; request a purchase; finalize or clone an opportunity; apply a discount | Preview with –dry-run, then a reviewed write |
| Credential / financial | set a temporary password; create, update, or set a default payment method or payment instrument | Human-in-the-loop only |
| Destructive | delete a company membership, user group, subscription assignment, or shopping cart; cancel a subscription or add-on; expire a developer account | Human-in-the-loop only |
The skill reads marketplace data - companies, users, subscriptions, invoices, payments, and the assisted-sales pipeline - and those reads are always safe. It can also write: create and update companies, users, memberships, and opportunities; touch money-moving operations like purchases and payment instruments; and delete or expire records. Keep an autonomous agent to reads plus previewed (–dry-run) writes, and require a human for payment/credential and destructive (delete, cancel, expire) operations. Full details in governance.md.
Frequently asked questions
Does this work with ChatGPT?
Yes, on paid ChatGPT plans. ChatGPT connects to remote MCP servers over HTTPS, so you expose the local AppDirect MCP server via a secure bridge. Step-by-step in the install guide.
Do I need to know how to code?
No. Paste one sentence into Claude Code or Codex and your agent does the install, or run a one-line installer. You enter your credentials once.
Is my AppDirect data safe?
Your data stays on your machine. The CLI, MCP server, and the local mirror are all local. The AI sees query results, not raw bulk data, and credentials are never bundled or transmitted by MSP Skills.
What does it cost?
Free. Apache-2.0 licensed. You pay only for whichever AI agent you already use.
Do I need to be an AppDirect partner?
Yes. The skill authenticates with partner API credentials (OAuth2 client_credentials) for a marketplace you operate or resell on - it is not for end-user purchases on a marketplace you don’t control. Point it at your own marketplace with APPDIRECT_BASE_URL if you run a white-label domain.
Will this hit AppDirect’s API rate limits?
It is built to avoid them. The marketplace REST API uses leaky-bucket rate limits (for example, 20-request buckets that refill a few per second); because this skill syncs to a local mirror and answers most questions offline, your day-to-day queries make almost no live calls. Sync itself respects the limits and you can cap request rate with –rate-limit.
Status
Beta. Validated against the AppDirect API surface and being validated with MSPs running it live against their own production tenants in our weekly Build Sessions.
Standards. Conforms to the open Agent Skills spec (Anthropic, Dec 2025; 40+ agents). MCP-compatible - works with any MCP-capable agent including Hermes. OpenClaw-ready (frontmatter pre-wired, awaiting OpenClaw launch).
Maintained by Servosity for the MSP community. Apache-2.0 licensed. Built with CLI Printing Press.