FrontMCP MCP server

Q: How do I add FrontMCP MCP to Claude Code?

Run `claude mcp add frontmcp -- npx -y @frontmcp/adapters` in your terminal. Add `--scope user` to make it available in every project.

Q: How do I add FrontMCP MCP to Cursor?

Open `~/.cursor/mcp.json` and add the server under `mcpServers`, using the Cursor config shown in the install section above.

✓ VerifiedCommit Nov 14, 2026

agentfront/frontmcp · typescript · Apache-2.0

Builds TypeScript MCP servers with typed tools, dependency injection, authentication, testing and deployment to Node, Vercel, Lambda or Workers.

Also known as agentfront/frontmcp, @frontmcp/adapters, @frontmcp/auth, @frontmcp/edge, @frontmcp/guard

stdio Developer Tools AI & LLM Tools DevOps & Infrastructure

Install GitHub ↗

Stars: 152
Tools: —
Downloads, 30 days: 220,205
Latest version: —
Last commit: Nov 14, 2026
License: Apache-2.0

What is FrontMCP MCP?

FrontMCP builds TypeScript MCP servers with typed tools, dependency injection, authentication, testing and deployment to Node, Vercel, Lambda or Workers.

Summary generated from the project's README

About FrontMCP MCP server

Building production-ready TypeScript MCP servers is the primary function of this framework. It allows developers to define tools, resources, and prompts using typed classes and Zod schemas, which are then served over the Model Context Protocol. The system handles complex requirements like dependency injection, authentication, and execution flow, ensuring that the same code runs on a local machine or in a production environment without modification.

Developers can deploy their servers to various environments including Node, Vercel, AWS Lambda, or Cloudflare Workers. The ecosystem includes specialized packages for advanced features such as OAuth, rate limiting with guard, and structured observability. It supports both the stateless 2026-07-28 revision and earlier versions of the protocol, making it a versatile choice for creating scalable agentic tools.

What you can do with it

1Scaffold a new projectA developer can quickly initialize a new MCP server project using the command line interface.
2Create typed toolsYou can define mathematical or logic tools using TypeScript classes and Zod for input validation.
3Deploy to edge functionsThe framework enables running servers on lightweight edge environments like Cloudflare Workers.
4Implement human approvalDevelopers can add gates that require a person to approve a tool execution before it runs.

Written from the project's README. Every use case is checked against a quote from it.

How to install FrontMCP MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add frontmcp -- npx -y @frontmcp/adapters

~/.cursor/mcp.json

{
  "mcpServers": {
    "frontmcp": {
      "command": "npx",
      "args": [
        "-y",
        "@frontmcp/adapters"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "frontmcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@frontmcp/adapters"
      ]
    }
  }
}

$ code --add-mcp '{"name":"frontmcp","type":"stdio","command":"npx","args":["-y","@frontmcp/adapters"]}'

claude_desktop_config.json

{
  "mcpServers": {
    "frontmcp": {
      "command": "npx",
      "args": [
        "-y",
        "@frontmcp/adapters"
      ]
    }
  }
}

$ codex mcp add frontmcp -- npx -y @frontmcp/adapters

~/.codex/config.toml

[mcp_servers.frontmcp]
command = "npx"
args = ["-y", "@frontmcp/adapters"]

$ gemini mcp add -s user frontmcp npx -- -y @frontmcp/adapters

~/.gemini/settings.json

{
  "mcpServers": {
    "frontmcp": {
      "command": "npx",
      "args": [
        "-y",
        "@frontmcp/adapters"
      ]
    }
  }
}

No environment variables or API keys required.Setup guides:Claude Code Cursor VS Code Claude Desktop

Automated checks

Ran Nov 12, 2026Full report →

100/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work

Show this score in your README

Source repository linked and reachablePass
Open source license (OSI)Pass
Commit or release in the last yearPass
Package name not close to a popular packagePass
Remote endpoint uses HTTPSNot checked
Destructive tools are labelledNot checked
No hidden instructions to the modelPass
No critical advisory in the package or its dependenciesNot checked

README

View on GitHub

frontmcp.dev · Learn · Reference · Examples · Playground · Compare · Blog

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.

Write a tool. Ship a server.

Classes in, protocol out. FrontMCP handles transport, DI, sessions, auth and execution flow, and the same server runs locally and in production unchanged.

import 'reflect-metadata';

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

@Tool({
  name: 'add',
  description: 'Adds two numbers together',
  inputSchema: { a: z.number(), b: z.number() },
})
class AddTool extends ToolContext {
  async execute(input: { a: number; b: number }) {
    return input.a + input.b;
  }
}

@App({ id: 'calc', name: 'Calculator', tools: [AddTool] })
class CalcApp {}

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

Start

npx frontmcp create my-app        # new project (Node 24+)
npx frontmcp init                 # or add FrontMCP to an existing one

Then follow Learn on frontmcp.dev, or browse Tools, Resources, Prompts, Agents, Auth, Plugins, Tool UI, Testing and Deployment. Try it live in the Playground.

How it compares

TypeScript MCP server frameworks for production puts FrontMCP next to the official TypeScript SDK, FastMCP for TypeScript, Prefect's FastMCP TypeScript, mcp-framework, mcp-use, ViteMCP and xmcp, on auth, testing, protocol support and deployment. Each library's hello world was run and asked which MCP revisions it serves. Why FrontMCP says when the official SDK alone is enough, and The Best TypeScript MCP Server Frameworks in 2026 sums up the field. Moving a server over? See Migrate from the TypeScript SDK and Migrate from FastMCP.

Packages

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.

Package	What it does
`frontmcp`	CLI: `create`, `init`, `dev`, `build`, `test`, `inspector`
`@frontmcp/sdk`	Core framework: decorators, DI, flows, transport, MCP protocol
`@frontmcp/auth`	OAuth, JWKS, DCR/CIMD, sessions, credential vault
`@frontmcp/testing`	E2E test framework with fixtures and matchers
`@frontmcp/adapters`	Generate tools from an OpenAPI spec
`@frontmcp/skills`	Curated `SKILL.md` catalog for scaffolding and `skills install`
`@frontmcp/guard`	Rate limits, concurrency and policy guards
`@frontmcp/observability`	Structured logging, metrics and tracing
`@frontmcp/react`	React hooks and client for a FrontMCP server
`@frontmcp/ui` / `uipack`	Widgets, SSR renderers, MCP Bridge, themes
`@frontmcp/edge`	Run a server on Cloudflare Workers / V8 isolates
`@frontmcp/storage-sqlite`	SQLite session, task and elicitation stores
`@frontmcp/nx`	Nx generators and executors

Internal, published so the above resolve: protocol, di, utils, lazy-zod.

Package	What it does
`@frontmcp/plugin-cache`	Cache tool results with a TTL
`@frontmcp/plugin-remember`	Per-session memory (`this.remember`)
`@frontmcp/plugin-result-handles`	Fold large answers into a handle to query
`@frontmcp/plugin-approval`	Human approval gates before a tool runs
`@frontmcp/plugin-codecall`	Let the model compose tool calls as code
`@frontmcp/plugin-dashboard`	Built-in web dashboard
`@frontmcp/plugin-feature-flags`	Toggle tools and apps at runtime
`@frontmcp/plugin-skilled-openapi`	OpenAPI to skills and meta-tools for big APIs
`@frontmcp/plugin-webmcp`	Expose in-page tools to browser agents (WebMCP)

PRs welcome: see CONTRIBUTING. Released under the Apache-2.0 license.

Read full README

FrontMCP MCP questions

How do I add FrontMCP MCP to Claude Code?

Run claude mcp add frontmcp -- npx -y @frontmcp/adapters in your terminal. Add --scope user to make it available in every project.

How do I add FrontMCP MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What is FrontMCP?

FrontMCP is a TypeScript framework for building MCP servers. You define tools, resources and prompts as typed classes with Zod schemas, and FrontMCP serves them over the Model Context Protocol.

How do I create a new FrontMCP project?

Run npx frontmcp create my-app to scaffold a new project, or npx frontmcp init to add FrontMCP to an existing one. It requires Node 24 or later.

Where can I deploy a FrontMCP server?

The same server runs on Node.js, Vercel, AWS Lambda and Cloudflare Workers. An edge package supports Cloudflare Workers and V8 isolates.

Does FrontMCP support authentication?

Yes. The @frontmcp/auth package provides OAuth, JWKS, DCR/CIMD, sessions and a credential vault.

Can I test a FrontMCP server?

Yes, @frontmcp/testing provides an end-to-end test framework with fixtures and matchers, and the CLI includes a test command.

Facts

Nov 15, 2026

Stars: 152
Downloads, 30 days: 220,205
Latest version: —
Last commit: Nov 14, 2026
License: Apache-2.0
Transport: stdio
Package: @frontmcp/adapters

