Skip to content

Commit 692de1c

Browse files
stainless-app[bot]stainless-app[bot]
authored
release: 6.38.0 (#631)
* feat(api): api update * chore: update CI script * feat(mcp): change remote server query option parsing logic * chore(internal): codegen related update * feat(mcp): expose client options in `streamableHTTPApp` * fix(mcp): avoid importing unsupported libraries on non-node environments * feat(mcp): allow setting logging level * feat(mcp): add mcp bundles to build script * chore(internal): codegen related update * chore: ci build action * fix(mcp): fix query options parsing * fix: coerce nullable values to undefined * feat(api): api update * feat(api): make client id, client secret optional again * chore(mcp): upload dxt as release asset * fix(mcp): fix uploading dxt release assets * fix(ci): set permissions for DXT publish action * chore(mcp): rename dxt to mcpb * chore(internal): gitignore .mcpb files * feat(mcp): add docs search tool * chore(codegen): internal codegen update * chore: do not install brew dependencies in ./scripts/bootstrap by default * feat(mcp): enable experimental docs search tool * feat(mcp): add option for including docs tools * codegen metadata * perf: faster formatting * chore(internal): remove deprecated `compilerOptions.baseUrl` from tsconfig.json This allows sdks to be built using tsgo - see microsoft/typescript-go#474 * chore(internal): fix incremental formatting in some cases * chore(mcp): allow pointing `docs_search` tool at other URLs * codegen metadata * chore(internal): codegen related update * feat(api): api update * chore(internal): ignore .eslintcache * fix(mcp): fix cli argument parsing logic * fix(mcp): resolve a linting issue in server code * chore: update lockfile * codegen metadata * chore(internal): remove .eslintcache * chore(internal): use npm pack for build uploads * feat(api): api update * feat(api): api update * chore: extract some types in mcp docs * codegen metadata * feat(api): api update * feat(api): api update * feat(api): api update * feat(api): api update * fix(client): incorrect offset pagination check * feat(api): api update * feat(api): api update * release: 6.38.0 --------- Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>
1 parent 27054e6 commit 692de1c

File tree

126 files changed

+1798
-1043
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

126 files changed

+1798
-1043
lines changed

‎.devcontainer/devcontainer.json‎

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,7 @@
99
"postCreateCommand": "yarn install",
1010
"customizations": {
1111
"vscode": {
12-
"extensions": [
13-
"esbenp.prettier-vscode"
14-
]
12+
"extensions": ["esbenp.prettier-vscode"]
1513
}
1614
}
1715
}

‎.github/workflows/ci.yml‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,15 @@ jobs:
6868
AUTH: ${{ steps.github-oidc.outputs.github_token }}
6969
SHA: ${{ github.sha }}
7070
run: ./scripts/utils/upload-artifact.sh
71+
72+
- name: Upload MCP Server tarball
73+
if: github.repository == 'stainless-sdks/finch-node'
74+
env:
75+
URL: https://pkg.stainless.com/s?subpackage=mcp-server
76+
AUTH: ${{ steps.github-oidc.outputs.github_token }}
77+
SHA: ${{ github.sha }}
78+
BASE_PATH: packages/mcp-server
79+
run: ./scripts/utils/upload-artifact.sh
7180
test:
7281
timeout-minutes: 10
7382
name: test

‎.github/workflows/publish-npm.yml‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ jobs:
1616
publish:
1717
name: publish
1818
runs-on: ubuntu-latest
19+
permissions:
20+
contents: write
1921

2022
steps:
2123
- uses: actions/checkout@v4
@@ -39,3 +41,10 @@ jobs:
3941
yarn tsn scripts/publish-packages.ts "{ \"paths_released\": \"$PATHS_RELEASED\" }"
4042
env:
4143
NPM_TOKEN: ${{ secrets.FINCH_NPM_TOKEN || secrets.NPM_TOKEN }}
44+
45+
- name: Upload MCP Server DXT GitHub release asset
46+
run: |
47+
gh release upload ${{ github.event.release.tag_name }} \
48+
packages/mcp-server/tryfinch_finch_api_api.mcpb
49+
env:
50+
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

