Skip to content

feat(web-api): add admin.apps.mcp.servers.list method - #2849

Merged
zimeg merged 58 commits into
mainfrom
zimeg-feat-admin-apps-mcp-servers-list
Nov 13, 2026
Merged

zimeg merged 58 commits into
mainfrom
zimeg-feat-admin-apps-mcp-servers-list

Conversation

@zimeg

@zimeg zimeg commented Nov 13, 2026 •

Copy link
Copy Markdown
Member

Summary

This pull request adds the admin.apps.mcp.servers.list method to @slack/web-api.

  • client.admin.apps.mcp.servers.list() takes optional limit and cursor, so it binds with bindApiCallWithOptionalArgument.
  • It needs an org-level user token with admin.apps:read.
  • AdminAppsMcpServersListResponse is generated with the scripts/code_generator.rb quicktype options from a response recorded in an Enterprise developer sandbox.
  • Adds type tests and a minor changeset.

This is part 1 of 3 in a stack that adds the admin.apps.mcp.servers methods one at a time. Building a Slackbot skill with MCP servers needs them, since mcp_servers in slackbot.skills.create takes the server_id from admin.apps.mcp.servers.permissions.list. Each pull request builds on the one before it and merges on its own, bottom to top. The stack starts on top of the Slackbot skills stack (#2831 to #2841).

  1. feat(web-api): add admin.apps.mcp.servers.list method #2849 admin.apps.mcp.servers.list 👈 this pull request
  2. feat(web-api): add admin.apps.mcp.servers.permissions.list method #2850 admin.apps.mcp.servers.permissions.list
  3. feat(web-api): add admin.apps.mcp.servers.permissions.set method #2851 admin.apps.mcp.servers.permissions.set

Testing

  1. With an org admin's user token, call client.admin.apps.mcp.servers.list({ limit: 100 }) and confirm each server has server_id, server_name, url, auth_type, app_id and app_name.
  2. Call it again with limit: 1 and confirm response_metadata.next_cursor when more servers remain.

Each layer of this stack was checked against an Enterprise developer sandbox by running every method added so far, in order, with that layer's WebClient.

Requirements

🤖 Generated with Claude Code

zimeg and others added 30 commits November 11, 2026 22:23
Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…rded java-slack-sdk sample

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…kbot-skills-info

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…ed java-slack-sdk sample

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…ot-skills-update

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…rded java-slack-sdk sample

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…kbot-skills-list

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…ed java-slack-sdk sample

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…ot-skills-library-add

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…recorded java-slack-sdk sample

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…-slackbot-skills-library-remove

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…he recorded java-slack-sdk sample

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…eat-slackbot-skills-admin-list

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…ecorded java-slack-sdk sample

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…slackbot-skills-admin-publish

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…e recorded java-slack-sdk sample

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…at-slackbot-skills-admin-set-auto-enabled

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…from the recorded java-slack-sdk sample

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
… zimeg-feat-slackbot-skills-admin-unpublish

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…the recorded java-slack-sdk sample

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
zimeg and others added 12 commits November 12, 2026 16:35
…kbot-skills-info

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…ot-skills-update

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…kbot-skills-list

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…ot-skills-library-add

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…-slackbot-skills-library-remove

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…eat-slackbot-skills-admin-list

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…slackbot-skills-admin-publish

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…at-slackbot-skills-admin-set-auto-enabled

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
… zimeg-feat-slackbot-skills-admin-unpublish

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…feat-slackbot-skills-delete

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
@zimeg
zimeg requested a review from a team as a code owner November 13, 2026 03:51
@zimeg zimeg added this to the web-api@next milestone Nov 13, 2026
@zimeg zimeg added semver:minor enhancement M-T: A feature request for new functionality area:typescript issues that specifically impact using the package from typescript projects pkg:web-api applies to `@slack/web-api` labels Nov 13, 2026
@zimeg zimeg self-assigned this Nov 13, 2026
@changeset-bot

changeset-bot Bot commented Nov 13, 2026 •

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 0a7b8e7

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
@slack/web-api Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@codecov

codecov Bot commented Nov 13, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.35%. Comparing base (5b7f2a4) to head (0a7b8e7).
✅ All tests successful. No failed tests found.

Additional details and impacted files
@@            Coverage Diff             @@
##             main    #2849      +/-   ##
==========================================
+ Coverage   94.32%   94.35%   +0.02%     
==========================================
  Files          67       67              
  Lines       10772    10786      +14     
  Branches      676      675       -1     
==========================================
+ Hits        10161    10177      +16     
+ Misses        580      579       -1     
+ Partials       31       30       -1     
Flag Coverage Δ
cli-hooks 94.25% <100.00%> (+<0.01%) ⬆️
cli-test 94.25% <100.00%> (+<0.01%) ⬆️
logger 94.25% <100.00%> (+<0.01%) ⬆️
oauth 94.25% <100.00%> (+<0.01%) ⬆️
socket-mode 94.25% <100.00%> (+<0.01%) ⬆️
web-api 94.25% <100.00%> (+<0.01%) ⬆️
webhook 94.25% <100.00%> (+<0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

🚀 New features to boost your workflow:
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

…esponse

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
Base automatically changed from zimeg-feat-slackbot-skills-delete to main November 13, 2026 07:10
@zimeg zimeg changed the title feat: add admin.apps.mcp.servers.list method feat(web-api): add admin.apps.mcp.servers.list method Nov 13, 2026
@zimeg
zimeg merged commit 899eda5 into main Nov 13, 2026
22 checks passed
@zimeg
zimeg deleted the zimeg-feat-admin-apps-mcp-servers-list branch November 13, 2026 07:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:typescript issues that specifically impact using the package from typescript projects enhancement M-T: A feature request for new functionality pkg:web-api applies to `@slack/web-api` semver:minor

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant