First-party app
Recurly

Recurly

Manage Recurly accounts, subscriptions, plans, invoices, transactions and coupons via the Recurly V3 API.

stable Commerce & PaymentsFinance & Accounting

About

Recurly ships in the w6w first-party pack. It declares 17 actions, 2 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.recurly
Version
0.1.0
Author
w6w
Licence
MIT
Categories
Commerce & Payments · Finance & Accounting

Overview

Recurly runs subscription billing and recurring-payment operations for a lot of SaaS and subscription-commerce businesses, and this app lets a workflow act directly on that billing data. Create and look up accounts, list and inspect subscriptions, and drive the subscription lifecycle — create and cancel.

On the money side, list invoices, pull up a specific one, and collect payment against a pending or past-due one. Browse the plan catalog to know what you’re billing for, pull the transaction log for a payment attempt, and look up coupons.

Authentication is HTTP Basic with a private API key as the username and an empty password. Every request must also declare the API version it targets — this app pins v2021-02-25, Recurly’s current GA version.

Build with Recurly

Three routes to the same 17 actions. The Workflow tab is generated from Recurly's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Cancel Subscription

cancel-subscription

Schedule a subscription to expire at the next bill date or at the end of its term.

Collect Invoice

collect-invoice

Attempt to collect payment for a pending or past-due, automatically-collected invoice.

Create Account

create-account

Create a new account. `code` is permanent once set.

Create Subscription

create-subscription

Create a subscription for an account, from a plan code.

Get Account

get-account

Fetch a single account by Recurly ID or by code (prefixed `code-`).

Get Coupon

get-coupon

Fetch a single coupon by Recurly ID or by code (prefixed `code-`).

Get Invoice

get-invoice

Fetch a single invoice by Recurly ID or by number (prefixed `number-`).

Get Plan

get-plan

Fetch a single plan by Recurly ID or by code (prefixed `code-`).

Get Subscription

get-subscription

Fetch a single subscription by Recurly ID or by UUID (prefixed `uuid-`).

Get Transaction

get-transaction

Fetch a single transaction by Recurly ID or by UUID (prefixed `uuid-`).

List Accounts

list-accounts

List a site's accounts, optionally filtered by email, subscriber or past-due status.

List Coupons

list-coupons

List a site's coupons.

List Invoices

list-invoices

List a site's invoices, optionally filtered by state or type.

List Plans

list-plans

List a site's plans.

List Subscriptions

list-subscriptions

List a site's subscriptions, optionally filtered by state.

List Transactions

list-transactions

List a site's payment-gateway transactions.

Update Account

update-account

Update an existing account's profile fields.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying Recurly's real ids.

{
  "manifestVersion": "2",
  "name": "recurly-example",
  "steps": [
    {
      "id": "collect-invoice",
      "uses": {
        "app": "io.w6w.recurly",
        "action": "collect-invoice",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "invoiceId": "<invoiceId>"
      }
    }
  ]
}

Here are some of the things you can do

  • Collect Invoice

    perform
    collect-invoice
  • Create Account

    perform
    create-account
  • Create Subscription

    perform
    create-subscription
  • Get Account

    read
    get-account
  • Get Coupon

    read
    get-coupon

+12 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for Recurly, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to Recurly. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "collect-invoice",
  payload: {
    invoiceId: "<value>",
    // billingInfoId: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action collect-invoice --payload '{"invoiceId":"<value>"}'

Give an AI agent Recurly — without giving it Recurly's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.recurly#collect-invoice",
    "input": {
      "invoiceId": "<invoiceId>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's Recurly connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

Recurly's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. Recurly itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

Recurly declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

Recurly platform status

Atlassian Statuspage rollup for status.recurly.com. Unauthenticated and unsigned.

quota

API rate-limit headroom