Skip to content
Back to search

frontmcp

TypeScript-first framework for the Model Context Protocol (MCP). You write clean, typed code; FrontMCP handles the protocol, transport, DI, session/auth, and execution flow.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/agentfront/frontmcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/agentfront/frontmcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/agentfront--frontmcp/badge.svg)](/listings/agentfront--frontmcp)

HTML

<a href="/listings/agentfront--frontmcp"><img src="/api/listings/agentfront--frontmcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 164 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <a href="https://frontmcp.dev">
  3. <picture>
  4. <source media="(prefers-color-scheme: dark)" srcset=".github/assets/readme/hero.svg">
  5. <img src=".github/assets/readme/hero.light.svg" alt="FrontMCP - The TypeScript way to build MCP servers" width="100%">
  6. </picture>
  7. </a>
  8. [![NPM](https://img.shields.io/npm/v/@frontmcp/sdk.svg?style=flat-square&color=16A34A&labelColor=0b1117&label=npm)](https://www.npmjs.com/package/@frontmcp/sdk)
  9. [![Node](https://img.shields.io/badge/node-%E2%89%A5%2024-16A34A?style=flat-square&labelColor=0b1117&logo=node.js&logoColor=white)](https://nodejs.org)
  10. [![License](https://img.shields.io/github/license/agentfront/frontmcp.svg?style=flat-square&color=16A34A&labelColor=0b1117)](./LICENSE)
  11. [![Snyk](https://img.shields.io/badge/snyk-monitored-16A34A?style=flat-square&labelColor=0b1117&logo=snyk&logoColor=white)](https://snyk.io/test/github/agentfront/frontmcp)
  12. [![Discord](https://img.shields.io/badge/discord-join-16A34A?style=flat-square&labelColor=0b1117&logo=discord&logoColor=white)](https://discord.gg/53AHnJnmwR)
  13. [![FrontMCP docs MCP connector – tool definition quality and endpoint health on Glama](https://glama.ai/mcp/connectors/dev.frontmcp.mcp/frontmcp/badges/score.svg)](https://glama.ai/mcp/connectors/dev.frontmcp.mcp/frontmcp)
  14. **[frontmcp.dev](https://frontmcp.dev)** &nbsp;&middot;&nbsp; **[Learn][docs-learn]** &nbsp;&middot;&nbsp; **[Reference][docs-reference]** &nbsp;&middot;&nbsp; **[Examples][docs-examples]** &nbsp;&middot;&nbsp; **[Playground][docs-playground]** &nbsp;&middot;&nbsp; **[Compare][docs-compare]** &nbsp;&middot;&nbsp; **[Blog][docs-blog]**
  15. <picture>
  16. <source media="(prefers-color-scheme: dark)" srcset=".github/assets/readme/terminal.svg">
  17. <img src=".github/assets/readme/terminal.light.svg" alt="npx frontmcp create my-app, then npm run dev: an MCP server running on localhost:3000" width="760">
  18. </picture>
  19. </div>
  20. <br>
  21. **FrontMCP is the TypeScript framework for MCP servers.** You write tools, resources and prompts as typed classes with Zod schemas, and FrontMCP serves them over the Model Context Protocol, with dependency injection, authentication, testing, agents and jobs, on Node, Vercel, AWS Lambda and Cloudflare Workers. It serves MCP 2026-07-28, the stateless revision, and the earlier ones. The docs, examples and a browser playground are at [frontmcp.dev](https://frontmcp.dev).
  22. ## Write a tool. Ship a server.
  23. Classes in, protocol out. FrontMCP handles transport, DI, sessions, auth and execution flow, and the same server runs locally and in production unchanged.
  24. ```ts
  25. import 'reflect-metadata';
  26. import { App, FrontMcp, Tool, ToolContext, z } from '@frontmcp/sdk';
  27. @Tool({
  28. name: 'add',
  29. description: 'Adds two numbers together',
  30. inputSchema: { a: z.number(), b: z.number() },
  31. })
  32. class AddTool extends ToolContext {
  33. async execute(input: { a: number; b: number }) {
  34. return input.a + input.b;
  35. }
  36. }
  37. @App({ id: 'calc', name: 'Calculator', tools: [AddTool] })
  38. class CalcApp {}
  39. @FrontMcp({
  40. info: { name: 'Demo', version: '0.1.0' },
  41. apps: [CalcApp],
  42. http: { port: 3000 },
  43. })
  44. export default class Server {}
  45. ```
  46. <div align="center">
  47. <picture>
  48. <source media="(prefers-color-scheme: dark)" srcset=".github/assets/readme/features.svg">
  49. <img src=".github/assets/readme/features.light.svg" alt="Typed end to end, auth built in, ship anywhere, every stage is a hook, tools with a face, one endpoint for any client" width="100%">
  50. </picture>
  51. </div>
  52. <br>
  53. ## Start
  54. ```bash
  55. npx frontmcp create my-app # new project (Node 24+)
  56. npx frontmcp init # or add FrontMCP to an existing one
  57. ```
  58. Then follow **[Learn][docs-learn]** on [frontmcp.dev](https://frontmcp.dev), or browse [Tools][docs-tools], [Resources][docs-resources], [Prompts][docs-prompts], [Agents][docs-agents], [Auth][docs-auth], [Plugins][docs-plugins], [Tool UI][docs-ext-apps], [Testing][docs-testing] and [Deployment][docs-deploy]. Try it live in the [Playground][docs-playground].
  59. ## How it compares
  60. [TypeScript MCP server frameworks for production][docs-compare] puts FrontMCP next to [the official TypeScript SDK][compare-sdk], [FastMCP for TypeScript][compare-fastmcp], [Prefect's FastMCP TypeScript][compare-fastmcp-ts], [mcp-framework][compare-mcp-framework], [mcp-use][compare-mcp-use], [ViteMCP][compare-vitemcp] and [xmcp][compare-xmcp], on auth, testing, protocol support and deployment. Each library's hello world was run and asked which MCP revisions it serves. [Why FrontMCP][compare-why] says when the official SDK alone is enough, and [The Best TypeScript MCP Server Frameworks in 2026][blog-best-frameworks] sums up the field. Moving a server over? See [Migrate from the TypeScript SDK][migrate-sdk] and [Migrate from FastMCP][migrate-fastmcp].
  61. ## Packages
  62. Install `frontmcp` (CLI) and `@frontmcp/sdk`. The rest is pulled in for you, or opt-in. Keep every `@frontmcp/*` package on the same version: they depend on each other at exact versions.
  63. <details>
  64. <summary><b>Core and extensions</b></summary>
  65. <br>
  66. | Package | What it does |
  67. | --------------------------------------------------- | --------------------------------------------------------------- |
  68. | [`frontmcp`](libs/cli) | CLI: `create`, `init`, `dev`, `build`, `test`, `inspector` |
  69. | [`@frontmcp/sdk`](libs/sdk) | Core framework: decorators, DI, flows, transport, MCP protocol |
  70. | [`@frontmcp/auth`](libs/auth) | OAuth, JWKS, DCR/CIMD, sessions, credential vault |
  71. | [`@frontmcp/testing`](libs/testing) | E2E test framework with fixtures and matchers |
  72. | [`@frontmcp/adapters`](libs/adapters) | Generate tools from an OpenAPI spec |
  73. | [`@frontmcp/skills`](libs/skills) | Curated `SKILL.md` catalog for scaffolding and `skills install` |
  74. | [`@frontmcp/guard`](libs/guard) | Rate limits, concurrency and policy guards |
  75. | [`@frontmcp/observability`](libs/observability) | Structured logging, metrics and tracing |
  76. | [`@frontmcp/react`](libs/react) | React hooks and client for a FrontMCP server |
  77. | [`@frontmcp/ui`](libs/ui) / [`uipack`](libs/uipack) | Widgets, SSR renderers, MCP Bridge, themes |
  78. | [`@frontmcp/edge`](libs/edge) | Run a server on Cloudflare Workers / V8 isolates |
  79. | [`@frontmcp/storage-sqlite`](libs/storage-sqlite) | SQLite session, task and elicitation stores |
  80. | [`@frontmcp/nx`](libs/nx-plugin) | Nx generators and executors |
  81. Internal, published so the above resolve: [`protocol`](libs/protocol), [`di`](libs/di), [`utils`](libs/utils), [`lazy-zod`](libs/lazy-zod).
  82. </details>
  83. <details>
  84. <summary><b>Official plugins</b></summary>
  85. <br>
  86. | Package | What it does |
  87. | -------------------------------------------------------------------- | ----------------------------------------------- |
  88. | [`@frontmcp/plugin-cache`](plugins/plugin-cache) | Cache tool results with a TTL |
  89. | [`@frontmcp/plugin-remember`](plugins/plugin-remember) | Per-session memory (`this.remember`) |
  90. | [`@frontmcp/plugin-result-handles`](plugins/plugin-result-handles) | Fold large answers into a handle to query |
  91. | [`@frontmcp/plugin-approval`](plugins/plugin-approval) | Human approval gates before a tool runs |
  92. | [`@frontmcp/plugin-codecall`](plugins/plugin-codecall) | Let the model compose tool calls as code |
  93. | [`@frontmcp/plugin-dashboard`](plugins/plugin-dashboard) | Built-in web dashboard |
  94. | [`@frontmcp/plugin-feature-flags`](plugins/plugin-feature-flags) | Toggle tools and apps at runtime |
  95. | [`@frontmcp/plugin-skilled-openapi`](plugins/plugin-skilled-openapi) | OpenAPI to skills and meta-tools for big APIs |
  96. | [`@frontmcp/plugin-webmcp`](plugins/plugin-webmcp) | Expose in-page tools to browser agents (WebMCP) |
  97. </details>
  98. <br>
  99. <div align="center">
  100. PRs welcome: see [CONTRIBUTING](./CONTRIBUTING.md). Released under the [Apache-2.0](./LICENSE) license.
  101. </div>
  102. <!-- docs links -->
  103. [docs-learn]: https://frontmcp.dev/learn 'Learn FrontMCP'
  104. [docs-reference]: https://frontmcp.dev/reference 'Reference'
  105. [docs-examples]: https://frontmcp.dev/examples 'Examples'
  106. [docs-playground]: https://frontmcp.dev/playground 'Playground'
  107. [docs-blog]: https://frontmcp.dev/blog 'Blog'
  108. [docs-compare]: https://frontmcp.dev/compare 'TypeScript MCP server frameworks compared'
  109. [compare-sdk]: https://frontmcp.dev/compare/official-typescript-sdk 'FrontMCP vs the official MCP TypeScript SDK'
  110. [compare-fastmcp]: https://frontmcp.dev/compare/fastmcp-typescript 'FrontMCP vs FastMCP for TypeScript'
  111. [compare-fastmcp-ts]: https://frontmcp.dev/compare/fastmcp-ts "FrontMCP vs Prefect's FastMCP TypeScript"
  112. [compare-mcp-framework]: https://frontmcp.dev/compare/mcp-framework 'FrontMCP vs mcp-framework'
  113. [compare-mcp-use]: https://frontmcp.dev/compare/mcp-use 'FrontMCP vs mcp-use'
  114. [compare-vitemcp]: https://frontmcp.dev/compare/vitemcp 'FrontMCP vs ViteMCP'
  115. [compare-xmcp]: https://frontmcp.dev/compare/xmcp 'FrontMCP vs xmcp'
  116. [compare-why]: https://frontmcp.dev/compare/why-frontmcp 'Why FrontMCP'
  117. [blog-best-frameworks]: https://frontmcp.dev/blog/best-typescript-mcp-frameworks 'The Best TypeScript MCP Server Frameworks in 2026'
  118. [migrate-sdk]: https://frontmcp.dev/learn/migrating-from-the-typescript-sdk 'Migrate from the TypeScript SDK'
  119. [migrate-fastmcp]: https://frontmcp.dev/learn/migrating-from-fastmcp 'Migrate from FastMCP'
  120. [docs-tools]: https://frontmcp.dev/reference/sdk/tool 'Tools'
  121. [docs-resources]: https://frontmcp.dev/reference/sdk/resource 'Resources'
  122. [docs-prompts]: https://frontmcp.dev/reference/sdk/prompt 'Prompts'
  123. [docs-agents]: https://frontmcp.dev/reference/sdk/agent 'Agents'
  124. [docs-auth]: https://frontmcp.dev/reference/auth/modes 'Authentication'
  125. [docs-ext-apps]: https://frontmcp.dev/learn/tools-with-a-ui 'Tool UI / MCP Apps'
  126. [docs-plugins]: https://frontmcp.dev/reference/plugins 'Plugins'
  127. [docs-testing]: https://frontmcp.dev/reference/testing 'Testing'
  128. [docs-deploy]: https://frontmcp.dev/reference/deployment/node 'Deployment'

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.