MoonClerk MCP by usefulapi

List the MoonClerk payment forms: id, title, currency, payment_volume (cents), successful_checkout_count and created/updated times. Use the form ids to filter customers (plans) and payments. Read-only. GET /forms.

{
  "type": "object",
  "properties": {
    "count": {
      "description": "Rows to return, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "description": "Start position (default 0). Pass the previous reply's next_offset to get the next page.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One payment form by id: title, currency, payment volume and checkout count. Read-only. GET /forms/{id}.

{
  "type": "object",
  "properties": {
    "form_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "MoonClerk form id (from moonclerk_list_forms)."
    }
  },
  "required": [
    "form_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List MoonClerk customers, which the MoonClerk web app calls "Plans": each is one payer with their subscription (status, plan amount and interval, next payment date, trial and cancel dates), payment method (brand, last 4), coupon discount, custom form fields and the form they used. Filter by form, status (active, canceled, expired, past_due, pending, unpaid), sign-up date range or next-payment date range, e.g. past_due plans or renewals due this month. The payer's management link and checkout token are never returned. Read-only. GET /customers.

{
  "type": "object",
  "properties": {
    "form_id": {
      "description": "Only customers who signed up through this form.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "status": {
      "description": "Subscription status.",
      "type": "string",
      "enum": [
        "active",
        "canceled",
        "expired",
        "past_due",
        "pending",
        "unpaid"
      ]
    },
    "checkout_from": {
      "description": "Customers created on or after this date.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "checkout_to": {
      "description": "Customers created on or before this date.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "next_payment_from": {
      "description": "Subscriptions due to bill on or after this date.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "next_payment_to": {
      "description": "Subscriptions due to bill on or before this date.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "count": {
      "description": "Rows to return, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "description": "Start position (default 0). Pass the previous reply's next_offset to get the next page.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One MoonClerk customer (plan) by id with the full subscription, payment method, discount, checkout amounts (subtotal, fee, total, upfront amount, trial days) and custom field answers. The payer's management link and checkout token are never returned. Read-only. GET /customers/{id}.

{
  "type": "object",
  "properties": {
    "customer_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "MoonClerk customer id (from moonclerk_list_customers)."
    }
  },
  "required": [
    "customer_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List MoonClerk payments (charges): date, status (successful, refunded, failed), amount, Stripe fee and amount refunded in cents, currency, payer name and email, payment method, form, customer id (recurring payments only), coupon and custom fields. Filter by form, customer, status or charge-date range, e.g. failed payments this month or refunds for one plan. Amounts are in cents. Read-only. GET /payments.

{
  "type": "object",
  "properties": {
    "form_id": {
      "description": "Only payments made through this form.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "customer_id": {
      "description": "Only payments of this customer (plan).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "status": {
      "description": "Payment status.",
      "type": "string",
      "enum": [
        "successful",
        "refunded",
        "failed"
      ]
    },
    "date_from": {
      "description": "Payments charged on or after this date.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "date_to": {
      "description": "Payments charged on or before this date.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "count": {
      "description": "Rows to return, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "description": "Start position (default 0). Pass the previous reply's next_offset to get the next page.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One MoonClerk payment by id with amounts (cents), Stripe fee, refunds, payer, payment method, Stripe references (charge, customer, invoice), coupon, custom fields and one-time checkout data. The checkout token is never returned. Read-only. GET /payments/{id}.

{
  "type": "object",
  "properties": {
    "payment_id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "MoonClerk payment id (from moonclerk_list_payments)."
    }
  },
  "required": [
    "payment_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}