MCP Serverless

What is MCP Serverless?

MCP Serverless is a serverless implementation of the Model Context Protocol (MCP) architecture that enables tool management through a clean interface. It is designed for developers who need to register and manage tools, handle tool-related requests, and create in‑memory client‑server connections. The package extends requests with context to allow credential transmission from clients.

How to use MCP Serverless?

Install the package with npm (npm install @tilfin/mcp-serverless). Import ToolManager and createService from the package, create a tool manager, register tools (each with name, description, input schema, and a tool function), then create a service client and call client.listTools() or client.callTool(). Context (e.g., an API key) can be passed in the ctx property of the tool call arguments.

Key features of MCP Serverless

• Register and manage multiple tools with a single manager
• Call tools with or without a request context object
• Create in‑memory client‑server connections (no network needed)
• Extend tool calls with context for credential transmission
• Works with standard I/O transports (stdio client/server)

Use cases of MCP Serverless

• Building serverless MCP tool endpoints that run in edge functions or AWS Lambda
• Testing tool workflows locally without a full MCP server deployment
• Securely passing API keys or user tokens to tool implementations via context
• Creating lightweight, transport‑agnostic tool registries for AI assistants