Skip to content

List every registered tool in the MCP server card - #588

Merged
kvz merged 1 commit into
mainfrom
card-lists-tools
Oct 18, 2026
Merged

kvz merged 1 commit into
mainfrom
card-lists-tools

Conversation

@kvz

@kvz kvz commented Oct 18, 2026

Copy link
Copy Markdown
Member

Why

@transloadit/mcp-server 0.7.0 changed the server card to tools: ['dynamic']. Smithery, other directories and our monitoring read the card's tool list, so the hosted server would advertise no tools once 0.7.0 is deployed. The Builtin shortcut tools come from the static mcpBuiltinTemplateManifest, so the card can list them alongside the core tools.

What

  • createTransloaditMcpServer() records each tool it registers (RegisteredTool returned by registerTool()), exposed through listOwnTools(server).
  • buildServerCard() builds a throwaway server and maps that registry to the 0.6.x card shape (name, title, description, inputSchema, annotations, securitySchemes), converting input schemas with the SDK's own toJsonSchemaCompat options. The card now lists 17 tools: 8 core tools plus 9 Builtin shortcuts. Signature unchanged.
  • Shortcut inputSchemas on the card are the static ones tools/list serves before an authenticated catalog narrows fields.
  • New test in tool-surface.test.ts: card tool names, schemas, annotations and security schemes equal what tools/list serves for every registered tool (catalog read failing, so no shortcut is filtered), and the card is not ['dynamic']. Hosted/self-hosted card tests get their 0.6.x securitySchemes assertions back.
  • Patch changeset, so this releases as 0.7.1.

Checks

yarn workspace @transloadit/mcp-server test:unit (254 passed), lint:ts, test/e2e/server-card.test.ts, yarn lint:js, lint:changesets, lint:deps, knip.

🤖 Claimed by kvz on framework1/node-sdk since 2026-10-18 · resume: claude --resume 26eaa88e-b3fa-4cc1-bcce-0c7ff5b6bab7

0.7.0 advertised `tools: ['dynamic']`, so directories and monitoring that
read the card would see no tools. Derive the card from the registry that
createTransloaditMcpServer() fills, so the 8 core tools and the 9 Builtin
shortcuts are listed with the same schemas tools/list serves.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@kvz
kvz merged commit fc32f2e into main Oct 18, 2026
15 of 16 checks passed
@kvz
kvz deleted the card-lists-tools branch October 18, 2026 18:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant