frontmcp-guides

name	frontmcp-guides
description	Tutorials, end-to-end walkthroughs, and complete reference projects for FrontMCP. Use when you want a getting-started guide, a full worked example, or to learn best practices by following a step-by-step build rather than a single API reference. Includes a beginner weather-API server (tool plus static resource, Zod schemas, E2E tests), an authenticated task manager (CRUD tools, Redis storage, OAuth, Vercel deploy, authenticated E2E tests), and a multi-app knowledge base (vector search, semantic resources, an AI research agent, audit logging). Triggers: tutorial, walkthrough, how do I build, getting started, end-to-end example, sample project, learn FrontMCP, full app example.
tags	["guides","examples","best-practices","architecture","walkthrough","end-to-end"]
category	guides
targets	["all"]
bundle	["recommended","full"]
priority	10
visibility	both
license	Apache-2.0
metadata	{"docs":"https://docs.agentfront.dev/frontmcp/guides/your-first-tool"}
examples	[{"scenario":"Build a simple weather API MCP server from scratch","expected-outcome":"Working server with tools, resources, and tests deployed to Node"},{"scenario":"Build a task manager with auth, Redis, and multi-tool patterns","expected-outcome":"Authenticated server with CRUD tools, session storage, and E2E tests"},{"scenario":"Build a multi-app knowledge base with agents and plugins","expected-outcome":"Composed server with multiple apps, AI agents, caching, and Vercel deployment"}]

FrontMCP End-to-End Guides

Complete build walkthroughs and best practices for FrontMCP servers. Each example starts from an empty directory and ends with a deployed, tested server. Every pattern references the specific skill that teaches it.

When to Use This Skill

Must Use

• Starting a new FrontMCP project from scratch and want a complete walkthrough to follow
• Learning FrontMCP architecture by building progressively complex real examples
• Need to see how multiple skills work together in a complete application

Recommended

• Planning a new project and want to see how similar architectures are structured
• Onboarding a team member who learns best from complete working examples
• Reviewing best practices for file organization, naming, and code patterns

Skip When

• You need to learn one specific component type (use the specific reference, e.g., create-tool under frontmcp-development/references/)
• Looking for the right reference for a task (use domain routers: frontmcp-development, frontmcp-deployment, etc.)
• You need CLI/install instructions for the skills system (see frontmcp-skills-usage)

Decision: Use this skill when you want to see how everything fits together. Open individual references under each router's references/ directory when you need focused instruction.

Prerequisites

• Node.js 24+ and npm/yarn installed
• Familiarity with TypeScript and decorators
• frontmcp CLI available globally (npm install -g frontmcp)

Steps

1. Choose an example that matches your project's complexity level (Beginner, Intermediate, Advanced)
2. Work through the Planning Checklist to define your project's scope
3. Follow the example code and architecture, referencing individual skills for deeper guidance
4. Verify your implementation using the Verification Checklist at the end of this skill

Planning Checklist

Before writing any code, answer these questions:

1. What does the server do?

• What tools does it expose? (actions AI clients can call)
• What resources does it expose? (data AI clients can read)
• What prompts does it expose? (conversation templates)

2. How is it organized?