{"id":"fe0a80ba-b0d5-4448-a2a4-058472acc0f7","slug":"opendirectories-mcp","kind":"mcp","name":"opendirectories-mcp","summary":"MCP server for 12M+ verified businesses across 10 countries. Government-sourced, Google Maps enriched. 6 tools for search, verification, competitor analysis, and market research.","owner":"BigJai","repoUrl":"https://github.com/BigJai/opendirectories-mcp","license":"MIT","licenseTier":"permissive","trust":"community","stars":0,"match":null,"fewStars":true,"format":"mcp","createdAt":"2026-03-02T03:47:36.000Z","addedAt":"2026-10-14T05:09:05.507Z","logoUrl":"https://avatars.githubusercontent.com/u/57034499?v=4","linkOnly":false,"collection":null,"skillPath":null,"categories":["cloud-infra","data-analytics","search"],"tags":["business-data","lead-generation"],"runtime":"python","local":true,"cloudCapable":false,"cloudCapability":"unknown","cloudReadyOnPlatform":false,"needsApiKey":false,"reviewed":false,"syncedAt":"2026-10-17T12:59:55.642Z","sample":false,"url":"https://conduits.dev/tools/opendirectories-mcp","language":"Python","transports":["stdio"],"install":{"pypi":"opendirectories-mcp"},"requirements":{"env":[{"name":"APAC_SUPABASE_URL","secret":false,"required":false,"description":"APAC Supabase URL"},{"name":"APAC_SUPABASE_KEY","secret":true,"required":false,"description":"APAC Supabase anon key"},{"name":"US_SUPABASE_URL","secret":false,"required":false,"description":"US Supabase URL"},{"name":"US_SUPABASE_KEY","secret":true,"required":false,"description":"US Supabase anon key"},{"name":"EU_SUPABASE_URL","secret":false,"required":false,"description":"EU Supabase URL"},{"name":"EU_SUPABASE_KEY","secret":true,"required":false,"description":"EU Supabase anon key"}],"upstreamMayCharge":false},"tools":null,"readme":"<!-- mcp-name: io.github.BigJai/opendirectories-business-data -->\n\n# OpenDirectories MCP Server\n\nSearch **12M+ verified businesses** across **10 countries** and **19 directories** via the Model Context Protocol.\n\nAll data sourced from government registers and enriched with Google Maps ratings and AI descriptions.\n\n## Quick Start\n\n### Hosted (zero setup)\n\nAdd to your MCP client config (Claude Desktop, Cline, Cursor, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"opendirectories\": {\n      \"url\": \"https://secure-wave--opendirectories-business-data.apify.actor/mcp\"\n    }\n  }\n}\n```\n\n### Install via PyPI\n\n```bash\npip install opendirectories-mcp\n```\n\n```json\n{\n  \"mcpServers\": {\n    \"opendirectories\": {\n      \"command\": \"opendirectories-mcp\",\n      \"env\": {\n        \"APAC_SUPABASE_URL\": \"https://your-instance.supabase.co\",\n        \"APAC_SUPABASE_KEY\": \"your-anon-key\",\n        \"US_SUPABASE_URL\": \"https://your-instance.supabase.co\",\n        \"US_SUPABASE_KEY\": \"your-anon-key\",\n        \"EU_SUPABASE_URL\": \"https://your-instance.supabase.co\",\n        \"EU_SUPABASE_KEY\": \"your-anon-key\"\n      }\n    }\n  }\n}\n```\n\n## Tools\n\n### `search_businesses`\n\nSearch across all records with rich filters.\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `query` | string | Business name or type |\n| `country` | string | ISO code: AU, US, UK, CA, NZ, SG, IE, FR |\n| `directory` | string | Directory ID (see `list_directories`) |\n| `state` | string | State/province code (e.g. NSW, CA, TX) |\n| `suburb` | string | Suburb or city name |\n| `has_phone` | bool | Only businesses with phone numbers |\n| `min_rating` | float | Minimum Google rating (0-5) |\n| `limit` | int | Results to return (1-50, default 10) |\n\n### `get_business`\n\nGet full details for a business by its ID.\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `business_id` | int | Unique business record ID |\n| `directory` | string | Optional directory to narrow search |\n\n### `get_competitors`\n\nFind competitors near a business location, ranked by quality score.\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `business_name` | string | Business to find competitors for |\n| `suburb` | string | Suburb or city |\n| `country` | string | Country code (default AU) |\n| `directory` | string | Directory to search within |\n| `limit` | int | Results (1-20, default 10) |\n\n### `market_density`\n\nAnalyse market saturation with rating distributions, digital presence metrics, and top-rated providers.\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `category` | string | Business type (e.g. dentist, plumber) |\n| `state` | string | State or province |\n| `suburb` | string | Suburb or city |\n| `country` | string | Country code (default AU) |\n| `directory` | string | Directory to search within |\n\n### `verify_business`\n\nVerify a business against government registers with confidence scoring.\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `business_name` | string | Business name to verify |\n| `country` | string | Country code (default AU) |\n| `abn` | string | Australian Business Number (optional) |\n| `suburb` | string | Suburb (optional, improves accuracy) |\n\n### `list_directories`\n\nReturns all 19 directories with country and region metadata. No parameters.\n\n## Data Sources\n\n| Region | Source | Directories |\n|--------|--------|-------------|\n| Australia | ASIC, NDIS, ACECQA, ACNC | Financial advisers, mortgage brokers, childcare, aged care, charities, manufacturers, disability providers, commercial finance, local services |\n| United States | CMS, IRS | Healthcare providers, nonprofits, transport, education |\n| United Kingdom | Companies House | UK companies |\n| Canada | National register | Canadian businesses |\n| New Zealand | Charities Commission | NZ charities |\n| Singapore | ACRA | Singapore companies |\n| Ireland | CRO | Irish charities |\n| France | INSEE | French enterprises |\n\n## Coverage\n\n- **12,160,000+** verified business records\n- **19** specialised directories\n- **10** countries (AU, US, UK, CA, NZ, SG, IE, FR + growing)\n- **3** regional databases (APAC, US, EU)\n- Google Maps ratings and review counts\n- AI-generated business descriptions\n\n## Use Cases\n\n- **Lead generation** — Find businesses by category, location, and quality score\n- **Competitive analysis** — Map competitors in any suburb or city\n- **Market research** — Analyse density, ratings, and digital presence\n- **Business verification (KYB)** — Verify against government registers\n- **Franchise expansion** — Identify underserved markets\n\n## Self-Hosting\n\nSet environment variables for your Supabase instances:\n\n```bash\nexport APAC_SUPABASE_URL=https://your-instance.supabase.co\nexport APAC_SUPABASE_KEY=your-anon-key\nexport US_SUPABASE_URL=https://your-instance.supabase.co\nexport US_SUPABASE_KEY=your-anon-key\nexport EU_SUPABASE_URL=https://your-instance.supabase.co\nexport EU_SUPABASE_KEY=your-anon-key\nexport PORT=5001\n\nopendirectories-mcp\n```\n\nOr use Docker:\n\n```bash\ndocker run -p 5001:5001 \\\n  -e APAC_SUPABASE_URL=... \\\n  -e APAC_SUPABASE_KEY=... \\\n  ghcr.io/bigjai/opendirectories-mcp\n```\n\n## License\n\nMIT\n"}