OpenDirectories MCP Server

Search 12M+ verified businesses across 10 countries and 19 directories via the Model Context Protocol.

All data sourced from government registers and enriched with Google Maps ratings and AI descriptions.

Quick Start

Hosted (zero setup)

Add to your MCP client config (Claude Desktop, Cline, Cursor, etc.):

{
  "mcpServers": {
    "opendirectories": {
      "url": "https://secure-wave--opendirectories-business-data.apify.actor/mcp"
    }
  }
}

Install via PyPI

pip install opendirectories-mcp

{
  "mcpServers": {
    "opendirectories": {
      "command": "opendirectories-mcp",
      "env": {
        "APAC_SUPABASE_URL": "https://your-instance.supabase.co",
        "APAC_SUPABASE_KEY": "your-anon-key",
        "US_SUPABASE_URL": "https://your-instance.supabase.co",
        "US_SUPABASE_KEY": "your-anon-key",
        "EU_SUPABASE_URL": "https://your-instance.supabase.co",
        "EU_SUPABASE_KEY": "your-anon-key"
      }
    }
  }
}

Tools

search_businesses

Search across all records with rich filters.

get_business

Get full details for a business by its ID.

get_competitors

Find competitors near a business location, ranked by quality score.

market_density

Analyse market saturation with rating distributions, digital presence metrics, and top-rated providers.

verify_business

Verify a business against government registers with confidence scoring.

list_directories

Returns all 19 directories with country and region metadata. No parameters.

Data Sources

Coverage

• 12,160,000+ verified business records
• 19 specialised directories
• 10 countries (AU, US, UK, CA, NZ, SG, IE, FR + growing)
• 3 regional databases (APAC, US, EU)
• Google Maps ratings and review counts
• AI-generated business descriptions

Use Cases

• Lead generation — Find businesses by category, location, and quality score
• Competitive analysis — Map competitors in any suburb or city
• Market research — Analyse density, ratings, and digital presence
• Business verification (KYB) — Verify against government registers
• Franchise expansion — Identify underserved markets

Self-Hosting

Set environment variables for your Supabase instances:

export APAC_SUPABASE_URL=https://your-instance.supabase.co
export APAC_SUPABASE_KEY=your-anon-key
export US_SUPABASE_URL=https://your-instance.supabase.co
export US_SUPABASE_KEY=your-anon-key
export EU_SUPABASE_URL=https://your-instance.supabase.co
export EU_SUPABASE_KEY=your-anon-key
export PORT=5001

opendirectories-mcp

Or use Docker:

docker run -p 5001:5001 \
  -e APAC_SUPABASE_URL=... \
  -e APAC_SUPABASE_KEY=... \
  ghcr.io/bigjai/opendirectories-mcp

License

MIT