Mainstreet MCP
Local MCP server giving AI assistants a small business's hours, menu, FAQs and booking
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mainstreet-mcp": {
"command": "npx",
"args": [
"-y",
"mainstreet-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mainstreet-mcp": {
"command": "npx",
"args": [
"-y",
"mainstreet-mcp"
]
}
}
}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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity
Later Stages
MCP serverCalifornia senior living and care provider records from state licensing and Medicare
- 6 tools
- Remote
- Free
- Health and science

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

Virkly CVR
MCP serverCzech property marketplace for AI agents that draft sales and bids, with people deciding
- Remote
- Free
- Local services