# Mainstreet MCP

> Mainstreet MCP is a free MCP server for local services. Local MCP server giving AI assistants a small business's hours, menu, FAQs and booking. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted
- **Website:** https://nyclaw.io/ai-workflows
- **Repository:** https://github.com/gbrussich52/mainstreet-mcp
- **MCP Registry name:** io.github.gbrussich52/mainstreet-mcp
- **Categories:** local services, productivity
- **Listing updated:** 2026-11-14

## About

Each business describes itself in a single `business.yaml` file, generated by `npx -y mainstreet-mcp init --industry <name>` and checked with `validate`. The assistant then answers from that file instead of guessing, and the README stresses that answers are only as accurate as what the owner wrote.

Presets exist for restaurants, dental practices, law firms, home services, salons and spas, fitness studios, real estate agents, auto repair, insurance agencies and churches. Each preset adds industry tools on top of seven universal ones, for example `get_menu` for restaurants, `check_insurance_accepted` for dental and `list_practice_areas` for law firms, which always carries a not-legal-advice disclaimer.

The server runs over stdio on your machine. An optional HTTP mode binds only to 127.0.0.1; the README says remote hosting and authentication need separate review. A related website offers free workflow kits for quote follow-up, invoice comparison and order handoff that analyse a supplied record and draft a message for a person to review.

## Features

- **Industry presets:** Ten starter configs, from restaurant to church, switch on matching tools.
- **Open-status checks:** Reports whether the business is open now or at a given time, including overnight hours and holiday overrides.
- **FAQ lookup:** Returns found: false instead of a guess when no configured FAQ matches.
- **Inquiry intake:** Customers can leave a message that is rate-limited, sanitized and screened by industry guardrails.
- **Config validation:** A validate command prints a readable error for a broken YAML file.
- **Local-only HTTP mode:** Optional test server binds to loopback and checks Host and Origin headers.

## Good for

- Let an assistant answer customers' questions about opening hours
- Expose a restaurant menu to an AI assistant
- Share dental insurance and price-estimate details
- Collect booking or inquiry messages through an assistant
- Prototype a small-business assistant from one YAML file

## Install

### Claude Code (Terminal)

```sh
claude mcp add mainstreet-mcp -- npx -y mainstreet-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mainstreet-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mainstreet-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `get_business_profile`: Name, description, contact info, address and policies.
- `check_open_status`: Whether the business is open now or at a given time.
- `search_offerings`: Free-text search over what the business sells.
- `answer_question`: Looks up configured FAQs.
- `list_staff`: Configured staff, roles, bios and credentials.
- `get_booking_options`: How to book: phone, online, walk-in or email.
- `submit_inquiry`: Lets a customer leave a message.
- `get_menu`: Restaurant menu.
- `check_insurance_accepted`: Dental insurance check.
- `get_price_estimate`: Price estimate for dental, home services and salon presets.
- `list_practice_areas`: Law-firm practice areas with a not-legal-advice disclaimer.
- `check_service_area`: Home-services service-area check.
- `get_class_schedule`: Class schedule for salon-spa and fitness presets.

## FAQ

### Does it cost anything?

The README calls it free. Your AI client may need its own subscription.

### How do I set up my business details?

Run the init command for your industry, edit business.yaml and run validate.

### Is it hosted for ChatGPT?

No. The README says it is not a hosted ChatGPT app or connector; it supports local stdio clients.

### Which Node version is needed?

Node.js 20 or newer.

### Is Mainstreet MCP free?

Yes. Mainstreet MCP is free to use.

### How do I add Mainstreet MCP to Claude Code?

Run this command in your terminal: claude mcp add mainstreet-mcp -- npx -y mainstreet-mcp

### What are the best alternatives to Mainstreet MCP?

The closest alternatives to Mainstreet MCP are Ha MCP, Concord MCP, note1, Later Stages and CalderFlow.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Virkly CVR](https://ai-powered.com/mcp/virkly-cvr): Virkly CVR is a free MCP server for local services.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [MaineMCP](https://ai-powered.com/mcp/mainemcp): MaineMCP is a free MCP server for events and entertainment.

---
Source: https://ai-powered.com/mcp/mainstreet-mcp
