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 分

    请在仓库或注册中心条目中声明许可证。