Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

Hometeam Directory

by jajuanxversion 1.2.0i★ 0iRuns in the cloudOfficial site ↗
Registry nameio.github.JajuanX/hometeam-directory

How to install

What it does

Search Black-owned businesses in South Florida by category, neighborhood, or need.

  • Connects Runs in the cloud
  • Account or key No key needed
  • Category Search & AI memory

Use together with

Skills that teach the AI this kind of work; they work alongside this one

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

by google-research★ 35,6291 skills

Skill · How-to guide

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

by BigBodyCobain★ 11,6021 skills

Skill · How-to guide

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

by gosom★ 8,2091 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness7/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score7/100

Quality: Passed 2/4 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Passed 2/4 checks · Runs on your computer

We hid some of the commands

Connect by URL: the server address did not answer when we checked

No install path has passed yet. See the maker’s instructions or pick another server in this category · Maker’s install instructions · Others in this category

First: which AI do you use?

Pick your app and the steps appear below.

Claude cannot connect Hometeam Directory yet

No install path has passed yet. See the maker’s instructions or pick another server in this category

ChatGPT cannot connect Hometeam Directory yet

No install path has passed yet. See the maker’s instructions or pick another server in this category

What you can do instead

B · Others in Search & AI memory that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Claude Code cannot connect Hometeam Directory yet

No install path has passed yet. See the maker’s instructions or pick another server in this category

Cursor cannot connect Hometeam Directory yet

No install path has passed yet. See the maker’s instructions or pick another server in this category

VS Code cannot connect Hometeam Directory yet

No install path has passed yet. See the maker’s instructions or pick another server in this category

No install path has passed yet. See the maker’s instructions or pick another server in this category

Stuck? Ask people who use Hometeam Directory💬 Discussion →

At a glance

Downloads per weeki
Not on npm/PyPI
Licencei
No licence stated
Connection
Runs in the cloud
Latest versioni
1.2.0
Published to registryi
Apr 8, 2026
Code last changedi
Oct 5, 2026
Last checked
Nov 16, 2026
Maker
jajuanx
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

GooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

All apps, with pros and cons →

Related guides

What it can do

