🏠 Hometeam MCP Server

Ask any AI about Black-owned businesses in South Florida. This is where the answers come from.

The Hometeam MCP server connects AI assistants to a curated, community-verified directory of Black-owned businesses across Miami-Dade, Broward, and Palm Beach counties. When someone asks Claude, "find me a Black-owned caterer in Broward County," this server provides the real, verified data behind the answer.

Built on the Model Context Protocol (MCP) — the open standard for connecting AI assistants to external data sources.

Published on the MCP Registry

This server is listed on the official MCP Registry as io.github.JajuanX/hometeam-directory.

Live endpoint: https://mcp.thehometeam.io/sse

Connect with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "hometeam": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://mcp.thehometeam.io/sse"
      ]
    }
  }
}

Available tools

| Tool | Description | |------|-------------| | search_businesses | Search by keyword, category, neighborhood, or county | | get_business_details | Get full profile: hours, contact, reviews, specials | | find_by_specialty | Natural language search ("someone to do box braids near Miramar") | | list_categories | All 14 business categories | | list_neighborhoods | Neighborhoods across Miami-Dade, Broward, Palm Beach | | get_latest_draft_class | Newest businesses added on Draft Day |

Rate limits

| Tier | Limit | Access | |------|-------|--------| | Free | 100 queries/day | No API key needed | | Pro | 10,000 queries/day | API key (coming soon) |

Connect to the live server

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "hometeam": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://mcp.thehometeam.io/sse"
      ]
    }
  }
}

Restart Claude Desktop. Then ask:

• "Find me a Black-owned restaurant in Lauderhill"
• "What new businesses just joined Hometeam?"
• "I need someone to do box braids near Miramar"

HTTP endpoints

| Endpoint | Description | |----------|-------------| | GET https://mcp.thehometeam.io/ | Service info and available tools | | GET https://mcp.thehometeam.io/health | Health check | | GET https://mcp.thehometeam.io/sse | SSE connection for MCP clients | | POST https://mcp.thehometeam.io/messages | MCP message handler |

Rate limits

| Tier | Limit | How to access | |------|-------|---------------| | Free | 100 queries/day | No API key required | | Pro | 10,000 queries/day | API key (coming soon — join the waitlist at thehometeam.io/developers) |

Quick test

# Service info
curl https://mcp.thehometeam.io/

# Health check
curl https://mcp.thehometeam.io/health

Verify on the registry

curl "https://registry.modelcontextprotocol.io/v0/servers/io.github.JajuanX%2Fhometeam-directory/versions/latest"

Local development

If you want to run the server locally (for development or contributing):

git clone https://github.com/juanx/hometeam-project-orange.git
cd hometeam-project-orange/hometeam/mcp-server
npm install
cp .env.example .env
# Edit .env — set MONGO_URI to the same database as the backend

# Run with stdio transport (for Claude Desktop local testing)
npm run start:local

# Run with HTTP/SSE transport (for remote access)
npm start

Claude Desktop config for local:

{
  "mcpServers": {
    "hometeam": {
      "command": "node",
      "args": ["/absolute/path/to/hometeam-mcp-server/server.js"],
      "env": {
        "MONGO_URI": "your_mongodb_connection_string"
      }
    }
  }
}

Important: Use the absolute path from pwd in the mcp-server directory. console.log is redirected to `con

... View full README on GitHub