flowglad · agreea · Oct 18, 2025 · Jun 27, 2025 · Jun 27, 2025 · Jun 28, 2025
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -17,13 +17,14 @@ jobs:
     timeout-minutes: 10
     name: lint
     runs-on: ${{ github.repository == 'stainless-sdks/flowglad-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
       - uses: actions/checkout@v4
 
       - name: Set up Node
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '22'
 
       - name: Bootstrap
         run: ./scripts/bootstrap
@@ -35,6 +36,7 @@ jobs:
     timeout-minutes: 5
     name: build
     runs-on: ${{ github.repository == 'stainless-sdks/flowglad-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     permissions:
       contents: read
       id-token: write
@@ -44,7 +46,7 @@ jobs:
       - name: Set up Node
         uses: actions/setup-node@v4
         with:
-          node-version: '20'
+          node-version: '22'
 
       - name: Bootstrap
         run: ./scripts/bootstrap
@@ -66,10 +68,20 @@ jobs:
           AUTH: ${{ steps.github-oidc.outputs.github_token }}
           SHA: ${{ github.sha }}
         run: ./scripts/utils/upload-artifact.sh
+
+      - name: Upload MCP Server tarball
+        if: github.repository == 'stainless-sdks/flowglad-typescript'
+        env:
+          URL: https://pkg.stainless.com/s?subpackage=mcp-server
+          AUTH: ${{ steps.github-oidc.outputs.github_token }}
+          SHA: ${{ github.sha }}
+          BASE_PATH: packages/mcp-server
+        run: ./scripts/utils/upload-artifact.sh
   test:
     timeout-minutes: 10
     name: test
     runs-on: ${{ github.repository == 'stainless-sdks/flowglad-typescript' && 'depot-ubuntu-24.04' || 'ubuntu-latest' }}
+    if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
       - uses: actions/checkout@v4
 

diff --git a/.github/workflows/publish-npm.yml b/.github/workflows/publish-npm.yml
@@ -16,6 +16,8 @@ jobs:
   publish:
     name: publish
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
 
     steps:
       - uses: actions/checkout@v4
@@ -39,3 +41,10 @@ jobs:
           yarn tsn scripts/publish-packages.ts "{ \"paths_released\": \"$PATHS_RELEASED\" }"
         env:
           NPM_TOKEN: ${{ secrets.FLOWGLAD_NPM_TOKEN || secrets.NPM_TOKEN }}
+
+      - name: Upload MCP Server DXT GitHub release asset
+        run: |
+          gh release upload ${{ github.event.release.tag_name }} \
+            packages/mcp-server/flowglad_node_api.mcpb
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.gitignore b/.gitignore
@@ -7,4 +7,6 @@ dist
 dist-deno
 /*.tgz
 .idea/
-
+.eslintcache
+dist-bundle
+*.mcpb
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.21.0"
+  ".": "0.22.0"
 }
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
-configured_endpoints: 46
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/flowglad%2Fflowglad-0cf7bce0c17d6f5a651950ab9f46224548af6b420a8a18883ae357c834ab6148.yml
-openapi_spec_hash: 4d78e958c164eaa79116965799ff10c7
-config_hash: 5cd4df36fa4da9901706710955ea260e
+configured_endpoints: 45
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/flowglad%2Fflowglad-a1eeb4fac4d6f2e5a1bed0a6ef5abfc4172e8d989c24343860b8a07a389ea65b.yml
+openapi_spec_hash: 1bd6007e37eeb62e1dc85da4f939ed1d
+config_hash: b3cf56eeb5f18b49019b9be6e30263c0
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,4 +1,67 @@
 # Changelog
+## 0.22.0 (2025-10-18)
+
+Full Changelog: [v0.21.0...v0.22.0](https://github.com/flowglad/flowglad-node/compare/v0.21.0...v0.22.0)
+
+### Features
+
+* **api:** pre-launch SDK release ([dcfff9e](https://github.com/flowglad/flowglad-node/commit/dcfff9e3bfa07cfbbbe10e47e8889bb6fc920eda))
+* clean up environment call outs ([6dd40c6](https://github.com/flowglad/flowglad-node/commit/6dd40c6a4371b69cd1a5b81a46290fb534e64960))
+* **mcp:** add code execution tool ([b6cd343](https://github.com/flowglad/flowglad-node/commit/b6cd3435bd2b5ed81dff1c6998deb378815bec1c))
+* **mcp:** add logging when environment variable is set ([1a342dd](https://github.com/flowglad/flowglad-node/commit/1a342dd3ee2ad5216f48fd9000094d13b06a823b))
+* **mcp:** add option to infer mcp client ([79eb017](https://github.com/flowglad/flowglad-node/commit/79eb0176c1f772f9dafcc4cbc30f780f9333efa4))
+* **mcp:** add unix socket option for remote MCP ([d9046c9](https://github.com/flowglad/flowglad-node/commit/d9046c9f0ff82694a1da1785b283873f9f67a415))
+* **mcp:** parse query string as mcp client options in mcp server ([4595852](https://github.com/flowglad/flowglad-node/commit/45958528bbef675814b9d3fa71c647722c1801f9))
+* **mcp:** remote server with passthru auth ([3790db5](https://github.com/flowglad/flowglad-node/commit/3790db5b8572ae511b04a16e5c019da11511b7fa))
+* **mcp:** support filtering tool results by a jq expression ([b6fb8e2](https://github.com/flowglad/flowglad-node/commit/b6fb8e222bd687786c96a0b023b22f371a4bbf7d))
+
+
+### Bug Fixes
+
+* **ci:** release-doctor — report correct token name ([51f10bf](https://github.com/flowglad/flowglad-node/commit/51f10bf06bf5c8700293510678a512dc23ea9b57))
+* **client:** get fetchOptions type more reliably ([f992b90](https://github.com/flowglad/flowglad-node/commit/f992b90421e4693bc00d956a736c70691b494bfb))
+* **mcp:** avoid sending `jq_filter` to base API ([47e138e](https://github.com/flowglad/flowglad-node/commit/47e138e835bc86287ad681923bd9d37554ffaf29))
+* **mcp:** fix bug in header handling ([b02cec9](https://github.com/flowglad/flowglad-node/commit/b02cec933dfea867bc0fd7cff8d1752c1deeddd3))
+* **mcp:** fix tool description of jq_filter ([a3c1124](https://github.com/flowglad/flowglad-node/commit/a3c112419f677e9864bd7c2e3b20eb6dc0739cd0))
+* **mcp:** generate additionalProperties=true for map schemas to avoid validation issues ([7a8aefb](https://github.com/flowglad/flowglad-node/commit/7a8aefbbac9baa8e9c9bbfa19cf4731e8066df7e))
+* **mcp:** include required section for top-level properties and support naming transformations ([d954143](https://github.com/flowglad/flowglad-node/commit/d9541434fddbcf1be078671a1047dfc81f3327bd))
+* **mcp:** relax input type for asTextContextResult ([4eb359e](https://github.com/flowglad/flowglad-node/commit/4eb359e33f8de5825640fb86203956c4496ab8de))
+* **mcp:** reverse validJson capability option and limit scope ([0114889](https://github.com/flowglad/flowglad-node/commit/01148896da612b853195710bf33ebdf2ef2339f7))
+* **mcp:** support jq filtering on cloudflare workers ([1cb62d7](https://github.com/flowglad/flowglad-node/commit/1cb62d721ed4c9b10745fe940590c7e0f518f34a))
+
+
+### Chores
+
+* add docs to RequestOptions type ([5673bd9](https://github.com/flowglad/flowglad-node/commit/5673bd9adaf5d53b6b740bf972236ad50c2a0300))
+* add package to package.json ([4e57a8f](https://github.com/flowglad/flowglad-node/commit/4e57a8f2250113400fa243aff2577eda22258b29))
+* **ci:** only run for pushes and fork pull requests ([7133a67](https://github.com/flowglad/flowglad-node/commit/7133a67258382c3a4f657185410be9b51c18f68f))
+* **client:** improve path param validation ([40bf088](https://github.com/flowglad/flowglad-node/commit/40bf088914e1bed67f4bdffb0d2f57d15acb005b))
+* **client:** qualify global Blob ([cd495ee](https://github.com/flowglad/flowglad-node/commit/cd495ee6316fd1446b3f75c6391614a65fa077b2))
+* **deps:** update dependency @types/node to v20.17.58 ([7de8c26](https://github.com/flowglad/flowglad-node/commit/7de8c26d2445a86dbb169927474d4532fc9be9db))
+* **internal:** codegen related update ([1fee692](https://github.com/flowglad/flowglad-node/commit/1fee69217a0af68c31e20ff9dce4b5a1aa2a5796))
+* **internal:** codegen related update ([0b5da41](https://github.com/flowglad/flowglad-node/commit/0b5da41eee71d91adfe082a3ccedf362acee76f8))
+* **internal:** codegen related update ([5cc2ae0](https://github.com/flowglad/flowglad-node/commit/5cc2ae097780f0c82353c97bf3a174b3f540e9ef))
+* **internal:** codegen related update ([a3b57a4](https://github.com/flowglad/flowglad-node/commit/a3b57a4f643053e79b6dd171076df37494824738))
+* **internal:** formatting change ([57a4460](https://github.com/flowglad/flowglad-node/commit/57a4460b3bb1954afcb735b61f3c30f622b40404))
+* **internal:** make mcp-server publishing public by defaut ([dedddc8](https://github.com/flowglad/flowglad-node/commit/dedddc805fbf512c0d65c8d2d728b652d32c653e))
+* **internal:** move publish config ([65be443](https://github.com/flowglad/flowglad-node/commit/65be443b89aadf906fe1a6cbddb5a00e0174fcb1))
+* **internal:** refactor array check ([88ca819](https://github.com/flowglad/flowglad-node/commit/88ca819ac06af4800a2337b4ad4a57276cded8ee))
+* **internal:** remove redundant imports config ([62fbf68](https://github.com/flowglad/flowglad-node/commit/62fbf68fcc53ef784abf22955bd63e81c062779e))
+* **internal:** update comment in script ([ecd3afd](https://github.com/flowglad/flowglad-node/commit/ecd3afd63aabdf4d9d92ed49dfbf60d603987118))
+* make some internal functions async ([d14a6a0](https://github.com/flowglad/flowglad-node/commit/d14a6a0c3ede0dfbd908bccc52e0a20f9bab2e79))
+* **mcp:** add cors to oauth metadata route ([1a638e6](https://github.com/flowglad/flowglad-node/commit/1a638e6e931926156ab3d312abbea1ee6de1e69c))
+* **mcp:** document remote server in README.md ([13d6332](https://github.com/flowglad/flowglad-node/commit/13d6332d23369dc5d6ba4838c250ec58fec9866d))
+* **mcp:** formatting ([30ba925](https://github.com/flowglad/flowglad-node/commit/30ba92555911cb0fc0e5069f3ecc736549663db5))
+* **mcp:** minor cleanup of types and package.json ([53ee586](https://github.com/flowglad/flowglad-node/commit/53ee5863b0f001ea4f87412c740347e4b471cd19))
+* **mcp:** refactor streamable http transport ([537cc07](https://github.com/flowglad/flowglad-node/commit/537cc079137027a1b7c5bb50c9e6dd89a8210c98))
+* **mcp:** rework imports in tools ([4fb589d](https://github.com/flowglad/flowglad-node/commit/4fb589d6bbd22237a3dfb908c9b76935086259cc))
+* **mcp:** update package.json ([3e6dbd9](https://github.com/flowglad/flowglad-node/commit/3e6dbd9ce8bd763d5f0c07e9cafdd81b57c9b7c7))
+* **mcp:** update README ([8640f1b](https://github.com/flowglad/flowglad-node/commit/8640f1b212b97452e5e80076f979e0c9af089b49))
+* **mcp:** update types ([fa495cb](https://github.com/flowglad/flowglad-node/commit/fa495cb6f78f4ff90234cd024aff809bfaee726b))
+* **ts:** reorder package.json imports ([75a2591](https://github.com/flowglad/flowglad-node/commit/75a25917485552028c3b738098a3ca198378f347))
+* update @stainless-api/prism-cli to v5.15.0 ([1a848b0](https://github.com/flowglad/flowglad-node/commit/1a848b075c1d9bc00c3a4fcc775e29c4445e5d48))
+* update CI script ([7958db2](https://github.com/flowglad/flowglad-node/commit/7958db2cb6b6c62ae8e177f84698b480d8f2d1fd))
+
 ## 0.21.0 (2025-06-25)
 
 Full Changelog: [v0.20.0...v0.21.0](https://github.com/flowglad/flowglad-node/compare/v0.20.0...v0.21.0)

diff --git a/README.md b/README.md
@@ -22,7 +22,9 @@ The full API of this library can be found in [api.md](api.md).
 ```js
 import Flowglad from '@flowglad/node';
 
-const client = new Flowglad();
+const client = new Flowglad({
+  apiKey: process.env['FLOWGLAD_SECRET_KEY'], // This is the default and can be omitted
+});
 
 const payments = await client.payments.list();
 
@@ -37,7 +39,9 @@ This library includes TypeScript definitions for all request params and response
 ```ts
 import Flowglad from '@flowglad/node';
 
-const client = new Flowglad();
+const client = new Flowglad({
+  apiKey: process.env['FLOWGLAD_SECRET_KEY'], // This is the default and can be omitted
+});
 
 const payments: Flowglad.PaymentListResponse = await client.payments.list();
 ```

diff --git a/api.md b/api.md
@@ -1,14 +1,30 @@
+# Shared
+
+Types:
+
+- <code><a href="./src/resources/shared.ts">BillingAddress</a></code>
+- <code><a href="./src/resources/shared.ts">NonRenewingSubscriptionRecord</a></code>
+- <code><a href="./src/resources/shared.ts">PaymentMethodClientSelectSchema</a></code>
+- <code><a href="./src/resources/shared.ts">PricingModelDetailsRecord</a></code>
+- <code><a href="./src/resources/shared.ts">PurchaseInvoiceClientSelectSchema</a></code>
+- <code><a href="./src/resources/shared.ts">StandaloneInvoiceClientSelectSchema</a></code>
+- <code><a href="./src/resources/shared.ts">StandardSubscriptionRecord</a></code>
+- <code><a href="./src/resources/shared.ts">StaticInvoiceLineItemClientSelectSchema</a></code>
+- <code><a href="./src/resources/shared.ts">SubscriptionInvoiceClientSelectSchema</a></code>
+- <code><a href="./src/resources/shared.ts">ToggleFeatureClientSelectSchema</a></code>
+- <code><a href="./src/resources/shared.ts">UsageCreditGrantFeatureClientSelectSchema</a></code>
+- <code><a href="./src/resources/shared.ts">UsageInvoiceLineItemClientSelectSchema</a></code>
+- <code><a href="./src/resources/shared.ts">UsageMeterClientSelectSchema</a></code>
+
 # Invoices
 
 Types:
 
-- <code><a href="./src/resources/invoices.ts">InvoiceCreateResponse</a></code>
 - <code><a href="./src/resources/invoices.ts">InvoiceRetrieveResponse</a></code>
 - <code><a href="./src/resources/invoices.ts">InvoiceListResponse</a></code>
 
 Methods:
 
-- <code title="post /api/v1/invoices">client.invoices.<a href="./src/resources/invoices.ts">create</a>({ ...params }) -> InvoiceCreateResponse</code>
 - <code title="get /api/v1/invoices/{id}">client.invoices.<a href="./src/resources/invoices.ts">retrieve</a>(id) -> InvoiceRetrieveResponse</code>
 - <code title="get /api/v1/invoices">client.invoices.<a href="./src/resources/invoices.ts">list</a>({ ...params }) -> InvoiceListResponse</code>
 
@@ -24,30 +40,36 @@ Methods:
 - <code title="get /api/v1/invoice-line-items/{id}">client.invoiceLineItems.<a href="./src/resources/invoice-line-items.ts">retrieve</a>(id) -> InvoiceLineItemRetrieveResponse</code>
 - <code title="get /api/v1/invoice-line-items">client.invoiceLineItems.<a href="./src/resources/invoice-line-items.ts">list</a>({ ...params }) -> InvoiceLineItemListResponse</code>
 
-# Catalogs
+# PricingModels
 
 Types:
 
-- <code><a href="./src/resources/catalogs.ts">CatalogCreateResponse</a></code>
-- <code><a href="./src/resources/catalogs.ts">CatalogRetrieveResponse</a></code>
-- <code><a href="./src/resources/catalogs.ts">CatalogUpdateResponse</a></code>
-- <code><a href="./src/resources/catalogs.ts">CatalogListResponse</a></code>
-- <code><a href="./src/resources/catalogs.ts">CatalogCloneResponse</a></code>
-- <code><a href="./src/resources/catalogs.ts">CatalogRetrieveDefaultResponse</a></code>
+- <code><a href="./src/resources/pricing-models.ts">PricingModelClientSelectSchema</a></code>
+- <code><a href="./src/resources/pricing-models.ts">PricingModelCreateResponse</a></code>
+- <code><a href="./src/resources/pricing-models.ts">PricingModelRetrieveResponse</a></code>
+- <code><a href="./src/resources/pricing-models.ts">PricingModelUpdateResponse</a></code>
+- <code><a href="./src/resources/pricing-models.ts">PricingModelListResponse</a></code>
+- <code><a href="./src/resources/pricing-models.ts">PricingModelCloneResponse</a></code>
+- <code><a href="./src/resources/pricing-models.ts">PricingModelRetrieveDefaultResponse</a></code>
 
 Methods:
 
-- <code title="post /api/v1/catalogs">client.catalogs.<a href="./src/resources/catalogs.ts">create</a>({ ...params }) -> CatalogCreateResponse</code>
-- <code title="get /api/v1/catalogs/{id}">client.catalogs.<a href="./src/resources/catalogs.ts">retrieve</a>(id) -> CatalogRetrieveResponse</code>
-- <code title="put /api/v1/catalogs/{id}">client.catalogs.<a href="./src/resources/catalogs.ts">update</a>(id, { ...params }) -> CatalogUpdateResponse</code>
-- <code title="get /api/v1/catalogs">client.catalogs.<a href="./src/resources/catalogs.ts">list</a>({ ...params }) -> CatalogListResponse</code>
-- <code title="post /api/v1/catalogs/{id}/clone">client.catalogs.<a href="./src/resources/catalogs.ts">clone</a>(id, { ...params }) -> CatalogCloneResponse</code>
-- <code title="get /api/v1/catalogs/default">client.catalogs.<a href="./src/resources/catalogs.ts">retrieveDefault</a>() -> CatalogRetrieveDefaultResponse</code>
+- <code title="post /api/v1/pricing-models">client.pricingModels.<a href="./src/resources/pricing-models.ts">create</a>({ ...params }) -> PricingModelCreateResponse</code>
+- <code title="get /api/v1/pricing-models/{id}">client.pricingModels.<a href="./src/resources/pricing-models.ts">retrieve</a>(id) -> PricingModelRetrieveResponse</code>
+- <code title="put /api/v1/pricing-models/{id}">client.pricingModels.<a href="./src/resources/pricing-models.ts">update</a>(id, { ...params }) -> PricingModelUpdateResponse</code>
+- <code title="get /api/v1/pricing-models">client.pricingModels.<a href="./src/resources/pricing-models.ts">list</a>({ ...params }) -> PricingModelListResponse</code>
+- <code title="post /api/v1/pricing-models/{id}/clone">client.pricingModels.<a href="./src/resources/pricing-models.ts">clone</a>(id, { ...params }) -> PricingModelCloneResponse</code>
+- <code title="get /api/v1/pricing-models/default">client.pricingModels.<a href="./src/resources/pricing-models.ts">retrieveDefault</a>() -> PricingModelRetrieveDefaultResponse</code>
 
 # CheckoutSessions
 
 Types:
 
+- <code><a href="./src/resources/checkout-sessions.ts">ActivateSubscriptionCheckoutSessionClientSelectSchema</a></code>
+- <code><a href="./src/resources/checkout-sessions.ts">AddPaymentMethodCheckoutSessionClientSelectSchema</a></code>
+- <code><a href="./src/resources/checkout-sessions.ts">InvoiceCheckoutSessionClientSelectSchema</a></code>
+- <code><a href="./src/resources/checkout-sessions.ts">ProductCheckoutSessionClientSelectSchema</a></code>
+- <code><a href="./src/resources/checkout-sessions.ts">PurchaseCheckoutSessionClientSelectSchema</a></code>
 - <code><a href="./src/resources/checkout-sessions.ts">CheckoutSessionCreateResponse</a></code>
 - <code><a href="./src/resources/checkout-sessions.ts">CheckoutSessionRetrieveResponse</a></code>
 - <code><a href="./src/resources/checkout-sessions.ts">CheckoutSessionListResponse</a></code>
@@ -62,6 +84,7 @@ Methods:
 
 Types:
 
+- <code><a href="./src/resources/products.ts">ProductClientSelectSchema</a></code>
 - <code><a href="./src/resources/products.ts">ProductCreateResponse</a></code>
 - <code><a href="./src/resources/products.ts">ProductRetrieveResponse</a></code>
 - <code><a href="./src/resources/products.ts">ProductUpdateResponse</a></code>
@@ -78,6 +101,9 @@ Methods:
 
 Types:
 
+- <code><a href="./src/resources/prices.ts">SinglePaymentPriceClientSelectSchema</a></code>
+- <code><a href="./src/resources/prices.ts">SubscriptionPriceClientSelectSchema</a></code>
+- <code><a href="./src/resources/prices.ts">UsagePriceClientSelectSchema</a></code>
 - <code><a href="./src/resources/prices.ts">PriceCreateResponse</a></code>
 - <code><a href="./src/resources/prices.ts">PriceUpdateResponse</a></code>
 - <code><a href="./src/resources/prices.ts">PriceListResponse</a></code>
@@ -92,6 +118,9 @@ Methods:
 
 Types:
 
+- <code><a href="./src/resources/discounts.ts">DefaultDiscountClientSelectSchema</a></code>
+- <code><a href="./src/resources/discounts.ts">ForeverDiscountClientSelectSchema</a></code>
+- <code><a href="./src/resources/discounts.ts">NumberOfPaymentsDiscountClientSelectSchema</a></code>
 - <code><a href="./src/resources/discounts.ts">DiscountCreateResponse</a></code>
 - <code><a href="./src/resources/discounts.ts">DiscountRetrieveResponse</a></code>
 - <code><a href="./src/resources/discounts.ts">DiscountUpdateResponse</a></code>
@@ -108,6 +137,9 @@ Methods:
 
 Types:
 
+- <code><a href="./src/resources/customers.ts">CustomerClientSelectSchema</a></code>
+- <code><a href="./src/resources/customers.ts">ToggleSubscriptionItemFeatureRecord</a></code>
+- <code><a href="./src/resources/customers.ts">UsageCreditGrantSubscriptionItemFeatureClientSelectSchema</a></code>
 - <code><a href="./src/resources/customers.ts">CustomerCreateResponse</a></code>
 - <code><a href="./src/resources/customers.ts">CustomerRetrieveResponse</a></code>
 - <code><a href="./src/resources/customers.ts">CustomerUpdateResponse</a></code>
@@ -126,6 +158,7 @@ Methods:
 
 Types:
 
+- <code><a href="./src/resources/payments.ts">PaymentClientSelectSchema</a></code>
 - <code><a href="./src/resources/payments.ts">PaymentRetrieveResponse</a></code>
 - <code><a href="./src/resources/payments.ts">PaymentListResponse</a></code>
 - <code><a href="./src/resources/payments.ts">PaymentRefundResponse</a></code>