Lead Stampede

io.github.treymerica1982Published by GitHub account treymerica1982v0.2.0Updated Oct 25, 2026

Find SMBs by name, city, and business type in the Lead Stampede directory via public MCP tools.

VerifiedStreamable HTTPWeb executableLocation & LifestyleBusiness & Commerce

Overview

AI-generated overview

A remote MCP server exposing Lead Stampede's public SMB directory, letting an assistant search businesses, view profiles, reviews and availability, and browse a

What you can do
Search and browse the public client directory by name, city or business type, and list available business types and cities. Retrieve a client's full profile with contact details, services, hours, reviews and booking URL. Check business hours, booking options and review ratings for any client. Search a dealership's vehicle inventory and read vehicle details, current specials and offers. Search an e-commerce client's product catalog and read product details. Submit a sales lead or a service appointment request for an automotive dealership.
When to use it
Useful when an assistant needs to look up small-business listings in the Lead Stampede directory, answer questions about a business's services, hours or reviews, or help a customer explore dealership inventory, product catalogs, specials, or submit a test-drive or service request.
Requirements
A remote streamable HTTP endpoint; no local install or declared credentials. The README describes a self-hosted variant needing Node.js, a Supabase project URL and service-role key, and an agency API key header, but the published endpoint declares no authentication.
Before you install
The contact_sales and schedule_service_appointment tools submit customer contact details and vehicle or service information to the dealership, which then follows up; only submit with the person's consent. The README's self-hosted setup uses a Supabase service-role key, which grants broad database access and must be kept secret.

Installation

In SourceWeft

  1. Open Lead Stampede in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.treymerica1982%2Flead-stampede/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "lead-stampede": {
      "type": "http",
      "url": "https://lead-stampede-mcp-server-production.up.railway.app/mcp"
    }
  }
}

README

Lead Stampede MCP Server

The live backend that powers Lead Stampede Agent Cards. Exposes SMB business data as tools that AI agents can call over HTTP.

What this is

An Express server that implements four MCP tools:

ToolWhat it returns
get_business_profileName, description, industry, service area, contact info
get_servicesList of services + pricing summary
get_availabilityHours + booking URL (or phone/email fallback)
get_reviewsReview count, average rating, summary

Each request is authenticated via an X-Agency-API-Key header that maps to a row in the agencies table in Supabase. Clients are scoped to their agency, so one agency can never read another's data.

Setup

1. Install

bash
npm install

2. Configure environment

bash
cp .env.example .env

