Skip to content
MCP server

Mainstreet MCP

Local MCP server giving AI assistants a small business's hours, menu, FAQs and booking

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.5
Listing updated
2 days ago

About Mainstreet MCP

Mainstreet MCP is a free MCP server for local services. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add mainstreet-mcp -- npx -y mainstreet-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mainstreet-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mainstreet-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mainstreet-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mainstreet-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (13)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Free

Free; your AI client may charge separately

Prices change. Check nyclaw.io before you buy.

Mainstreet MCP 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 to Mainstreet MCP

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. Later Stages

    MCP server

    California senior living and care provider records from state licensing and Medicare

    • 6 tools
    • Remote
    • Free
    • Health and science
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. Virkly CVR

    MCP server

    Czech property marketplace for AI agents that draft sales and bids, with people deciding

    • Remote
    • Free
    • Local services