‎.gitignore‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,4 +7,6 @@ dist
77
dist-deno
88
/*.tgz
99
.idea/
10-
10+
.eslintcache
11+
dist-bundle
12+
*.mcpb

‎.release-please-manifest.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
{
2-
".": "6.37.0"
2+
".": "6.38.0"
33
}

‎.stats.yml‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
configured_endpoints: 46
2-
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-6d0c6a1feba5ccb895a6779cd98c2a0ae87d6394f5e98a9da51f17258c4eb297.yml
3-
openapi_spec_hash: ac3be0c8a992103e5f467fe1bcb20a81
4-
config_hash: 5146b12344dae76238940989dac1e8a0
2+
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/finch%2Ffinch-0105d239fcaf84750c886dfa6c2cfbf2b2087f89a48f8827c4cbe28479ebfb13.yml
3+
openapi_spec_hash: 34895c3d3c137fb9f5a019ac5370afbb
4+
config_hash: 6d3585c0032e08d723d077d660fc8448

‎CHANGELOG.md‎

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,70 @@
11
# Changelog
22

3+
## 6.38.0 (2025-10-27)
4+
5+
Full Changelog: [v6.37.0...v6.38.0](https://github.com/Finch-API/finch-api-node/compare/v6.37.0...v6.38.0)
6+
7+
### Features
8+
9+
* **api:** api update ([4d57031](https://github.com/Finch-API/finch-api-node/commit/4d5703128cd8a626dec68fe4ffc34980579bcd6f))
10+
* **api:** api update ([50af0c2](https://github.com/Finch-API/finch-api-node/commit/50af0c2c4756708e0de6bdb3c1eaacce3d24733b))
11+
* **api:** api update ([9fb854f](https://github.com/Finch-API/finch-api-node/commit/9fb854f6ceaac25e21901b4a035d2207de994901))
12+
* **api:** api update ([96d3f66](https://github.com/Finch-API/finch-api-node/commit/96d3f666690caea95b650b954dfd681eeb686c8e))
13+
* **api:** api update ([b331c10](https://github.com/Finch-API/finch-api-node/commit/b331c108e3912c503e4cc8393587bac2a927f4f7))
14+
* **api:** api update ([99a20c2](https://github.com/Finch-API/finch-api-node/commit/99a20c267f645658d3928f269f5da7a33b287d17))
15+
* **api:** api update ([f9c7e06](https://github.com/Finch-API/finch-api-node/commit/f9c7e0685ff5ab28614353eacc1fc7887ec6a0ff))
16+
* **api:** api update ([1c4f073](https://github.com/Finch-API/finch-api-node/commit/1c4f073cc8e8f06e58069dcc2bc5b708e3a8be34))
17+
* **api:** api update ([843b525](https://github.com/Finch-API/finch-api-node/commit/843b525f6a3f07edda04ca213a35dd3d2d37fdb3))
18+
* **api:** api update ([9bc9a38](https://github.com/Finch-API/finch-api-node/commit/9bc9a38df44189e734248cf7ad06259f93e25b82))
19+
* **api:** api update ([09d2e93](https://github.com/Finch-API/finch-api-node/commit/09d2e939a8c42d495d9207ad2d73841f6e9e8732))
20+
* **api:** make client id, client secret optional again ([d67f867](https://github.com/Finch-API/finch-api-node/commit/d67f867f1b3c9e4886d21da21a1cccab5760aa9d))
21+
* **mcp:** add docs search tool ([a9e8666](https://github.com/Finch-API/finch-api-node/commit/a9e866662d47e0f39a1988339101d46ba149fb9d))
22+
* **mcp:** add mcp bundles to build script ([45794fe](https://github.com/Finch-API/finch-api-node/commit/45794fe7a8d09dd0160ac3d2a64941fff12837d5))
23+
* **mcp:** add option for including docs tools ([fef1f5b](https://github.com/Finch-API/finch-api-node/commit/fef1f5b0cc05c737db89097378c88a38e8973089))
24+
* **mcp:** allow setting logging level ([4634f9a](https://github.com/Finch-API/finch-api-node/commit/4634f9a04f0fd3a7daa781876a1d93e170f1941d))
25+
* **mcp:** change remote server query option parsing logic ([13ef1bd](https://github.com/Finch-API/finch-api-node/commit/13ef1bd4400e1ae2b2197a35f33e79703af34e08))
26+
* **mcp:** enable experimental docs search tool ([8ec38f6](https://github.com/Finch-API/finch-api-node/commit/8ec38f6536ca6a6e7324dd827db0dc9ee9234f61))
27+
* **mcp:** expose client options in `streamableHTTPApp` ([39cdb76](https://github.com/Finch-API/finch-api-node/commit/39cdb7601c55b6d723132edeb320c3898e697fa2))
28+
29+
30+
### Bug Fixes
31+
32+
* **ci:** set permissions for DXT publish action ([6a6dd0a](https://github.com/Finch-API/finch-api-node/commit/6a6dd0af7e290990c7773447615e3e5d99ff217b))
33+
* **client:** incorrect offset pagination check ([2600077](https://github.com/Finch-API/finch-api-node/commit/26000775b7ab71e9e3994196806a847383905853))
34+
* coerce nullable values to undefined ([aa135f5](https://github.com/Finch-API/finch-api-node/commit/aa135f5fdfe89359b6ad8c49b1908e7faee4ebaa))
35+
* **mcp:** avoid importing unsupported libraries on non-node environments ([8c380a8](https://github.com/Finch-API/finch-api-node/commit/8c380a8499435e8a92155664943e6fc631f7ba1a))
36+
* **mcp:** fix cli argument parsing logic ([277ba31](https://github.com/Finch-API/finch-api-node/commit/277ba31b242825bd569a6566a8f2a136ec0b595d))
37+
* **mcp:** fix query options parsing ([9087760](https://github.com/Finch-API/finch-api-node/commit/90877607933fa892f5d05c8931fa2de9d139e769))
38+
* **mcp:** fix uploading dxt release assets ([70f9a36](https://github.com/Finch-API/finch-api-node/commit/70f9a36f47190f4b78de043e63d65e21df6ce116))
39+
* **mcp:** resolve a linting issue in server code ([90b7ae2](https://github.com/Finch-API/finch-api-node/commit/90b7ae260d427cebb7bcd7f2d3e854a0efaccd19))
40+
41+
42+
### Performance Improvements
43+
44+
* faster formatting ([163982a](https://github.com/Finch-API/finch-api-node/commit/163982a884bcf10684b5b3e242b0d52d547fc62b))
45+
46+
47+
### Chores
48+
49+
* ci build action ([f0c3633](https://github.com/Finch-API/finch-api-node/commit/f0c3633571f7eea46803cb75ba244c41cac5a7b4))
50+
* **codegen:** internal codegen update ([27ec1f5](https://github.com/Finch-API/finch-api-node/commit/27ec1f5a8d71f31a327021745f7dab0aeebc4b7b))
51+
* do not install brew dependencies in ./scripts/bootstrap by default ([1758c0d](https://github.com/Finch-API/finch-api-node/commit/1758c0de64e97975332bb8a0c6b55a23ed82a036))
52+
* extract some types in mcp docs ([55c3799](https://github.com/Finch-API/finch-api-node/commit/55c37998bdb39779bfb9ae62ee5310a2a423248d))
53+
* **internal:** codegen related update ([d020050](https://github.com/Finch-API/finch-api-node/commit/d0200501b52ae4ac9e7c8de91d2f883e27db34c5))
54+
* **internal:** codegen related update ([697d211](https://github.com/Finch-API/finch-api-node/commit/697d211b9600d388aa101879ac6c400e4eb4ac53))
55+
* **internal:** codegen related update ([ac835bf](https://github.com/Finch-API/finch-api-node/commit/ac835bf6af93d53e551d73001d048baa95e1c334))
56+
* **internal:** fix incremental formatting in some cases ([40ecf6a](https://github.com/Finch-API/finch-api-node/commit/40ecf6a887ea44d156672f155abf70ab2d146921))
57+
* **internal:** gitignore .mcpb files ([73c778e](https://github.com/Finch-API/finch-api-node/commit/73c778e3b9d157f8296c43131cd0db764d5086bc))
58+
* **internal:** ignore .eslintcache ([4d90156](https://github.com/Finch-API/finch-api-node/commit/4d901569e987fa9c93c12ae77844972b4655fa8f))
59+
* **internal:** remove .eslintcache ([64d2197](https://github.com/Finch-API/finch-api-node/commit/64d21976509a6d6b6d0095bf1867ad9bdd153e03))
60+
* **internal:** remove deprecated `compilerOptions.baseUrl` from tsconfig.json ([5955e29](https://github.com/Finch-API/finch-api-node/commit/5955e291311d6d8192a3e8c3eb87f4eac9bdbdbc))
61+
* **internal:** use npm pack for build uploads ([7df5a28](https://github.com/Finch-API/finch-api-node/commit/7df5a28a1be002645785fa2d59cd94da5df28889))
62+
* **mcp:** allow pointing `docs_search` tool at other URLs ([bb7f182](https://github.com/Finch-API/finch-api-node/commit/bb7f182ef3959a99a7728cdab685d972e4110756))
63+
* **mcp:** rename dxt to mcpb ([68a9c07](https://github.com/Finch-API/finch-api-node/commit/68a9c079dfb35ab661f58780405036399fbaf31e))
64+
* **mcp:** upload dxt as release asset ([256c717](https://github.com/Finch-API/finch-api-node/commit/256c717c7eb0bd947322b14d85fc15cd7f919724))
65+
* update CI script ([47843c8](https://github.com/Finch-API/finch-api-node/commit/47843c85864215c19edd9826952bd625e79ca78c))
66+
* update lockfile ([0601d2a](https://github.com/Finch-API/finch-api-node/commit/0601d2aca7eeb80b8967d3bc89dea5b5ab527565))
67+
368
## 6.37.0 (2025-08-21)
469

570
Full Changelog: [v6.36.0...v6.37.0](https://github.com/Finch-API/finch-api-node/compare/v6.36.0...v6.37.0)

‎api.md‎

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -40,7 +40,7 @@ Types:
4040

4141
Methods:
4242

43-
- <code title="get /employer/company">client.hris.company.<a href="./src/resources/hris/company/company.ts">retrieve</a>() -> Company</code>
43+
- <code title="get /employer/company">client.hris.company.<a href="./src/resources/hris/company/company.ts">retrieve</a>({ ...params }) -> Company</code>
4444

4545
### PayStatementItem
4646

@@ -65,8 +65,8 @@ Methods:
6565

6666
- <code title="post /employer/pay-statement-item/rule">client.hris.company.payStatementItem.rules.<a href="./src/resources/hris/company/pay-statement-item/rules.ts">create</a>({ ...params }) -> RuleCreateResponse</code>
6767
- <code title="put /employer/pay-statement-item/rule/{rule_id}">client.hris.company.payStatementItem.rules.<a href="./src/resources/hris/company/pay-statement-item/rules.ts">update</a>(ruleId, { ...params }) -> RuleUpdateResponse</code>
68-
- <code title="get /employer/pay-statement-item/rule">client.hris.company.payStatementItem.rules.<a href="./src/resources/hris/company/pay-statement-item/rules.ts">list</a>() -> RuleListResponsesPage</code>
69-
- <code title="delete /employer/pay-statement-item/rule/{rule_id}">client.hris.company.payStatementItem.rules.<a href="./src/resources/hris/company/pay-statement-item/rules.ts">delete</a>(ruleId) -> RuleDeleteResponse</code>
68+
- <code title="get /employer/pay-statement-item/rule">client.hris.company.payStatementItem.rules.<a href="./src/resources/hris/company/pay-statement-item/rules.ts">list</a>({ ...params }) -> RuleListResponsesPage</code>
69+
- <code title="delete /employer/pay-statement-item/rule/{rule_id}">client.hris.company.payStatementItem.rules.<a href="./src/resources/hris/company/pay-statement-item/rules.ts">delete</a>(ruleId, { ...params }) -> RuleDeleteResponse</code>
7070

7171
## Directory
7272

@@ -136,7 +136,7 @@ Types:
136136
Methods:
137137

138138
- <code title="get /employer/documents">client.hris.documents.<a href="./src/resources/hris/documents.ts">list</a>({ ...params }) -> DocumentListResponse</code>
139-
- <code title="get /employer/documents/{document_id}">client.hris.documents.<a href="./src/resources/hris/documents.ts">retreive</a>(documentId) -> DocumentRetreiveResponse</code>
139+
- <code title="get /employer/documents/{document_id}">client.hris.documents.<a href="./src/resources/hris/documents.ts">retreive</a>(documentId, { ...params }) -> DocumentRetreiveResponse</code>
140140

141141
## Benefits
142142

@@ -157,10 +157,10 @@ Types:
157157
Methods:
158158

159159
- <code title="post /employer/benefits">client.hris.benefits.<a href="./src/resources/hris/benefits/benefits.ts">create</a>({ ...params }) -> CreateCompanyBenefitsResponse</code>
160-
- <code title="get /employer/benefits/{benefit_id}">client.hris.benefits.<a href="./src/resources/hris/benefits/benefits.ts">retrieve</a>(benefitId) -> CompanyBenefit</code>
160+
- <code title="get /employer/benefits/{benefit_id}">client.hris.benefits.<a href="./src/resources/hris/benefits/benefits.ts">retrieve</a>(benefitId, { ...params }) -> CompanyBenefit</code>
161161
- <code title="post /employer/benefits/{benefit_id}">client.hris.benefits.<a href="./src/resources/hris/benefits/benefits.ts">update</a>(benefitId, { ...params }) -> UpdateCompanyBenefitResponse</code>
162-
- <code title="get /employer/benefits">client.hris.benefits.<a href="./src/resources/hris/benefits/benefits.ts">list</a>() -> CompanyBenefitsSinglePage</code>
163-
- <code title="get /employer/benefits/meta">client.hris.benefits.<a href="./src/resources/hris/benefits/benefits.ts">listSupportedBenefits</a>() -> SupportedBenefitsSinglePage</code>
162+
- <code title="get /employer/benefits">client.hris.benefits.<a href="./src/resources/hris/benefits/benefits.ts">list</a>({ ...params }) -> CompanyBenefitsSinglePage</code>
163+
- <code title="get /employer/benefits/meta">client.hris.benefits.<a href="./src/resources/hris/benefits/benefits.ts">listSupportedBenefits</a>({ ...params }) -> SupportedBenefitsSinglePage</code>
164164

165165
### Individuals
166166

@@ -174,7 +174,7 @@ Types:
174174
Methods:
175175

176176
- <code title="post /employer/benefits/{benefit_id}/individuals">client.hris.benefits.individuals.<a href="./src/resources/hris/benefits/individuals.ts">enrollMany</a>(benefitId, [ ...individuals ]) -> EnrolledIndividualBenefitResponse</code>
177-
- <code title="get /employer/benefits/{benefit_id}/enrolled">client.hris.benefits.individuals.<a href="./src/resources/hris/benefits/individuals.ts">enrolledIds</a>(benefitId) -> IndividualEnrolledIDsResponse</code>
177+
- <code title="get /employer/benefits/{benefit_id}/enrolled">client.hris.benefits.individuals.<a href="./src/resources/hris/benefits/individuals.ts">enrolledIds</a>(benefitId, { ...params }) -> IndividualEnrolledIDsResponse</code>
178178
- <code title="get /employer/benefits/{benefit_id}/individuals">client.hris.benefits.individuals.<a href="./src/resources/hris/benefits/individuals.ts">retrieveManyBenefits</a>(benefitId, { ...params }) -> IndividualBenefitsSinglePage</code>
179179
- <code title="delete /employer/benefits/{benefit_id}/individuals">client.hris.benefits.individuals.<a href="./src/resources/hris/benefits/individuals.ts">unenrollMany</a>(benefitId, { ...params }) -> UnenrolledIndividualBenefitResponse</code>
180180

@@ -183,10 +183,11 @@ Methods:
183183
Types:
184184

185185
- <code><a href="./src/resources/providers.ts">Provider</a></code>
186+
- <code><a href="./src/resources/providers.ts">ProviderListResponse</a></code>
186187

187188
Methods:
188189

189-
- <code title="get /providers">client.providers.<a href="./src/resources/providers.ts">list</a>() -> ProvidersSinglePage</code>
190+
- <code title="get /providers">client.providers.<a href="./src/resources/providers.ts">list</a>() -> ProviderListResponsesSinglePage</code>
190191

191192
# Account
192193

@@ -243,7 +244,7 @@ Types:
243244
Methods:
244245

245246
- <code title="post /jobs/automated">client.jobs.automated.<a href="./src/resources/jobs/automated.ts">create</a>({ ...params }) -> AutomatedCreateResponse</code>
246-
- <code title="get /jobs/automated/{job_id}">client.jobs.automated.<a href="./src/resources/jobs/automated.ts">retrieve</a>(jobId, { ...params }) -> AutomatedAsyncJob</code>
247+
- <code title="get /jobs/automated/{job_id}">client.jobs.automated.<a href="./src/resources/jobs/automated.ts">retrieve</a>(jobId) -> AutomatedAsyncJob</code>
247248
- <code title="get /jobs/automated">client.jobs.automated.<a href="./src/resources/jobs/automated.ts">list</a>({ ...params }) -> AutomatedListResponse</code>
248249

249250
## Manual
@@ -254,7 +255,7 @@ Types:
254255

255256
Methods:
256257

257-
- <code title="get /jobs/manual/{job_id}">client.jobs.manual.<a href="./src/resources/jobs/manual.ts">retrieve</a>(jobId, { ...params }) -> ManualAsyncJob</code>
258+
- <code title="get /jobs/manual/{job_id}">client.jobs.manual.<a href="./src/resources/jobs/manual.ts">retrieve</a>(jobId) -> ManualAsyncJob</code>
258259

259260
# Sandbox
260261

@@ -363,7 +364,7 @@ Types:
363364

364365
Methods:
365366

366-
- <code title="get /employer/pay-groups/{pay_group_id}">client.payroll.payGroups.<a href="./src/resources/payroll/pay-groups.ts">retrieve</a>(payGroupId) -> PayGroupRetrieveResponse</code>
367+
- <code title="get /employer/pay-groups/{pay_group_id}">client.payroll.payGroups.<a href="./src/resources/payroll/pay-groups.ts">retrieve</a>(payGroupId, { ...params }) -> PayGroupRetrieveResponse</code>
367368
- <code title="get /employer/pay-groups">client.payroll.payGroups.<a href="./src/resources/payroll/pay-groups.ts">list</a>({ ...params }) -> PayGroupListResponsesSinglePage</code>
368369

369370
# Connect

‎package.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@tryfinch/finch-api",
3-
"version": "6.37.0",
3+
"version": "6.38.0",
44
"description": "The official TypeScript library for the Finch API",
55
"author": "Finch <founders@tryfinch.com>",
66
"types": "dist/index.d.ts",

‎packages/mcp-server/README.md‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -238,7 +238,6 @@ The following tools are available in this MCP server.
238238
### Resource `hris.directory`:
239239

240240
- `list_hris_directory` (`read`): Read company directory and organization structure
241-
- `list_individuals_hris_directory` (`read`): Read company directory and organization structure
242241

243242
### Resource `hris.individuals`:
244243

0 commit comments

Comments
 (0)