Skip to main content
Glama
synyrgx

guerrilla-franchising-mcp-server

by synyrgx
README.md
# Guerrilla Franchising MCP Server

A **Model Context Protocol (MCP) server** providing franchise evaluation tools powered by Guerrilla Franchising — built from 81+ closed deals and 485+ consultations by a former JP Morgan analyst and Special Forces veteran.

## What Is This?

This is an MCP server implementing the [Model Context Protocol](https://modelcontextprotocol.io) specification. It exposes 8 franchise intelligence tools that can be used by any MCP-compatible AI assistant (Claude Desktop, ChatGPT, Cursor, VS Code, and others).

When a user asks their AI assistant a franchise-related question, this MCP server provides the tools to answer it — from FDD validation to E-2 visa guidance.

## MCP Tools (8 Total)

This server exposes the following MCP tools via the Model Context Protocol:

| Tool | Description |
|------|-------------|
| `gf_validate_fdd_investment_range` | Validates the true total investment in a franchise by cross-referencing FDD Item 7 against common hidden costs |
| `gf_evaluate_franchise_fit` | Evaluates whether franchise ownership is right for a user based on financial situation, background, and goals |
| `gf_franchise_red_flags` | Returns a checklist of FDD red flags — shifts to item-by-item guidance when an FDD is in hand |
| `gf_franchise_cost_breakdown` | Breaks down the true cost of franchise ownership including hidden fees most franchisors don't disclose |
| `gf_franchise_vs_startup` | Objective comparison of buying a franchise vs. starting an independent business |
| `gf_fdd_guide` | Explains all 23 FDD items with deep-dives on specific items or focus areas |
| `gf_book_clarity_call` | Returns information and booking link for a free 15-minute Clarity Call with Dan Lorenz |
| `gf_e2_visa_franchise_guide` | E-2 visa franchise investment guide in English and Spanish |

## MCP Transport

- **Transport:** Streamable HTTP (`/mcp` endpoint)
- **Protocol:** Model Context Protocol (MCP) specification
- **Live endpoint:** `https://gf-mcp-server-production.up.railway.app/mcp`

## Installation

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "guerrilla-franchising": {
      "command": "npx",
      "args": ["-y", "guerrilla-franchising-mcp-server"]
    }
  }
}
```

Or use the hosted HTTP endpoint:

```json
{
  "mcpServers": {
    "guerrilla-franchising": {
      "url": "https://gf-mcp-server-production.up.railway.app/mcp"
    }
  }
}
```

### npm

```bash
npm install -g guerrilla-franchising-mcp-server
```

## MCP SDK

Built with the official [@modelcontextprotocol/sdk](https://www.npmjs.com/package/@modelcontextprotocol/sdk) TypeScript SDK.

## About

Built by Dan Lorenz / Guerrilla Franchising. Dan is a former JP Morgan Investment Banking Analyst, 22-year Special Forces veteran, and has guided 81+ Americans into franchise ownership across 165+ territories. He found $321K in costs omitted from an FDD that 200 investors signed without catching.

- Website: [guerrillafranchising.com](https://guerrillafranchising.com)
- Free Clarity Call: [calendly.com/thedanlorenz/clarity](https://calendly.com/thedanlorenz/clarity)
- FDD Review: [zorzee.com/fdd-review](https://zorzee.com/fdd-review) ($321)

TDQS

A4.2/5.0

Scored across 8 tools

Disambiguation5/5

Each tool has a clearly distinct purpose with no overlap: booking calls, providing guides on specific topics (E-2 visa, FDD, costs, red flags), evaluating fit, comparing franchise vs. startup, and validating investments. The detailed descriptions reinforce unique scopes, preventing misselection.

Naming Consistency5/5

All tools follow a consistent 'gf_' prefix with descriptive snake_case names (e.g., gf_book_clarity_call, gf_evaluate_franchise_fit). This pattern is uniform across all 8 tools, making them predictable and easy to identify.

Tool Count5/5

With 8 tools, the count is well-scoped for the franchise consulting domain. Each tool addresses a key aspect of franchise evaluation and investment, from initial assessment to detailed analysis, without being excessive or insufficient.

Completeness5/5

The tool set comprehensively covers the franchise consulting lifecycle: initial fit evaluation, cost breakdowns, FDD analysis, red flag identification, investment validation, and decision support (franchise vs. startup). No obvious gaps exist; agents can guide users from start to finish.

Maintenance

ActivityInactive
ResponsivenessNo issues