Main Street MCP

A free, industry-specific MCP server that gives a small business's AI assistants (such as Claude Desktop and Claude Code) configured facts about hours, menu/services, FAQs, staff and booking. One business.yaml file per business; no code changes required to run it. Answers depend on the accuracy of that file and the assistant using it.

The published package supports compatible local MCP clients over stdio. It is not a hosted ChatGPT app or connector. The optional HTTP mode listens on loopback and validates localhost Host/Origin headers; remote hosting, authentication and client compatibility must be configured and verified separately. A reverse proxy alone does not establish those requirements.

Quickstart (business owner)

1. Install Node.js 20+ (or use the version already on your machine — check with node -v).

2. Generate a starter config for your industry:

   npx -y mainstreet-mcp init --industry restaurant
   

   Replace restaurant with your industry. Supported industries: restaurant, dental, law-firm, home-services, salon-spa, fitness-studio, real-estate-agent, auto-repair, insurance-agency, church.

   This writes business.yaml in the current directory — edit it with your business's real name, hours, menu/services, FAQs, etc. (Use --out <path> for a different name; every other command then needs --config <path>.)

3. Check your edits are valid:

   npx -y mainstreet-mcp validate
   

   A broken file (bad YAML, a typo'd industry, a field that doesn't fit) prints a specific, readable error instead of a stack trace.

4. Point your AI assistant at it. For a local MCP client (e.g. Claude Desktop) that spawns stdio servers, add an entry like:

   {
     "mcpServers": {
       "my-business": {
         "command": "npx",
         "args": ["-y", "mainstreet-mcp", "--config", "/absolute/path/to/business.yaml"]
       }
     }
   }
   

   To test the business server over local HTTP instead, run:

   npx -y mainstreet-mcp serve --http --port 3000
   

   The HTTP server only binds to 127.0.0.1 and validates the Host/Origin headers on every request. No public endpoint, remote authentication or hosted deployment is included. A remote deployment needs a separate review of those controls and the intended client's transport requirements.

What it gives an AI assistant

Every business gets 7 universal tools regardless of industry:

• get_business_profile — name, description, contact info, address, policies
• check_open_status — open/closed right now (or at a given time), in the business's own timezone, including overnight hours and holiday/exception overrides
• search_offerings — free-text search over whatever the business sells/offers
• answer_question — looks up configured FAQs; returns found: false rather than a guess when nothing matches confidently
• list_staff — configured staff, roles, bios, credentials
• get_booking_options — how to actually book (phone/online/walk-in/email)
• submit_inquiry — lets a customer leave a message; rate-limited, sanitized, and screened by industry-specific guardrails before it's accepted

On top of that, each industry preset turns on a handful of capabilities — pluggable tool modules — matched to that industry:

... View full README on GitHub