agentfront ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/agentfront/frontmcp.svg)](https://hostedmcp.org/servers/agentfront/frontmcp/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

FrontMCP MCP server

✓ VerifiedCommit Nov 14, 2026

agentfront/frontmcp · typescript · Apache-2.0

Builds TypeScript MCP servers with typed tools, dependency injection, authentication, testing and deployment to Node, Vercel, Lambda or Workers.

Also known as agentfront/frontmcp, @frontmcp/adapters, @frontmcp/auth, @frontmcp/edge, @frontmcp/guard

stdio Developer Tools AI & LLM Tools DevOps & Infrastructure

Install GitHub ↗

Stars: 152
Tools: —
Downloads, 30 days: 220,205
Latest version: —
Last commit: Nov 14, 2026
License: Apache-2.0

What is FrontMCP MCP?

FrontMCP builds TypeScript MCP servers with typed tools, dependency injection, authentication, testing and deployment to Node, Vercel, Lambda or Workers.

Summary generated from the project's README

About FrontMCP MCP server

What you can do with it

1Scaffold a new projectA developer can quickly initialize a new MCP server project using the command line interface.
2Create typed toolsYou can define mathematical or logic tools using TypeScript classes and Zod for input validation.
3Deploy to edge functionsThe framework enables running servers on lightweight edge environments like Cloudflare Workers.
4Implement human approvalDevelopers can add gates that require a person to approve a tool execution before it runs.

Written from the project's README. Every use case is checked against a quote from it.

How to install FrontMCP MCP

Formats verified 10 Nov 2026Add to Cursor Add to Goose

Claude CodeCursorVS CodeVS Code CLIClaude DesktopCodexCodex config.tomlGemini CLIGemini settings.json

$ claude mcp add frontmcp -- npx -y @frontmcp/adapters

~/.cursor/mcp.json

{
  "mcpServers": {
    "frontmcp": {
      "command": "npx",
      "args": [
        "-y",
        "@frontmcp/adapters"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "frontmcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@frontmcp/adapters"
      ]
    }
  }
}

$ code --add-mcp '{"name":"frontmcp","type":"stdio","command":"npx","args":["-y","@frontmcp/adapters"]}'

claude_desktop_config.json

{
  "mcpServers": {
    "frontmcp": {
      "command": "npx",
      "args": [
        "-y",
        "@frontmcp/adapters"
      ]
    }
  }
}

$ codex mcp add frontmcp -- npx -y @frontmcp/adapters

~/.codex/config.toml

[mcp_servers.frontmcp]
command = "npx"
args = ["-y", "@frontmcp/adapters"]

$ gemini mcp add -s user frontmcp npx -- -y @frontmcp/adapters

~/.gemini/settings.json

{
  "mcpServers": {
    "frontmcp": {
      "command": "npx",
      "args": [
        "-y",
        "@frontmcp/adapters"
      ]
    }
  }
}

No environment variables or API keys required.Setup guides:Claude Code Cursor VS Code Claude Desktop

Automated checks

Ran Nov 12, 2026Full report →

100/100

Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work

Show this score in your README

Source repository linked and reachablePass
Open source license (OSI)Pass
Commit or release in the last yearPass
Package name not close to a popular packagePass
Remote endpoint uses HTTPSNot checked
Destructive tools are labelledNot checked
No hidden instructions to the modelPass
No critical advisory in the package or its dependenciesNot checked

README

View on GitHub

frontmcp.dev · Learn · Reference · Examples · Playground · Compare · Blog

Write a tool. Ship a server.

Classes in, protocol out. FrontMCP handles transport, DI, sessions, auth and execution flow, and the same server runs locally and in production unchanged.

import 'reflect-metadata';

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

@Tool({
  name: 'add',
  description: 'Adds two numbers together',
  inputSchema: { a: z.number(), b: z.number() },
})
class AddTool extends ToolContext {
  async execute(input: { a: number; b: number }) {
    return input.a + input.b;
  }
}

@App({ id: 'calc', name: 'Calculator', tools: [AddTool] })
class CalcApp {}

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

Start

npx frontmcp create my-app        # new project (Node 24+)
npx frontmcp init                 # or add FrontMCP to an existing one

Then follow Learn on frontmcp.dev, or browse Tools, Resources, Prompts, Agents, Auth, Plugins, Tool UI, Testing and Deployment. Try it live in the Playground.

How it compares

Packages

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.

Package	What it does
`frontmcp`	CLI: `create`, `init`, `dev`, `build`, `test`, `inspector`
`@frontmcp/sdk`	Core framework: decorators, DI, flows, transport, MCP protocol
`@frontmcp/auth`	OAuth, JWKS, DCR/CIMD, sessions, credential vault
`@frontmcp/testing`	E2E test framework with fixtures and matchers
`@frontmcp/adapters`	Generate tools from an OpenAPI spec
`@frontmcp/skills`	Curated `SKILL.md` catalog for scaffolding and `skills install`
`@frontmcp/guard`	Rate limits, concurrency and policy guards
`@frontmcp/observability`	Structured logging, metrics and tracing
`@frontmcp/react`	React hooks and client for a FrontMCP server
`@frontmcp/ui` / `uipack`	Widgets, SSR renderers, MCP Bridge, themes
`@frontmcp/edge`	Run a server on Cloudflare Workers / V8 isolates
`@frontmcp/storage-sqlite`	SQLite session, task and elicitation stores
`@frontmcp/nx`	Nx generators and executors

Internal, published so the above resolve: protocol, di, utils, lazy-zod.

Package	What it does
`@frontmcp/plugin-cache`	Cache tool results with a TTL
`@frontmcp/plugin-remember`	Per-session memory (`this.remember`)
`@frontmcp/plugin-result-handles`	Fold large answers into a handle to query
`@frontmcp/plugin-approval`	Human approval gates before a tool runs
`@frontmcp/plugin-codecall`	Let the model compose tool calls as code
`@frontmcp/plugin-dashboard`	Built-in web dashboard
`@frontmcp/plugin-feature-flags`	Toggle tools and apps at runtime
`@frontmcp/plugin-skilled-openapi`	OpenAPI to skills and meta-tools for big APIs
`@frontmcp/plugin-webmcp`	Expose in-page tools to browser agents (WebMCP)

PRs welcome: see CONTRIBUTING. Released under the Apache-2.0 license.

Read full README

FrontMCP MCP questions

How do I add FrontMCP MCP to Claude Code?

Run claude mcp add frontmcp -- npx -y @frontmcp/adapters in your terminal. Add --scope user to make it available in every project.

How do I add FrontMCP MCP to Cursor?

Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.

What is FrontMCP?

FrontMCP is a TypeScript framework for building MCP servers. You define tools, resources and prompts as typed classes with Zod schemas, and FrontMCP serves them over the Model Context Protocol.

How do I create a new FrontMCP project?

Run npx frontmcp create my-app to scaffold a new project, or npx frontmcp init to add FrontMCP to an existing one. It requires Node 24 or later.

Where can I deploy a FrontMCP server?

The same server runs on Node.js, Vercel, AWS Lambda and Cloudflare Workers. An edge package supports Cloudflare Workers and V8 isolates.

Does FrontMCP support authentication?

Yes. The @frontmcp/auth package provides OAuth, JWKS, DCR/CIMD, sessions and a credential vault.

Can I test a FrontMCP server?

Yes, @frontmcp/testing provides an end-to-end test framework with fixtures and matchers, and the CLI includes a test command.

Facts

Nov 15, 2026

Stars: 152
Downloads, 30 days: 220,205
Latest version: —
Last commit: Nov 14, 2026
License: Apache-2.0
Transport: stdio
Package: @frontmcp/adapters

agentfront ↗

Community publisher

Published by an independent maintainer.

Alternatives

Works with

Claude Code Cursor VS Code Claude Desktop Codex Gemini CLI Windsurf Devin

Badge for your README

Show your HostedMCP checks score. The badge links readers to install instructions for every client.

[![HostedMCP checks](https://api.hostedmcp.org/v1/badge/server/agentfront/frontmcp.svg)](https://hostedmcp.org/servers/agentfront/frontmcp/checks)

Maintainer?

Claim this listing to edit it and add the HostedMCP badge to your README.

Claim listing

Before you install

Servers run with the permissions you give them. Use the narrowest token or database role that does the job.

FrontMCP MCP server

What is FrontMCP MCP?

About FrontMCP MCP server

What you can do with it

How to install FrontMCP MCP

Install FrontMCP MCP in Claude Code

Install FrontMCP MCP in Cursor

Install FrontMCP MCP in VS Code

Install FrontMCP MCP in VS Code CLI

Install FrontMCP MCP in Claude Desktop

Install FrontMCP MCP in Codex

Install FrontMCP MCP in Codex config.toml

Install FrontMCP MCP in Gemini CLI

Install FrontMCP MCP in Gemini settings.json

Automated checks

README

Write a tool. Ship a server.

Start

How it compares

Packages

FrontMCP MCP questions

FrontMCP MCP server

What is FrontMCP MCP?

About FrontMCP MCP server

What you can do with it

How to install FrontMCP MCP

Install FrontMCP MCP in Claude Code

Install FrontMCP MCP in Cursor

Install FrontMCP MCP in VS Code

Install FrontMCP MCP in VS Code CLI

Install FrontMCP MCP in Claude Desktop

Install FrontMCP MCP in Codex

Install FrontMCP MCP in Codex config.toml

Install FrontMCP MCP in Gemini CLI

Install FrontMCP MCP in Gemini settings.json

Automated checks

README

Write a tool. Ship a server.

Start

How it compares

Packages

FrontMCP MCP questions