Lead Stampede

treymerica1982/lead-stampede-mcp-server

Exposes four read-only tools that pull SMB business data from a Supabase backend: profile details, service lists with pricing, availability and booking info, and review summaries. Every call requires an X-Agency-API-Key header that scopes requests to a single agency's client roster, so you can only query businesses your agency manages. Designed to feed AI agents building "Agent Cards" for local businesses. If you're running a directory or lead gen platform and want Claude to answer questions like "What are the hours for this plumber?" or "How much do they charge for drain cleaning?" without touching your database schema, this gives you a clean HTTP transport layer. Built on Express, deployed to Railway, and logs every tool call for analytics.

tools: 13
transport: HTTP
last updated: May 22, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://lead-stampede-mcp-server-production.up.railway.app/mcp --name lead-stampede

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http lead-stampede https://lead-stampede-mcp-server-production.up.railway.app/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 13 tools

Verified live against the running server on Nov 6, 2026.

search_clientsSearch 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.3 params

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.

Parameters* required

business_typestring

Filter by business type (e.g. "service", "ecommerce", "automotive").

citystring

Filter by city name within the client's service area.

querystring

Free-text search across business name, description, and industry.

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

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.

Parameters* required

slug*string

The unique slug of the client (e.g. "lead-stampede").

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

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

No parameters. Call it with no arguments.

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

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

No parameters. Call it with no arguments.

get_availabilityReturns 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).1 params

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

Parameters* required

client_slug*string

Unique slug identifying the client.

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

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

Parameters* required

client_slug*string

Unique slug identifying the client.

search_inventorySearches 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.13 params

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.

Parameters* required

body_typestring

one of SUV · Sedan · Hatchback · Bus · Truck · Coupe

client_slug*string

Unique slug identifying the dealership.

featured_onlyboolean

If true, only featured vehicles.

fuel_typestring

one of gas · electric · hybrid · diesel · phev

limitinteger

Max results (1-25, default 10).

makestring

Vehicle make.

modelstring

Vehicle model.

price_maxnumber

Maximum price in dollars.

price_minnumber

Minimum price in dollars.

querystring

Natural-language search (e.g. "red SUV").

stock_typestring

Filter by stock type.one of new · used · certified · any

year_maxinteger

year_mininteger

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

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

Parameters* required

client_slug*string

Unique slug identifying the dealership.

stock_numberstring

Dealer stock number.

vinstring

17-character VIN.

get_specialsReturns 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.2 params

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.

Parameters* required

categorystring

Filter by category.one of new · used · service · parts · rebates · all

client_slug*string

Unique slug identifying the dealership.

search_productsSearches 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.8 params

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.

Parameters* required

categorystring

Product category filter.

client_slug*string

Unique slug identifying the e-commerce client.

collectionstring

Collection name filter.

in_stock_onlyboolean

If true, only in-stock products.

limitinteger

Max results (1-25, default 10).

max_pricenumber

Maximum price in dollars.

min_pricenumber

Minimum price in dollars.

querystring

Natural-language search terms.

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

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.

Parameters* required

client_slug*string

Unique slug identifying the e-commerce client.

product_slug*string

Slug of the product.

contact_salesCaptures 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.6 params

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.

Parameters* required

client_slug*string

Unique slug identifying the dealership.

customer*object

Customer contact information.

intent*string

What the customer is reaching out about.one of test_drive · vehicle_inquiry · financing · lease · trade_in · general

notesstring

preferred_datestring

For test_drive: preferred date.

vehicle_of_interestobject

The specific vehicle the customer is asking about.

schedule_service_appointmentCaptures 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 meth...7 params

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

Parameters* required

client_slug*string

Unique slug identifying the dealership.

customer*object

Customer contact information.

notesstring

preferred_datestring

Preferred date (YYYY-MM-DD).

preferred_time_windowstring

one of morning · afternoon · first-available

services*array

List of requested services.

vehicle*object

Vehicle being serviced.

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:

Tool	What it returns
`get_business_profile`	Name, description, industry, service area, contact info
`get_services`	List of services + pricing summary
`get_availability`	Hours + booking URL (or phone/email fallback)
`get_reviews`	Review 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

npm install

2. Configure environment

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

npm run dev

View the full README on GitHub

Details

Repository: github.com/treymerica1982/lead-stampede-mcp-server
Category: Sales & Marketing
Transport: HTTP
Registry: MCP registry, active
Tools verified: Nov 6, 2026

Related Sales & Marketing MCP servers

View all

GitDealFlow Signalkindrat86/mcp-deal-flow-signalGitHub-derived engineering acceleration signals for VC deal flow — surface stealth startups before TechCrunch covers them. Weekly-refreshed dataset of 109 start0stars

Mcp B2b Social Video Transcriptsmambalabsdev/mcp-b2b-social-video-transcriptsTranscripts and buying signals from social videos and podcasts, on your own speech and AI keys.0stars

Mcp Private Company Funding Historymambalabsdev/mcp-private-company-funding-historyFunding rounds of private US companies from SEC Form D and Form C filings on EDGAR0stars

Revenue Mcpwarfare-hub/revenue-mcpQuery MRR, churn, and revenue from Stripe, Gumroad & Lemon Squeezy in Claude0stars

Nas.comnas-company/nas-mcpOfficial hosted MCP server for Nas.com, the AI marketing platform for SMBs.0stars

Vibe Prospectingexplorium-ai/vibeprospecting-mcpB2B company and contact data for lead lists, enrichment, research, and outreach. OAuth sign-in.294stars