@frontmcp/sdk

Build production-grade MCP servers in TypeScript — decorators, DI, and Streamable HTTP, batteries included.

Docs • Quickstart • SDK Reference

FrontMCP turns the Model Context Protocol into a typed, declarative framework. You write @Tool, @Resource, and @App classes; the SDK handles the protocol, transport, sessions, auth, dependency injection, and execution flow — so the same server runs on your laptop and ships to production unchanged.

Install

npx frontmcp create my-app      # scaffold a new project (recommended)
# …or add to an existing one:
npm install @frontmcp/sdk

Requires Node.js 24+. Full guide → Installation.

Quick example

import 'reflect-metadata';

import { z } from 'zod';

import { App, FrontMcp, Tool, ToolContext } from '@frontmcp/sdk';

@Tool({ name: 'greet', inputSchema: { name: z.string() } })
class GreetTool extends ToolContext {
  async execute({ name }: { name: string }) {
    return `Hello, ${name}!`;
  }
}

@App({ id: 'hello', name: 'Hello', tools: [GreetTool] })
class HelloApp {}

@FrontMcp({ info: { name: 'Demo', version: '0.1.0' }, apps: [HelloApp], http: { port: 3000 } })
export default class Server {}

Run npm run dev and point any MCP client at it. Full walkthrough → Quickstart.

What you get

• Build — @FrontMcp server, @App domains, and typed @Tool / @Resource / @Prompt primitives with Zod schemas; @Agent multi-step chains and @Provider dependency injection.  (Tools · Resources · Prompts · Agents · Providers)
• Secure — Remote & Local OAuth, JWKS, Dynamic Client Registration, per-app auth, and stateful / stateless sessions.  (Authentication)
• Speak every MCP revision — 2024-11-05 through 2026-07-28 on one endpoint, selected per request. The 2026 revision is stateless (no initialize, no session): server/discover, mirrored request headers, Multi Round-Trip Requests, the tasks extension, and subscriptions/listen are all built in, and older clients keep working unchanged.  (Protocol Versions)
• Operate — Streamable HTTP + SSE transport, capability discovery, elicitation, lifecycle hooks, and HTTP-discoverable skill manifests.  (Transport · Discovery · Elicitation · Hooks · Skills)
• Extend & embed — plugins (Cache, Remember, CodeCall, Dashboard), the OpenAPI adapter, mounting external MCP servers as sub-apps, and an in-process Direct Client (connectOpenAI / connectClaude / connectLangChain).  (Plugins · Adapters · Ext-Apps · Direct Client)
• Ship anywhere — one codebase deploys to Node, Vercel, AWS Lambda, Cloudflare Workers, or a serverless bundle.  (Deployment)

→ Everything is documented at docs.agentfront.dev/frontmcp.

Related packages

• frontmcp — the CLI: scaffolding and dev tooling (frontmcp create, dev, build)
• @frontmcp/auth — authentication, OAuth, JWKS, credential vault
• @frontmcp/adapters — OpenAPI adapter
• @frontmcp/plugins — Cache, Remember, CodeCall, Dashboard
• @frontmcp/testing — E2E testing framework
• @frontmcp/ui / @frontmcp/uipack — UI components and build tools

License

Apache-2.0