English Français العربية

io.github.BigJai/opendirectories-business-data

Official registry Government and legal

Search 12M+ verified businesses across 10 countries via government registers.

Source code Documentation

What can you do with io.github.BigJai/opendirectories-business-data?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http opendirectories-business-data 'https://secure-wave--opendirectories-business-data.apify.actor/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "opendirectories-business-data": {
            "type": "http",
            "url": "https://secure-wave--opendirectories-business-data.apify.actor/mcp"
        }
    }
}
PYPI package opendirectories-mcp
Claude Code 
claude mcp add opendirectories-business-data -e 'APAC_SUPABASE_URL=<APAC_SUPABASE_URL>' -e 'APAC_SUPABASE_KEY=<your apac_supabase_key>' -e 'US_SUPABASE_URL=<US_SUPABASE_URL>' -e 'US_SUPABASE_KEY=<your us_supabase_key>' -e 'EU_SUPABASE_URL=<EU_SUPABASE_URL>' -e 'EU_SUPABASE_KEY=<your eu_supabase_key>' -- uvx opendirectories-mcp==0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "opendirectories-business-data": {
            "command": "uvx",
            "args": [
                "opendirectories-mcp==0.1.0"
            ],
            "env": {
                "APAC_SUPABASE_URL": "<APAC_SUPABASE_URL>",
                "APAC_SUPABASE_KEY": "<your apac_supabase_key>",
                "US_SUPABASE_URL": "<US_SUPABASE_URL>",
                "US_SUPABASE_KEY": "<your us_supabase_key>",
                "EU_SUPABASE_URL": "<EU_SUPABASE_URL>",
                "EU_SUPABASE_KEY": "<your eu_supabase_key>"
            }
        }
    }
}

Environment variables

  • APAC_SUPABASE_URL APAC Supabase URL
  • APAC_SUPABASE_KEY secret APAC Supabase anon key
  • US_SUPABASE_URL US Supabase URL
  • US_SUPABASE_KEY secret US Supabase anon key
  • EU_SUPABASE_URL EU Supabase URL
  • EU_SUPABASE_KEY secret EU Supabase anon key

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. OpenDirectories MCP Server
  2. Quick Start
  3. Tools
  4. Data Sources
  5. Coverage
  6. Use Cases
  7. Self-Hosting
  8. License

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.

ParameterTypeDescription
querystringBusiness name or type
countrystringISO code: AU, US, UK, CA, NZ, SG, IE, FR
directorystringDirectory ID (see list_directories)
statestringState/province code (e.g. NSW, CA, TX)
suburbstringSuburb or city name
has_phoneboolOnly businesses with phone numbers
min_ratingfloatMinimum Google rating (0-5)
limitintResults to return (1-50, default 10)
get_business

Get full details for a business by its ID.

ParameterTypeDescription
business_idintUnique business record ID
directorystringOptional directory to narrow search
get_competitors

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

ParameterTypeDescription
business_namestringBusiness to find competitors for
suburbstringSuburb or city
countrystringCountry code (default AU)
directorystringDirectory to search within
limitintResults (1-20, default 10)
market_density

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

ParameterTypeDescription
categorystringBusiness type (e.g. dentist, plumber)
statestringState or province
suburbstringSuburb or city
countrystringCountry code (default AU)
directorystringDirectory to search within
verify_business

Verify a business against government registers with confidence scoring.

ParameterTypeDescription
business_namestringBusiness name to verify
countrystringCountry code (default AU)
abnstringAustralian Business Number (optional)
suburbstringSuburb (optional, improves accuracy)
list_directories

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

Data Sources

RegionSourceDirectories
AustraliaASIC, NDIS, ACECQA, ACNCFinancial advisers, mortgage brokers, childcare, aged care, charities, manufacturers, disability providers, commercial finance, local services
United StatesCMS, IRSHealthcare providers, nonprofits, transport, education
United KingdomCompanies HouseUK companies
CanadaNational registerCanadian businesses
New ZealandCharities CommissionNZ charities
SingaporeACRASingapore companies
IrelandCROIrish charities
FranceINSEEFrench enterprises

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

Frequently asked questions

What is io.github.BigJai/opendirectories-business-data?

Search 12M+ verified businesses across 10 countries via government registers.

How do I install io.github.BigJai/opendirectories-business-data?

It runs as a remote server. In Claude Code: claude mcp add --transport http opendirectories-business-data 'https://secure-wave--opendirectories-business-data.apify.actor/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.BigJai/opendirectories-business-data need an API key?

Yes. It expects APAC_SUPABASE_KEY, US_SUPABASE_KEY, EU_SUPABASE_KEY, which you set in its configuration.

Is io.github.BigJai/opendirectories-business-data open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.BigJai/opendirectories-business-data?

It is published by BigJai. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.