# Opendirectories Mcp

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-bigjai-opendirectories-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [BigJai](https://agentstack.voostack.com/s/bigjai)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [BigJai](https://github.com/BigJai)
- **Source:** https://github.com/BigJai/opendirectories-mcp

## Install

```sh
agentstack add mcp-bigjai-opendirectories-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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.):

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

### Install via PyPI

```bash
pip install opendirectories-mcp
```

```json
{
  "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:

```bash
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:

```bash
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](https://github.com/BigJai)
- **Source:** [BigJai/opendirectories-mcp](https://github.com/BigJai/opendirectories-mcp)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-bigjai-opendirectories-mcp
- Seller: https://agentstack.voostack.com/s/bigjai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.