Skip to content

feat(methods): add admin.apps.mcp.servers.list method example - #380

Merged
zimeg merged 87 commits into
mainfrom
zimeg-feat-admin-apps-mcp-servers-examples-list
Nov 14, 2026
Merged

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

Conversation

@zimeg

@zimeg zimeg commented Nov 13, 2026 •

Copy link
Copy Markdown
Member

Summary

This pull request adds a method example for admin.apps.mcp.servers.list in methods/src/admin/apps/mcp/servers/admin_apps_mcp_servers_list.py, and lists it in methods/README.md.

  • The arguments follow the order of the reference page.
  • This layer also adds the admin/apps/mcp/servers/ app scaffold. Admin methods need a user token from an org-level install.
  • The example leaves out cursor, which only applies when continuing from a previous page.

This is part 1 of 3 in a stack that adds the admin.apps.mcp.servers method examples one at a time. A Slackbot skill with MCP servers takes its 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 sits on top of #379, the last layer of the Slackbot skills examples.

  1. feat(methods): add admin.apps.mcp.servers.list method example #380 admin.apps.mcp.servers.list 👈 this pull request
  2. feat(methods): add admin.apps.mcp.servers.permissions.list method example #381 admin.apps.mcp.servers.permissions.list
  3. feat(methods): add admin.apps.mcp.servers.permissions.set method example #382 admin.apps.mcp.servers.permissions.set

Dependency: stays a draft

This depends on slackapi/python-slack-sdk#2032, which adds admin.apps.mcp.servers.list to slack_sdk. The methods type check fails against the currently pinned slack_sdk until that ships in a release. This PR stays a draft until then, and the slack_sdk pin gets bumped to that release before it merges.

Testing

With slackapi/python-slack-sdk#2032 installed locally:

  1. cd methods/src/admin/apps/mcp/servers && slack install --environment local, then export SLACK_TOKEN=... with the app's user token (admin.apps:read).
  2. slack run admin_apps_mcp_servers_list.py and confirm the response.

Each layer of this stack was run live against an Enterprise developer sandbox with its matching slack_sdk layer installed.

🤖 Generated with Claude Code

zimeg and others added 30 commits November 11, 2026 20:09
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>
…e page does

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…e page does

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…page does

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…imeg-feat-slackbot-skills-examples-library-remove
…o zimeg-feat-slackbot-skills-examples-admin-list
…rence page does

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…meg-feat-slackbot-skills-examples-admin-publish
… zimeg-feat-slackbot-skills-examples-admin-set-auto-enabled
…s the reference page does

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…led' into zimeg-feat-slackbot-skills-examples-admin-unpublish
…to zimeg-feat-slackbot-skills-examples-delete
Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
zimeg and others added 11 commits November 13, 2026 11:33
…led' into zimeg-feat-slackbot-skills-examples-admin-unpublish
…to zimeg-feat-slackbot-skills-examples-delete
….list example

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…meg-feat-slackbot-skills-examples-admin-publish
… zimeg-feat-slackbot-skills-examples-admin-set-auto-enabled
…led' into zimeg-feat-slackbot-skills-examples-admin-unpublish
…to zimeg-feat-slackbot-skills-examples-delete
…s.list example

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…kills-examples-admin-list

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

@mwbrooks mwbrooks left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Thanks @zimeg! Calling it with no arguments keeps the example in step with the docs payload.

zimeg and others added 12 commits November 13, 2026 15:31
…t example

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
…les-admin-list' into zimeg-feat-slackbot-skills-examples-admin-publish
… zimeg-feat-slackbot-skills-examples-admin-set-auto-enabled
…led' into zimeg-feat-slackbot-skills-examples-admin-unpublish
…to zimeg-feat-slackbot-skills-examples-delete
…feat-admin-apps-mcp-servers-examples-list

# Conflicts:
#	methods/README.md
…t readme entry

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

# Conflicts:
#	methods/README.md
… zimeg-feat-slackbot-skills-examples-admin-set-auto-enabled
…led' into zimeg-feat-slackbot-skills-examples-admin-unpublish
…to zimeg-feat-slackbot-skills-examples-delete
@zimeg zimeg changed the title feat: add admin.apps.mcp.servers.list method example feat(methods): add admin.apps.mcp.servers.list method example Nov 14, 2026
@zimeg
zimeg changed the base branch from zimeg-feat-slackbot-skills-examples-delete to main November 14, 2026 00:55
…-mcp-servers-examples-list

Co-Authored-By: Claude <svc-devxp-claude@slack-corp.com>
@zimeg

zimeg commented Nov 14, 2026

Copy link
Copy Markdown
Member Author

🔌 Thanks for the kind review @mwbrooks! admin.apps.mcp.servers.list is in, along with the admin/apps/mcp/servers/ scaffold.

@zimeg
zimeg merged commit c69442b into main Nov 14, 2026
16 checks passed
@zimeg
zimeg deleted the zimeg-feat-admin-apps-mcp-servers-examples-list branch November 14, 2026 01:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request python Pull requests that update python code

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants