Pass request context to completion callbacks

[pragnyanramtha]

Summary

• pass ServerContext through completion/complete prompt and resource template handlers
• expose that context as an optional third argument to completion callbacks
• add integration coverage proving completers receive ctx.http.authInfo and ctx.mcpReq.signal
• add a server package changeset for the exported callback API addition

Fixes #2029.

Validation

• pnpm --filter @modelcontextprotocol/test-integration exec vitest run test/server/mcp.test.ts -t "should pass request context to"
• pnpm --filter @modelcontextprotocol/server typecheck
• pnpm --filter @modelcontextprotocol/server lint
• pnpm --filter @modelcontextprotocol/test-integration lint
• pnpm exec prettier --check packages/server/src/server/completable.ts packages/server/src/server/mcp.ts test/integration/test/server/mcp.test.ts .changeset/complete-context.md
• pnpm --filter @modelcontextprotocol/server build
• pnpm --filter @modelcontextprotocol/server test
• git diff --check

Note: the repo-wide pre-push hook was started and passed typecheck:all, but it failed outside this patch in repo-wide lint/build (test/helpers lint and packages/middleware/node build). I pushed with --no-verify after the targeted server/test-integration validation above passed.

[changeset-bot]

🦋 Changeset detected

Latest commit: 84c0323

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

This PR includes changesets to release 5 packages

Name	Type
@modelcontextprotocol/server	Minor
@modelcontextprotocol/express	Major
@modelcontextprotocol/fastify	Major
@modelcontextprotocol/hono	Major
@modelcontextprotocol/node	Major

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

[pkg-pr-new]

Open in StackBlitz

@modelcontextprotocol/client

npm i https://pkg.pr.new/@modelcontextprotocol/client@2102

@modelcontextprotocol/server

npm i https://pkg.pr.new/@modelcontextprotocol/server@2102

@modelcontextprotocol/express

npm i https://pkg.pr.new/@modelcontextprotocol/express@2102

@modelcontextprotocol/fastify

npm i https://pkg.pr.new/@modelcontextprotocol/fastify@2102

@modelcontextprotocol/hono

npm i https://pkg.pr.new/@modelcontextprotocol/hono@2102

@modelcontextprotocol/node

npm i https://pkg.pr.new/@modelcontextprotocol/node@2102

commit: 84c0323

[Copilot]

Pull request overview

This PR extends the server’s completion flow so completion/complete handlers (for both prompt argument completion and resource template variable completion) receive the request ServerContext, enabling completion providers to access ctx.http?.authInfo and observe cancellation via ctx.mcpReq.signal.

Changes:

• Thread ServerContext through the completion/complete request handler into prompt and resource template completion paths.
• Extend the exported completion callback types to accept an optional third ctx?: ServerContext argument.
• Add integration tests asserting completers receive ctx.http.authInfo and ctx.mcpReq.signal, plus a changeset for the new exported API surface.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated no comments.

File	Description
packages/server/src/server/mcp.ts	Passes ServerContext into prompt/resource completion callbacks and updates the resource template completion callback type.
packages/server/src/server/completable.ts	Updates CompleteCallback to accept an optional third ServerContext argument.
test/integration/test/server/mcp.test.ts	Adds integration coverage proving completion callbacks receive auth info and abort signal via request context.
.changeset/complete-context.md	Declares a minor version bump documenting the new optional ctx completion callback argument.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.