The server did not answer when we last checked, so we could not read its tools.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account JajuanX, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed last month

  • ✕ Fail

    Has a licence

    No licence file found in the repo

  • ✕ Fail

    Endpoint responds

    Did not respond within 6 seconds when we checked

  • – Not applicable

    Sign-in with OAuth

    Did not respond within 6 seconds when we checked

  • … Not checked yet

    No hidden instructions in tool descriptions

    Not checked yet; we read the tool list when we check the endpoint

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/jajuanx-hometeam-directory.svg)](https://mcp.popnx.com/en/servers/jajuanx-hometeam-directory)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Search & AI memoryi

  • More stars than 0% of the other 6384 servers in this category
  • Published to the registry more recently than 7% of the other 6384 servers in this category
  • Basic checks equal to or better than 10% of the other 6384 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Hometeam Directory safe?

It passed 2 of 4 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed last month, and the latest version (1.2.0) reached the registry 7 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

by every-appWidely used★ 28.2KUpdated 5 days ago

Runs in the cloud✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

by exa-labsWidely used★ 5.2KUpdated 2 months ago

Runs in the cloud✓ service owner · exa.aiTried by the PopNx team

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

by MicrosoftDocsWidely used★ 2KUpdated 12 months ago

Runs in the cloud✓ service owner · microsoft.comTried by the PopNx team

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

by proxysoulGrowing★ 1.6KUpdated 2 months ago

Runs in the cloud✓ empryo.com
Compared with similar ones
This one
Hometeam Directory
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Runs whereRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoYesYesYesNoNo
Basic checks2/45/52/44/44/44/4
License–MITMITCC-BY-4.0NOASSERTIONApache-2.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

🏠 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/mcp

Connect with Claude Desktop

Add to your claude_desktop_config.json:

{

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

Available tools
ToolDescription
search_businessesSearch by keyword, category, neighborhood, or county
get_business_detailsGet full profile: hours, contact, reviews, specials
find_by_specialtyNatural language search ("someone to do box braids near Miramar")
list_categoriesAll 14 business categories
list_neighborhoodsNeighborhoods across Miami-Dade, Broward, Palm Beach
get_latest_draft_classNewest businesses added on Draft Day
Rate limits
TierLimitAccess
Free100 queries/dayNo API key needed
Pro10,000 queries/dayAPI 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/mcp" ] } } }

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
EndpointDescription
GET https://mcp.thehometeam.io/healthHealth check
POST https://mcp.thehometeam.io/mcpMCP JSON-RPC requests (Streamable HTTP)
Rate limits
TierLimitHow to access
Free100 queries/dayNo API key required
Pro10,000 queries/dayAPI key (coming soon — join the waitlist at https://www.thehometeam.io/developers)
Quick test
# 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/JajuanX/hometeam-mcp-server.git

cd 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 Streamable HTTP 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 console.error because stdio transport uses stdout for JSON-RPC communication.


Available tools

The MCP server exposes 6 tools that AI assistants can call:

search_businesses

Search the directory by keyword, category, neighborhood, or county.

{

"query": "jerk chicken", "county": "Broward", "limit": 5, "sort": "most_visited" }

Returns matching businesses with name, category, neighborhood, rating, contact info, and Hometeam profile link.


get_business_details

Get everything about a specific business — hours, contact, social media, reviews, current specials.

{ "slug": "keishas-kitchen" }

Or search by name:

{ "name": "Keisha's Kitchen" }

Returns the full business profile including recent reviews, active specials, and community trust signals.


find_by_specialty

The smart search. Describe what you need in plain English.

{ "need": "someone to do box braids for my daughter's birthday", "location": "Miramar" }
{ "need": "tax preparation for my small business", "location": "Palm Beach" }
{ "need": "a barber who can do a fresh fade", "location": "Overtown" }

Maps natural language to categories and searches intelligently. This is the tool most AI assistants reach for first.


list_categories

Returns all business categories in the directory. No parameters needed.

Categories: Restaurants & Food, Hair & Beauty, Health & Wellness, Home Services, Professional Services, Retail & Shopping, Auto Services, Education & Tutoring, Events & Entertainment, Fitness & Training, Technology & Media, Real Estate, Childcare & Family, Arts & Creative.


list_neighborhoods

Returns South Florida neighborhoods, optionally filtered by county.

{ "county": "Broward" }

Covers 29+ neighborhoods across Miami-Dade, Broward, and Palm Beach counties.


get_latest_draft_class

Returns the most recent Draft Class — the newest businesses to join Hometeam. No parameters needed.

Hometeam drafts new businesses monthly through community events. This tool lets AI assistants answer "what's new?" questions with real, timely data.


How it works

User asks AI: "Find me a Black-owned caterer in Broward"

│ ▼ AI assistant sees Hometeam MCP tools are available │ ▼ AI calls search_businesses({ query: "caterer", county: "Broward" }) │ ▼ Hometeam MCP server queries the live MongoDB database │ ▼ Returns real business data: name, location, rating, contact, hours │ ▼ AI presents the answer to the user with Hometeam attribution │ ▼ User visits the business. Community grows.

The data is always live — not a cached snapshot. When a business updates their hours or posts a special, the MCP server reflects it immediately.


Project structure

mcp-server/

├── server.js # Entry point (stdio transport — local/Claude Desktop) ├── httpServer.js # Streamable HTTP transport (deployed/remote access) ├── config/ │ └── db.js # MongoDB connection ├── models/ # Mongoose schemas (read-only, shared with backend DB) │ ├── Business.js │ ├── Category.js │ ├── Neighborhood.js │ ├── Review.js │ ├── Event.js │ ├── DraftClass.js │ └── McpUsage.js ├── tools/ # MCP tool definitions + handlers │ ├── searchBusinesses.js │ ├── getBusinessDetails.js │ ├── findBySpecialty.js │ ├── listCategories.js │ ├── listNeighborhoods.js │ └── getLatestDraftClass.js ├── middleware/ │ └── apiKeyAuth.js # API key validation (paid tier — coming soon) ├── utils/ │ └── logUsage.js # Query analytics logger ├── scripts/ │ └── release.js # Semantic version release script └── .env.example


Transport modes

Stdio (local)

For Claude Desktop and local development. Communicates via stdin/stdout using JSON-RPC.

npm run start:local

Critical: All logging uses console.error, not console.log. Stdout is reserved for the MCP protocol. Any console.log output corrupts the JSON-RPC stream and crashes the connection.

Streamable HTTP (deployed)

For production and remote AI agents. Express server with stateless Streamable HTTP at /mcp (also mounted at /). No API key is required. The legacy /sse and /messages routes are no longer available.

npm start

Starts on PORT (default 3100, Heroku assigns dynamically)

Endpoints:

MethodPathDescription
GET/healthHealth check
POST/mcp, /MCP JSON-RPC requests
GET/mcp, /Returns 405; use POST
DELETE/mcp, /Session cleanup acknowledgment

Developer workflow

Coding conventions

Defined in AGENTS.md at the project root (shared with the backend). Key rules:

  • ES Modules — import/export with .js extensions on all relative imports
  • Async/await throughout
  • `console.error` only — never console.log (breaks stdio transport)
  • Models — export default, read-only versions of backend schemas
  • Tools — each tool in its own file, exports schema + handler
Adding a new MCP tool
  1. Create mcp-server/tools/myNewTool.js with a schema and handler export:
   export const myNewToolSchema = {

description: 'What this tool does — written for an AI to understand when to use it', inputSchema: { type: 'object', properties: { param1: { type: 'string', description: 'What this parameter means' }, }, required: ['param1'], }, };

export const myNewToolHandler = async (args) => { // Query MongoDB, format results return { success: true, data: { args } }; };

  1. Register it in mcp-server/tools/index.js:
   import { myNewToolHandler, myNewToolSchema } from './myNewTool.js';

export const TOOL_DEFINITIONS = [ // existing tools... { name: 'my_new_tool', description: myNewToolSchema.description, inputSchema: myNewToolSchema.inputSchema, handler: myNewToolHandler, }, ];

  1. Restart the MCP server and test with Claude Desktop locally before deploying.
Branch strategy and commits

Same as the backend — feature branches, conventional commits:

feat: add business-hours-aware search tool

fix: correct category matching in find_by_specialty chore: update @modelcontextprotocol/sdk


Versioning and releases

Version lives in package.json and is served in the MCP server info and HTTP root endpoint.

# Bug fix (1.0.0 → 1.0.1)

npm run release:patch

New feature — e.g., new MCP tool (1.0.0 → 1.1.0)

npm run release:minor

Breaking change (1.0.0 → 2.0.0)

npm run release:major

The script: checks for clean working tree → bumps package.json → commits → creates git tag → pushes → Heroku auto-deploys.


Deployment

Heroku

The deployed version uses httpServer.js (Streamable HTTP), not server.js (stdio).

heroku login

heroku create hometeam-mcp

heroku config:set NODE_ENV=production heroku config:set MONGO_URI="your_mongodb_atlas_uri" heroku config:set MCP_SERVER_NAME="hometeam-directory" heroku config:set CORS_ORIGIN="*"

git push heroku main

Verify

curl https://mcp.thehometeam.io/health

Do not set PORT — Heroku assigns it. The Procfile runs node httpServer.js.

Verify tools are registered
curl https://mcp.thehometeam.io/mcp \

-H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -H 'MCP-Protocol-Version: 2025-06-18' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Response includes all 6 tool names in the result.tools array.

In Claude Desktop MCP logs, you should see:

tools/list → search_businesses, get_business_details, find_by_specialty,

list_categories, list_neighborhoods, get_latest_draft_class


Usage analytics

Every query is logged (anonymized) to the mcpusages MongoDB colle

Only the beginning is shown; read the rest in the repo