Brilliant Directories API — Universal AI Integration

Give any AI agent full access to your Brilliant Directories site with one API key.

Manage members, posts (single-image and multi-image), leads, reviews, top and sub categories, email templates, pages (homepage, landing pages), 301 redirects, smart lists, widgets, menus, forms, tags, membership plans, and more — across every resource BD exposes via its REST API.

30-Second Quickstart

One command. Answer two questions. Done.

npx brilliant-directories-mcp --setup

The wizard asks for your BD site URL and API key, tests the connection, asks which app you use (Cursor / Claude Desktop / Windsurf / Claude Code), and writes the config for you. No JSON editing.

Restart your app, then ask your AI:

"List members on my BD site"

Get your API key from BD Admin > Developer Hub > Generate API Key.

For AI agents / scripts (non-interactive)

If an AI agent is guiding you, it can have you paste a single command with everything prefilled:

npx brilliant-directories-mcp --setup --url https://your-site.com --api-key YOUR_KEY --client cursor

This runs the full setup end-to-end with no prompts. Replace cursor with claude-desktop, windsurf, claude-code, or print (prints the JSON config instead of writing a file).

Setup by Platform

Claude Code / Cursor / Windsurf / Cline (MCP)

Option A — npx (recommended, no install needed):

claude mcp add bd-api -- npx brilliant-directories-mcp --api-key YOUR_KEY --url https://your-site.com

Option B — Global install:

npm install -g brilliant-directories-mcp
claude mcp add bd-api -- brilliant-directories-mcp --api-key YOUR_KEY --url https://your-site.com

Cursor / Windsurf / Cline — add to your MCP config file (~/.cursor/mcp.json, etc.):

{
  "mcpServers": {
    "bd-api": {
      "command": "npx",
      "args": ["-y", "brilliant-directories-mcp", "--api-key", "YOUR_KEY", "--url", "https://your-site.com"]
    }
  }
}

Then ask your AI: "List all members on my BD site" or "Create a new member with email john@example.com"

ChatGPT (GPT Actions)

1. In your GPT: Configure > Actions > Create new action
2. Under Schema, choose Import from URL and paste:

   https://raw.githubusercontent.com/brilliantdirectories/brilliant-directories-mcp/main/openapi/bd-api.json
   

3. When prompted for bd_site_url, enter your BD site (e.g., https://mysite.com)
4. Set Authentication: API Key, Auth Type: Custom, Header Name: X-Api-Key, paste your key

n8n

Option A — Import OpenAPI spec (recommended):

Import the spec URL as a custom API definition:

https://raw.githubusercontent.com/brilliantdirectories/brilliant-directories-mcp/main/openapi/bd-api.json

n8n will prompt for your BD site URL and API key on import. No file editing required.

Option B — Plain HTTP Request node:

1. Create a new workflow, add an HTTP Request node
2. Set:
   • Method: GET
   • URL: https://your-site.com/api/v2/user/get
   • Header: X-Api-Key: YOUR_KEY

Make / Zapier

Make: Create a custom app using the OpenAPI spec, or use HTTP module with X-Api-Key header.

Zapier: If you already have the BD Zapier app, it uses the same underlying API. For new endpoints, use Webhooks by Zapier with the X-Api-Key header.

curl / Any HTTP Client

# Verify your API key
curl -H "X-Api-Key: YOUR_KEY" https://your-site.com/api/v2/token/verify

# List members
curl -H "X-Api-Key: YOUR_KEY" https://your-site.com/api/v2/user/get?li

... [View full README on GitHub](https://github.com/brilliantdirectories/brilliant-directories-mcp#readme)