Lead Stampede

io.github.treymerica1982由 GitHub 帳號 treymerica1982 發布v0.2.0更新於 Oct 25, 2026

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

已驗證Streamable HTTP可網頁執行位置與生活商業與電商

概覽

AI 產生的概覽

一個遠端 MCP 伺服器,開放 Lead Stampede 的公開中小企業目錄,讓助理搜尋商家、查看資料、評價與營業時間,並瀏覽經銷商庫存和商品目錄。

可以做什麼
依名稱、城市或業務類型搜尋並瀏覽公開客戶目錄,列出可用的業務類型和城市。取得單一客戶的完整資料,包括聯絡方式、服務、營業時間、評價和預約連結。查詢任一客戶的營業時間、預約方式與評價評分。搜尋經銷商的車輛庫存,並讀取車輛詳情、目前特惠與優惠活動。搜尋電商客戶的產品目錄並讀取產品詳情。為汽車經銷商提交銷售線索或服務預約請求。
適用情境
當助理需要查詢 Lead Stampede 目錄中的中小企業資訊、回答某商家的服務、營業時間或評價問題,或協助客戶瀏覽經銷商庫存、商品目錄、特惠,或提交試駕、服務預約請求時適用。
執行需求
遠端 streamable HTTP 端點,無需本機安裝,也未宣告憑證。README 描述的自架版本需要 Node.js、Supabase 專案 URL 和 service-role 金鑰,以及 agency API 金鑰請求標頭,但已發布的端點未宣告身分驗證。
安裝前請注意
contact_sales 和 schedule_service_appointment 工具會將客戶聯絡方式及車輛或服務資訊提交給經銷商,由其後續聯繫;僅在本人同意後提交。README 的自架設定使用 Supabase service-role 金鑰,該金鑰擁有廣泛資料庫權限,必須保密。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Lead Stampede,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.treymerica1982%2Flead-stampede/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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.

來源:README.md,提交 2cc344f

工具

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.

輸入參數cityquerybusiness_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.

輸入參數slug必填

list_business_types

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

無需輸入參數。

list_cities

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

無需輸入參數。

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

輸入參數client_slug必填

get_reviews

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

輸入參數client_slug必填

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.

輸入參數makelimitmodelqueryyear_maxyear_minbody_typefuel_typeprice_maxprice_minstock_typeclient_slug必填另有 1 個

get_vehicle_details

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

輸入參數vinclient_slug必填stock_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.

輸入參數categoryclient_slug必填

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.

輸入參數limitquerycategorymax_pricemin_pricecollectionclient_slug必填in_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.

輸入參數client_slug必填product_slug必填

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.

輸入參數notesintent必填customer必填client_slug必填preferred_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.

輸入參數notesvehicle必填customer必填services必填client_slug必填preferred_datepreferred_time_window

版本歷史

1
  1. v0.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。