Opendirectories Mcp

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.

| Parameter | Type | Description | |-----------|------|-------------| | query | string | Business name or type | | country | string | ISO code: AU, US, UK, CA, NZ, SG, IE, FR | | directory | string | Directory ID (see list_directories) | | state | string | State/province code (e.g. NSW, CA, TX) | | suburb | string | Suburb or city name | | has_phone | bool | Only businesses with phone numbers | | min_rating | float | Minimum Google rating (0-5) | | limit | int | Results to return (1-50, default 10) |

get_business

Get full details for a business by its ID.

| Parameter | Type | Description | |-----------|------|-------------| | business_id | int | Unique business record ID | | directory | string | Optional directory to narrow search |

get_competitors

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

| Parameter | Type | Description | |-----------|------|-------------| | business_name | string | Business to find competitors for | | suburb | string | Suburb or city | | country | string | Country code (default AU) | | directory | string | Directory to search within | | limit | int | Results (1-20, default 10) |

market_density

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

| Parameter | Type | Description | |-----------|------|-------------| | category | string | Business type (e.g. dentist, plumber) | | state | string | State or province | | suburb | string | Suburb or city | | country | string | Country code (default AU) | | directory | string | Directory to search within |

verify_business

Verify a business against government registers with confidence scoring.

| Parameter | Type | Description | |-----------|------|-------------| | business_name | string | Business name to verify | | country | string | Country code (default AU) | | abn | string | Australian Business Number (optional) | | suburb | string | Suburb (optional, improves accuracy) |

list_directories

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

Data Sources

| Region | Source | Directories | |--------|--------|-------------| | Australia | ASIC, NDIS, ACECQA, ACNC | Financial advisers, mortgage brokers, childcare, aged care, charities, manufacturers, disability providers, commercial finance, local services | | United States | CMS, IRS | Healthcare providers, nonprofits, transport, education | | United Kingdom | Companies House | UK companies | | Canada | National register | Canadian businesses | | New Zealand | Charities Commission | NZ charities | | Singapore | ACRA | Singapore companies | | Ireland | CRO | Irish charities | | France | INSEE | French 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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: BigJai
• Source: BigJai/opendirectories-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.