Phase 4: Claude plugin (.mcpb) bundle uses custom generator + workflows

[Gdewilde]

Stacked on PR #56. Final piece of Phase 4 distribution.

What was wrong

The mcpb pipeline (bun src/mcp-server/build.mts) still pointed at the legacy Speakeasy `createMCPServer`, so the bundled manifest was out of date on three counts:

1. Tool count stuck at 229 — no CRM, ATS, ecommerce, webhooks (the unified-API expansion that brought us to 330+), and zero workflow tools.
2. Schema shape was the wrapped `request` form — the same nested shape that scored D 1.9 on Glama TDQS before the schema flatten.
3. Manifest static fields were Speakeasy boilerplate — empty description, junk "Apideck: The Apideck OpenAPI Spec: SDK Optimized" long_description, no homepage / documentation / support / license URLs.

Net result: the bundled .mcpb in Claude Desktop's plugin installer would have advertised the wrong surface, with the wrong shape, with no useful metadata.

Fix

Switch the build to `createGeneratedMCPServer` in static mode so the manifest carries the real surface (335 tools = 331 endpoints + 4 workflow tools, flat schemas) and refresh the static fields.

	Before	After
Manifest version	0.1.10	0.1.13
Tool count	229	335
Workflow tools	0	apideck-month-end-close-check, apideck-pay-bill, apideck-receive-customer-payment, apideck-onboard-employee
Schema shape	wrapped `request`	flat top-level args
display_name	@apideck/mcp	Apideck Unified API
description	(empty)	"Connect agents to 200+ SaaS connectors through Apideck's Unified API."
Keywords	5 (mostly noise)	16 (apideck, unified-api, accounting, crm, hris, ats, file-storage, quickbooks, xero, salesforce, hubspot, bamboohr, workday, greenhouse, vault, oauth)
Homepage / docs / support / license	absent	github.com/apideck-libraries/mcp + MIT
user_config	minimal, lower-case titles, all optional	proper titles, sensitive flag on api_key, all required, mentions `test-consumer-id` sandbox

Output

$ npm run mcpb:build
name: @apideck/mcp
version: 0.1.13
filename: apideckmcp-0.1.13.mcpb
package size: 589.5kB
unpacked size: 3.3MB
shasum: f96133231be03b9d4343c8dd8022994741d9b4b4
total files: 2

Opens cleanly in Claude Desktop's plugin installer; reads manifest.json to wire credentials and spawn the server.

README gains a new "Claude Desktop (.mcpb plugin bundle)" section above the manual-config snippet, pointing at the build command and the GitHub Releases page (where prebuilt bundles will live going forward).

Test plan

• `npm run build` regenerates manifest with all 335 tools incl. 4 workflows
• `npm run mcpb:build` produces a 590 KB .mcpb
• All 11 unit suites still pass after the build switch
• `npm run lint` clean
• Spot-checked the manifest contents: workflow tools present, descriptions are the rich AAA-quality ones, schema is flat

Phase 4 status

• Glama AAA badge in README (already landed)
• api-skills front-door + 4 task playbooks (api-skills#3)
• Claude plugin (.mcpb) bundle ← this PR
• Blog post publish (draft in `drafts/blog-post-mcp-d-to-aaa.md`, lives outside this repo)

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
mcp-server	Ready	Preview, Comment	Apr 26, 2026 9:32am