Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Mainstreet MCP

de gbrussich52versión 0.1.5i★ 0iSe ejecuta en tu computadoraSitio oficial ↗
Nombre en el registroio.github.gbrussich52/mainstreet-mcp

Cómo instalar

What it does

Free small-business facts and stateless workflow review kits: quotes, invoices and order handoffs.

  • Connects Se ejecuta en tu computadora
  • Account or key No key needed
  • Category Contabilidad, finanzas e impuestos

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso12/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Mainstreet MCP. Sigue https://mcp.popnx.com/i/gbrussich52-mainstreet-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

  1. Descarga el instalador del autor

    Descargar el archivo .mcpb del creador

    El archivo .mcpb viene directo del autor; no lo modificamos

  2. Haz doble clic en el archivo y pulsa Install en la app de Claude de escritorio

  3. Pruébalo

    Usa Mainstreet MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Mainstreet MCP o muestra una herramienta de Mainstreet MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Mainstreet MCP

Mainstreet MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Mainstreet MCP

  • Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Contabilidad, finanzas e impuestos que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Mainstreet MCP para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user mainstreet -- npx -y mainstreet-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Mainstreet MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --scope user mainstreet -- npx -y mainstreet-mcp
  4. Escribe /mcp en Claude Code

    Deberías ver Mainstreet MCP en la lista como conectado

  5. Pruébalo

    Usa Mainstreet MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Mainstreet MCP o muestra una herramienta de Mainstreet MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Mainstreet MCP para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "mainstreet": { "command": "npx", "args": [ "-y", "mainstreet-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Mainstreet MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de Cursor en modo Agent

  4. Pruébalo

    Usa Mainstreet MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Mainstreet MCP o muestra una herramienta de Mainstreet MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Mainstreet MCP para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "mainstreet": { "type": "stdio", "command": "npx", "args": [ "-y", "mainstreet-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Mainstreet MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de VS Code en modo Agent

  4. Pruébalo

    Usa Mainstreet MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Mainstreet MCP o muestra una herramienta de Mainstreet MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Mainstreet MCP💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user mainstreet -- npx -y mainstreet-mcp

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

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

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
62/sem
Conexión
Se ejecuta en tu computadora
Última versióni
0.1.5
Publicado en el registroi
30 oct 2026
Último cambio de códigoi
30 oct 2026
Creador
gbrussich52
Paquetes
mcpb: …/mainstreet-mcp.mcpb
npm: mainstreet-mcp
Sitio web
nyclaw.io
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub gbrussich52, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 20 días

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para mainstreet-mcp@0.1.5

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/gbrussich52-mainstreet-mcp.svg)](https://mcp.popnx.com/en/servers/gbrussich52-mainstreet-mcp)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Contabilidad, finanzas e impuestosi

  • Más estrellas que el 0% de los otros 3417 servidores de esta categoría
  • Publicado en el registro más recientemente que el 59% de los otros 3417 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 3417 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Mainstreet MCP?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 20 días, y la última versión (0.1.5) llegó al registro hace 20 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas MCPB, Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

de SolidInvoiceEn crecimiento★ 989Actualizado hace 10 días

Se ejecuta en la nube✓ del servicio · solidinvoice.co

Signal8

SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.

de signal8aiEn crecimiento↓ 431/sem★ 425Actualizado hace 10 días

Computadora o nube✓ del servicio · signal8.ai

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

de CursivezEn crecimiento★ 261Actualizado hace 11 días

Se ejecuta en la nube✓ del servicio · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

de bex-coEn crecimiento★ 702 Estrellas de todo el repositorioActualizado hace 44 días

Se ejecuta en la nube✓ del servicio · beancount.io
Comparado con otros parecidos
Este
Mainstreet MCP
SolidInvoiceSignal8JournalitBeancount.ioTapetide - Indian Stock Market MCP
Dónde se ejecutaSe instala en tu equipoFunciona en la nube, sin instalar nadaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaEn la nube o instalado en tu equipo
Necesita claveNoNoSíNoNoSí
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas3/34/65/54/44/45/5
LicenciaMITMITMITNOASSERTIONMITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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 for a different name; every other command then needs --config .)

  1. 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.

  1. 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:

IndustryCapabilities / tools
restaurantmenu → get_menu
dentalinsurance_accepted → check_insurance_accepted, price_estimate → get_price_estimate
law-firmpractice_areas → list_practice_areas (always carries a not-legal-advice disclaimer)
home-servicesservice_area → check_service_area, price_estimate → get_price_estimate
salon-spaprice_estimate → get_price_estimate, class_schedule → get_class_schedule
fitness-studioclass_schedule → get_class_schedule
real-estate-agentlistings → search_listings, service_area → check_service_area
auto-repairservice_area, price_estimate, insurance_accepted
insurance-agencycoverage_lines → list_coverage_lines, service_area → check_service_area
churchservice_times → get_service_times

Every tool ships an outputSchema and returns structuredContent, so a calling agent gets typed data back, not just prose to parse.

Guardrails

Some presets screen submit_inquiry messages before accepting them, on top of the universal sanitization (HTML/control-char stripping, length caps, rate limiting):

  • dental — rejects messages containing an SSN-shaped pattern, and long messages with clinical/health detail keywords (tells the patient to call the office instead).
  • law-firm — caps the message to one line / 280 characters (a topic, not case details).
  • salon-spa / fitness-studio — rejects messages containing health/medical detail keywords (pregnancy, injury, medication, etc.), directing the customer to tell staff in person instead.

price_estimate outputs always carry is_estimate: true plus a disclaimer — never present as a firm quote.

Install

Claude Desktop (one-click, no terminal)

Download the latest mainstreet-mcp.mcpb from the releases page (or build it yourself — see mcpb/ below), then double-click it. Claude Desktop opens it as a Desktop Extension install prompt; it asks for one thing — a folder to keep your business.yaml in. Pick any folder you can find again; Documents is fine. No Node.js install or terminal needed.

You do not need a `business.yaml` before you install. If the folder is empty, the server starts in setup mode: ask Claude to "set up my business", and it lists the industries, writes the starter file into that folder, and interviews you to fill in your real hours, services and prices. Turn the extension off and on again when you're done and your business tools appear. The folder you picked stays the same throughout.

To build the .mcpb yourself:

npx @anthropic-ai/mcpb pack mcpb build/mainstreet-mcp.mcpb
Claude Code (plugin)

Install the bundled plugin, which registers the MCP server and adds a setup-my-business skill that interviews you and writes business.yaml for you:

claude plugin marketplace add gbrussich52/mainstreet-mcp

claude plugin install mainstreet@mainstreet

The plugin's MCP config expects business.yaml at your project root (${CLAUDE_PROJECT_DIR}/business.yaml), which is exactly what init writes — run the setup-my-business skill, or npx -y mainstreet-mcp init --industry , from that directory.

Claude Code (direct MCP add, no plugin)
claude mcp add mainstreet -- npx -y mainstreet-mcp --config /absolute/path/to/business.yaml
Generic JSON config (any MCP client)

For any client that spawns stdio servers from a JSON config (Claude Desktop's manual config, other MCP clients):

{

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

Example configs

examples/ has one working .business.yaml per supported industry — the same files init copies from and the E2E test suite runs against.

Development

npm install

npm run build # tsc -> dist/ npm test # builds, then runs node --test against dist/test/*.test.js

Stack: @modelcontextprotocol/server@2.0.0 (MCP spec 2026-07-28), TypeScript strict/ESM, Zod for all schemas and config validation, yaml for parsing business.yaml. All dependencies are pinned to exact versions (no ^).

Project layout
  • src/config/schema.ts — the business.yaml Zod schema (BusinessConfigSchema) and types.
  • src/config/load.ts — loads + validates a config file, including per-capability config and the industry/capability compatibility check.
  • src/hours.ts — timezone-aware open/closed logic (Intl-based), overnight ranges, date exceptions, forward-scanning for the next open/close time.
  • src/search.ts — the recall-first free-text search used by search_offerings and answer_question.
  • src/inquiries.ts — InquirySink: sanitization, rate limiting, guardrail hook, and file/webhook delivery for submit_inquiry.
  • src/capabilities/* — the 9 pluggable capability modules (config schema + tool registration each).
  • src/presets/* — the 10 industry presets: which capabilities are on, the instructions text injected into the server, and any guardHooks.
  • src/tools/universal.ts — the 7 universal tools every business gets.
  • src/server.ts — createServer(config): builds the McpServer for a loaded config.
  • src/cli.ts — mainstreet-mcp entry point (stdio default, init, validate, serve --http).
  • src/test/*.test.js (compiled from .ts) — unit tests (schema, search, hours, inquiries/ guardrails) plus an E2E suite that spawns the built stdio server for every example config and drives it with the real MCP client SDK.
Testing notes
  • npm test runs both unit tests and the E2E suite (src/test/e2e.test.ts), which spawns dist/cli.js as a child process via StdioClientTransport for every file in examples/, calls tools/list, then calls every registered tool and asserts it returns structuredContent without isError.
  • serve --http binds a local port, which some sandboxed shells block by default; test it outside such a sandbox if EPERM/listen errors appear.

The submit_inquiry tool advertises openWorldHint: true when configured for webhook delivery and false for local file delivery. It remains a non-idempotent write tool in both modes.

Status

Presets, capabilities, universal tools, CLI, and all 10 example configs are built and verified (build, unit tests, E2E stdio tests, CLI validate success/failure paths, and an HTTP smoke test all pass — see the build's final report for exact output). Version 0.1.4 is published on npm, in the GitHub release and in the official MCP registry as io.github.gbrussich52/mainstreet-mcp. These are package distribution channels; they do not provide a hosted endpoint or prove a particular customer's integration. The desktop bundle opens business setup; workflow kits use the CLI configuration below.

Workflow kits: caller-supplied facts to a review packet

Version 0.1.4 adds three stateless kits. Each exposes exactly two tools: analyze_workflow and prepare_workflow_draft. They evaluate supplied structured facts with explicit sample policies and prepare an unsent review draft when inputs are adequate. No provider account, live source verification, storage, messages, money movement or fulfillment changes are included. Your MCP host may send tool inputs to its model provider; use fictional inputs first and follow your organization's data rules.

npx -y mainstreet-mcp@0.1.4 kit quote-followup

npx -y mainstreet-mcp@0.1.4 kit invoice-discrepancies npx -y mainstreet-mcp@0.1.4 kit order-handoff

Use one kit per configured MCP server. Try the fictional demos and request a scoped implementation. These free kits do not include connected customer systems. Check native CRM, accounting or order software before commissioning a custom integration.

{ "mcpServers": { "quote-review": { "command": "npx", "args": ["-y", "mainstreet-mcp@0.1.4", "kit", "quote-followup"] } } }

Ask: “Review this quote using the supplied timestamps and follow-up policy. Prepare a draft only if the tool says it is ready.” Send all required fields from the published tool schema, using null fo

Solo se muestra el principio; lee el resto en el repo