HeySpark MCP Server — AI-Powered Local Business Discovery

How AI Finds Your Business

Traditional SEO optimizes for search engines. HeySpark optimizes for AI assistants.

You Sign Up

HeySpark builds your website and adds your business to our AI directory with accurate hours, services, and contact info.

AI Agents Connect

Claude, ChatGPT, and other AI assistants query this server using the Model Context Protocol (MCP) to find businesses like yours.

Customers Find You

"Find me a good dentist in Charlotte" — and your business is in the answer, with your phone number, hours, and reviews.

Why This Matters

People are switching from Google to AI. Your business needs to be where they're looking.

Not Another Directory

This isn't Yelp or Google Maps. This is a direct data feed to AI. When AI recommends a plumber, it pulls from structured, verified data, not scraped web pages.

First Mover Advantage

AI-powered search is growing fast. The businesses that get listed now will be the ones AI learns to recommend. Your competitors aren't here yet.

Premium Visibility

Premium businesses appear first in results, include review highlights, photos, and special offers. Basic listings get contact info and rating only.

Verified, Not Scraped

Every listing is a real HeySpark client with verified info. AI agents trust this data because it's accurate and maintained, not pulled from random websites.

For Developers & AI Agents

Integrate HeySpark business data into any AI application.

Protocol

Model Context Protocol (MCP)

Transport

StreamableHTTP / JSON-RPC 2.0

Auth

None required

Endpoint

POST /mcp

Available Tools

Four tools available via MCP:

search_businesses — Search by keyword, category, city/state, or coordinates

get_business_details — Full profile with hours, services, contact, reviews

get_reviews_summary — Rating, review count, and highlights (Premium)

list_categories — All 30+ supported business categories

Add to OpenClaw / Clawdbot

One command to connect your AI assistant:

mcporter config add heyspark --url https://mcp.heyspark.co/mcp

Or add to your mcp.json / gateway config:

{
  "heyspark": {
    "url": "https://mcp.heyspark.co/mcp",
    "transport": "streamable-http"
  }
}

Add to Claude Desktop

{
  "mcpServers": {
    "heyspark": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.heyspark.co/mcp"]
    }
  }
}

Add to Gemini CLI

In your ~/.gemini/settings.json:

{
  "mcpServers": {
    "heyspark": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.heyspark.co/mcp"]
    }
  }
}

Direct API Call

POST https://mcp.heyspark.co/mcp
Content-Type: application/json
Accept: application/json, text/event-stream

{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
 "params": {"name": "search_businesses",
 "arguments": {"category": "restaurant", "city": "Asheville", "state": "NC"}}}

Your Business, Inside AI