Then edit .env and fill in:

  • SUPABASE_URL — your project URL (e.g. https://xlhxnlhxeprtzwbyepza.supabase.co)
  • SUPABASE_SERVICE_ROLE_KEY — from Supabase → Project Settings → API → service_role secret
  • PORT — defaults to 3000

Never commit .env to git. It's already in .gitignore.

3. Run locally

bash
npm run dev

You should see:

Lead Stampede MCP server listening on port 3000

Testing it works

Health check (no auth)

bash
curl http://localhost:3000/health# → {"status":"ok","timestamp":"..."}

List available tools (auth required)

bash
curl -H "X-Agency-API-Key: YOUR_AGENCY_API_KEY" \  http://localhost:3000/mcp/tools

Call a tool

bash
curl -X POST \  -H "X-Agency-API-Key: YOUR_AGENCY_API_KEY" \  -H "Content-Type: application/json" \  -d '{"arguments":{"client_slug":"grandinetti-molinar-law"}}' \  http://localhost:3000/mcp/tools/get_business_profile

Expected response:

json
{  "tool": "get_business_profile",  "result": {    "business_name": "Grandinetti & Molinar Law",    "description": "Austin-based law firm founded in 2002...",    "industry": "legal",    ...  },  "response_ms": 42}

Deploying to Railway

  1. Push this folder to a new GitHub repo.
  2. In Railway: New Project → Deploy from GitHub repo.
  3. Select this repo.
  4. Under Variables, add:
    • SUPABASE_URL
    • SUPABASE_SERVICE_ROLE_KEY
  5. Railway auto-detects Node.js, installs deps, and runs npm start.
  6. Once deployed, Railway gives you a public URL like mcp-production.up.railway.app.
  7. Point a custom subdomain (e.g. mcp.leadstampede.io) at it via Railway → Settings → Domains.

Architecture

AI agent  →  POST /mcp/tools/:name  →  auth.js → tools.js → supabase.js                                         ↓                                   analytics.js (fire-and-forget)                                         ↓                                   mcp_tool_calls table

Next steps

  • Build the Cloudflare Worker that serves Agent Cards at agentcards.leadstampede.io/{slug}.
  • Build the onboarding form that populates clients rows in Supabase.
  • Build the agency portal dashboard.

Source: README.md at commit 2cc344f

Tools

13

search_clients

Search Lead Stampede's public client directory. Returns matching businesses with contact info, services, and ratings. Supports filtering by city, business type, and free-text query across name, description, and industry.

Parameterscityquerybusiness_type

get_client

Returns the full public Agent Card for a single Lead Stampede client by slug. Includes business details, contact info, services, hours, reviews, and booking URL.

Parametersslugrequired

list_business_types

Returns the distinct business types available in the Lead Stampede public client directory.

Takes no parameters.

list_cities

Returns the distinct cities served by public Lead Stampede clients. Useful for discovering which locations have businesses in the directory.

Takes no parameters.

get_availability

Returns business hours and booking options for a Lead Stampede client. If the business has online scheduling, returns a tracked booking URL; otherwise returns phone/email. Works for all client types (service, automotive, ecommerce).

Parametersclient_slugrequired

get_reviews

Returns social proof for a Lead Stampede client: review count, average rating, and a brief summary. Works for all client types.

Parametersclient_slugrequired

search_inventory

Searches a dealership's vehicle inventory. Filters by stock type (new/used/certified), make, model, year range, price range, body type, and fuel type. Optional natural-language query for full-text search. Returns up to 25 matching vehicles. Only available for automotive clients.

Parametersmakelimitmodelqueryyear_maxyear_minbody_typefuel_typeprice_maxprice_minstock_typeclient_slugrequired+1 more

get_vehicle_details

Returns full details for a specific vehicle by VIN or stock number. Only available for automotive clients.

Parametersvinclient_slugrequiredstock_number

get_specials

Returns the dealership's current specials and offers — new-vehicle APR/lease specials, pre-owned specials, service & parts coupons, manufacturer rebates, and incentive programs. Only available for automotive clients.

Parameterscategoryclient_slugrequired

search_products

Searches the product catalog of an e-commerce client. Supports natural-language queries plus optional filters for category, price range, collection, and stock status. Only works for e-commerce clients.

Parameterslimitquerycategorymax_pricemin_pricecollectionclient_slugrequiredin_stock_only

get_product_details

Returns full details for a single product by slug: name, description, price, sizes, colors, stock status, and product page URL. Only for e-commerce clients.

Parametersclient_slugrequiredproduct_slugrequired

contact_sales

Captures a sales lead for an automotive dealership. Use for test drive requests, vehicle inquiries, financing questions, lease questions, trade-in conversations, or general interest. Requires at least one contact method (email or phone). Only available for automotive clients.

Parametersnotesintentrequiredcustomerrequiredclient_slugrequiredpreferred_datevehicle_of_interest

schedule_service_appointment

Captures a service appointment request for an automotive dealership. Records the customer's contact info, vehicle details, requested services, and preferred timing as a service lead. The dealership's service advisor will follow up to confirm. Requires at least one contact method (email or phone). Only available for automotive clients.

Parametersnotesvehiclerequiredcustomerrequiredservicesrequiredclient_slugrequiredpreferred_datepreferred_time_window

Version history

1
  1. v0.2.0LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.