# Brilliant Directories — how to use (mcp.ai)

Connect your Brilliant Directories account and use 44 tools for website builders straight from your AI agent. Connect with your own API key. Brilliant Directories is an all-in-one platform that enables users to create and manage online membership communities and business directories.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_brilliant_directories?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `brilliant_directories_create_album_photo`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/brilliant_directories`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/brilliant_directories/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/brilliant_directories/create/album/photo` — Tool to add a new album photo to a user's portfolio in Brilliant Directories. Use when you need to upload or create a photo entry in a user's album. Required fields are user_id (the owner of the album
  - body: { desc?: string, file?: string, link?: string, order?: integer, price?: number, title: string, inv_id?: string, status?: integer, data_id?: integer, orgfile?: string, room_id?: integer, user_id: integer, group_id?: integer, keywords?: string, condition?: string, data_type?: integer, thumbnail?: string, group_cover?: integer, photo_token?: string, availability?: string, manufacturer?: string, product_type?: string, image_imported?: string, photo_filename?: string, reason_inactive?: string, photo_date_added?: string, product_category?: string, additional_fields?: string, facebook_photo_id?: string, original_image_url?: string, photo_date_updated?: string }
- `POST https://api.mcp.ai/api/brilliant_directories/create/data/category` — Creates a new data category (post type) in the Brilliant Directories website database. Post types are content types like Videos, Articles, Jobs, Events, Coupons, Classifieds, etc. Required fields: dat
  - body: { h1?: string, h2?: string, icon?: string, data_id?: integer, comments?: string, per_page?: integer, always_on?: integer, data_name: string, data_type: integer, form_name: string, post_date?: string, post_type?: string, data_active?: string, profile_tab?: string, system_name: string, category_sql?: string, category_tab?: string, comments_code?: string, data_filename: string, display_order?: integer, caption_length?: integer, category_group?: integer, footer_content?: string, profile_footer?: string, profile_header?: string, search_results?: string, category_footer?: string, category_header?: string, comments_header?: string, distance_search?: integer, profile_sidebar?: string, category_sidebar?: string, profile_order_by?: string, profile_per_page?: integer, software_version?: integer, category_order_by?: string, feature_categories?: string, revision_timestamp?: string, search_results_div?: string, profile_display_order?: integer, search_results_layout?: string, sidebar_search_module?: string, profile_results_layout?: string }
- `POST https://api.mcp.ai/api/brilliant_directories/create/data/post` — Tool to create a new Single Image Post (member post) in the Brilliant Directories database. Use when adding blog posts, articles, or other content types with images to the website. Required fields: po
  - body: { lat?: number, lon?: number, data_id: integer, user_id: integer, state_sn?: string, data_type: integer, post_tags?: string, post_type?: string, country_sn?: string, post_image?: string, post_title: string, post_token?: string, post_author?: string, post_clicks?: integer, post_status: integer, sticky_post?: integer, auto_geocode?: string, post_content: string, post_category?: string, post_filename?: string, image_imported?: integer, post_live_date?: string, recurring_type?: integer, revision_count?: integer, post_start_date?: string, post_expire_date?: string, auto_image_import?: string, original_image_url?: string, revision_timestamp?: string, sticky_post_expiration_date?: string }
- `POST https://api.mcp.ai/api/brilliant_directories/create/lead` — Tool to create a new lead in the Brilliant Directories database. Use when adding new inquiries or contact requests from visitors. Supports automatic geocoding, member matching, and email notifications
  - body: { lat?: number, lng?: number, nelat?: number, nelng?: number, swlat?: number, swlng?: number, status?: integer, sub_id?: integer, top_id?: integer, lead_id?: integer, formname?: string, url_from?: string, lead_name?: string, origin_ip?: string, auto_match?: string, country_sn?: string, date_added?: string, lead_email?: string, lead_notes?: string, lead_phone?: string, lead_price?: number, sub_sub_id?: integer, flow_source?: string, adm_lvl_1_sn?: string, auto_geocode?: string, lead_message?: string, lead_location?: string, location_type?: string, users_to_match?: string, sub_category_name?: string, top_category_name?: string, revision_timestamp?: string, sub_sub_category_name?: string, send_lead_email_notification?: string }
- `POST https://api.mcp.ai/api/brilliant_directories/create/portfolio/group` — Creates a new multi-image portfolio post in the Brilliant Directories database. This action allows users to publish content with multiple images, descriptions, and metadata such as categories, tags, a
  - body: { data_id: integer, user_id: integer, state_sn?: string, data_type: integer, post_tags?: string, country_sn?: string, group_desc?: string, group_name: string, post_image?: string, group_order?: integer, group_token?: string, sticky_post?: string, auto_geocode?: string, date_updated?: string, group_status?: integer, property_beds?: integer, property_type?: integer, group_category?: string, group_filename?: string, group_location?: string, property_baths?: integer, property_price?: integer, revision_count?: integer, property_status?: integer, post_image_title?: string, auto_image_import?: string, property_sqr_foot?: integer, post_image_description?: string, sticky_post_expiration_date?: string }
- `POST https://api.mcp.ai/api/brilliant_directories/create/unsubscribe` — Tool to add an unsubscriber to the database and unsubscribe a member from email campaigns. Use when you need to remove a member's email address from the email campaign list. Requires email address, co
  - body: { id?: integer, code: string, date?: integer, type: string, email: string, definitive?: integer, website_id: integer }
- `POST https://api.mcp.ai/api/brilliant_directories/create/user` — Creates a new user/member account in the Brilliant Directories website database. Required fields: email, password (minimum 6 characters), and subscription_id (must reference an existing membership pla
  - body: { city?: string, email: string, active?: integer, company?: string, website?: string, about_me?: string, address1?: string, address2?: string, password: string, position?: string, verified?: integer, zip_code?: string, last_name?: string, first_name?: string, state_code?: string, country_code?: string, phone_number?: string, subscription_id: integer }
- `POST https://api.mcp.ai/api/brilliant_directories/create/users/click` — Tool to add a new user clicked link tracking record to the database. Creates a click tracking entry that records when and where users click on links within the directory. Required fields: click_url, c
  - body: { post_id?: integer, user_id: integer, click_id?: integer, click_ip?: string, click_url: string, click_from: string, click_name: string, click_type: string, click_token?: string, date_clicked: string, visitor_token?: string, is_single_post?: integer }
- `POST https://api.mcp.ai/api/brilliant_directories/create/widget` — Tool to create a new widget in the Brilliant Directories website database. Use when you need to add custom HTML/PHP content, CSS styles, or JavaScript to create a reusable widget component.
  - body: { widget_data?: string, widget_name: string, widget_style?: string, widget_javascript?: string }
- `POST https://api.mcp.ai/api/brilliant_directories/delete/album/photo` — Tool to delete an album photo and its related data from the database. Use when you need to permanently remove a photo from a user's portfolio album.
  - body: { photo_id: integer }
- `POST https://api.mcp.ai/api/brilliant_directories/delete/data/category` — Tool to permanently delete a post type (data category) and all related data from the database. Use when you need to completely remove a post type such as Videos, Articles, Jobs, Events, Coupons, Audio
  - body: { data_id: integer }
- `POST https://api.mcp.ai/api/brilliant_directories/delete/lead` — Tool to delete a lead and their related data from the database. Use when you need to permanently remove a lead record.
  - body: { lead_id: integer }
- `POST https://api.mcp.ai/api/brilliant_directories/delete/portfolio/group` — Tool to delete a multi-image post (portfolio group) and its related data from the database. Use when you need to permanently remove a portfolio group/multi-image post.
  - body: { group_id: integer }
- `POST https://api.mcp.ai/api/brilliant_directories/delete/unsubscribe` — Tool to delete an unsubscribe record and its related data from the database. Use when you need to remove an email from the unsubscribe list.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/brilliant_directories/delete/user` — This tool deletes an existing user record from the Brilliant Directories website database. It allows for the complete removal of a user record and, optionally, the deletion of the member's uploaded im
  - body: { user_id: string, delete_images?: integer }
- `POST https://api.mcp.ai/api/brilliant_directories/delete/users/click` — Tool to delete a user clicked link and their related data from the database. Permanently removes a click record identified by click_id.
  - body: { click_id: integer }
- `POST https://api.mcp.ai/api/brilliant_directories/delete/widget` — Tool to delete a widget and its related data from the database. Use when you need to permanently remove a widget. This is a destructive operation that cannot be undone.
  - body: { widget_id: integer }
- `POST https://api.mcp.ai/api/brilliant_directories/get/album/photo` — Retrieves the complete metadata and details for a single album image from Brilliant Directories. This action fetches comprehensive information about an album photo including its title, description, fi
  - body: { photo_id: string }
- `POST https://api.mcp.ai/api/brilliant_directories/get/data/categories` — This tool retrieves all available custom fields for Data Categories (Post Types) in a Brilliant Directories website. Data categories/post types include content types like Videos, Articles, Jobs, Event
- `POST https://api.mcp.ai/api/brilliant_directories/get/data/category` — Tool to retrieve configuration data for a single post type (data category) in Brilliant Directories. Post types include content types like Videos, Articles, Jobs, Events, Coupons, Audios, and Discussi
  - body: { data_id: string }
- `POST https://api.mcp.ai/api/brilliant_directories/get/data/post` — Tool to retrieve a single image/video post from the Brilliant Directories member posts system. Use this action when you need to read the complete data and metadata for a specific post based on its pos
  - body: { post_id: string }
- `POST https://api.mcp.ai/api/brilliant_directories/get/lead` — Tool to retrieve a single lead's complete information from Brilliant Directories. Use when you need to fetch detailed data about a specific lead by its ID.
  - body: { lead_id: string }
- `POST https://api.mcp.ai/api/brilliant_directories/get/lead/fields` — This tool retrieves all available fields in the leads table from a Brilliant Directories website. It returns a JSON object containing a list of fields and their associated metadata (field name, field 
- `POST https://api.mcp.ai/api/brilliant_directories/get/portfolio/group` — Tool to retrieve multi-image post data by group_id. Use when you need to fetch content and metadata for a specific portfolio group or multi-image post. Returns comprehensive information including imag
  - body: { group_id: string }
- `POST https://api.mcp.ai/api/brilliant_directories/get/review` — Tool to retrieve complete review data from Brilliant Directories based on review_id. Use when you need to read full review details including content, ratings, reviewer info, and timestamps.
  - body: { review_id: string }
- `POST https://api.mcp.ai/api/brilliant_directories/get/reviews/fields` — Get metadata about all available fields in the users_reviews table from a Brilliant Directories website. This tool returns comprehensive field definitions for the reviews system, including: - Core rev
- `POST https://api.mcp.ai/api/brilliant_directories/get/unsubscribe` — Tool to retrieve a single unsubscriber record by ID. Use when you need to get details about a specific unsubscribe entry, including the email address, unsubscribe date, and source (admin, email link, 
  - body: { id: string }
- `POST https://api.mcp.ai/api/brilliant_directories/get/user` — Tool to retrieve comprehensive data for a single user by their user_id. Use when you need to fetch complete user profile information including contact details, subscription data, and membership inform
  - body: { user_id: string }
- `POST https://api.mcp.ai/api/brilliant_directories/get/user/fields` — Retrieves comprehensive user data from the Brilliant Directories database by searching for a specific property value. This action queries the users_data table using a property (column name) and value 
  - body: { property?: string, property_value: string }
- `POST https://api.mcp.ai/api/brilliant_directories/get/user/transactions` — Retrieves payment and transaction history for a member in Brilliant Directories. This action queries transaction records using either user_id or client_id, returning detailed payment history including
  - body: { user_id: integer, client_id: integer, return_schema?: string }
- `POST https://api.mcp.ai/api/brilliant_directories/get/users/click` — Tool to retrieve click tracking data for a single user clicked link based on the click_id. Use when you need to fetch detailed information about a specific click event, including the user who clicked,
  - body: { click_id: string }
- `POST https://api.mcp.ai/api/brilliant_directories/get/widget` — Retrieves the data of a single widget based on the widget_id. Use this to fetch widget configuration and settings from the Brilliant Directories website database.
  - body: { widget_id: string }
- `POST https://api.mcp.ai/api/brilliant_directories/match/leads` — Tool to match a batch of emails or user IDs to a specific lead record. Use this when you need to associate multiple contacts or users with an existing lead in the Brilliant Directories system. The use
  - body: { lead_id: integer, users_to_match: string }
- `POST https://api.mcp.ai/api/brilliant_directories/search/reviews` — Search reviews and their related data from the database. Filter reviews by various criteria. Supports filtering by location (address), keyword search (q), overall rating, and pagination (page, limit).
  - body: { q?: string, page?: integer, limit?: integer, address?: string, output_type?: string, overall_rating?: integer, category_order_by?: string, search_priority_flag?: integer, post_type_cache_system?: integer }
- `POST https://api.mcp.ai/api/brilliant_directories/search/users` — Search for users/members in the Brilliant Directories database with advanced filtering options. Allows searching and filtering members by keywords, location, categories, and other criteria. Supports p
  - body: { q?: string, pid?: integer, tid?: integer, page?: integer, sort?: string, ttid?: integer, limit?: integer, address?: string, dynamic?: integer, output_type?: string }
- `POST https://api.mcp.ai/api/brilliant_directories/update/album/photo` — Updates an existing album photo record in the Brilliant Directories database. Modifies photo metadata such as title, description, keywords, and status. The photo_id is required to identify which photo
  - body: { desc?: string, file?: string, link?: string, order?: integer, price?: number, title?: string, inv_id?: string, status?: integer, data_id?: integer, orgfile?: string, room_id?: integer, user_id?: integer, group_id?: integer, keywords?: string, photo_id: integer, condition?: string, data_type?: integer, thumbnail?: string, group_cover?: integer, photo_token?: string, availability?: string, manufacturer?: string, product_type?: string, image_imported?: string, photo_filename?: string, reason_inactive?: string, photo_date_added?: string, product_category?: string, additional_fields?: string, facebook_photo_id?: string, original_image_url?: string, photo_date_updated?: string }
- `POST https://api.mcp.ai/api/brilliant_directories/update/data/category` — Tool to update an existing post type (data category) record in Brilliant Directories. Use when you need to modify post type settings such as name, display options, layout templates, pagination setting
  - body: { h1?: string, h2?: string, icon?: string, data_id: integer, comments?: string, per_page?: integer, always_on?: integer, data_name?: string, data_type?: integer, form_name?: string, post_date?: string, post_type?: string, data_active?: string, profile_tab?: string, system_name?: string, category_sql?: string, category_tab?: string, comments_code?: string, data_filename?: string, display_order?: integer, caption_length?: integer, category_group?: integer, footer_content?: string, profile_footer?: string, profile_header?: string, search_results?: string, category_footer?: string, category_header?: string, comments_header?: string, distance_search?: integer, profile_sidebar?: string, category_sidebar?: string, profile_order_by?: string, profile_per_page?: integer, software_version?: integer, category_order_by?: string, feature_categories?: string, revision_timestamp?: string, search_results_div?: string, profile_display_order?: integer, search_results_layout?: string, sidebar_search_module?: string, profile_results_layout?: string }
- `POST https://api.mcp.ai/api/brilliant_directories/update/data/post` — Updates a single image post record and related data in the Brilliant Directories database. Use this action to modify existing post content including title, content, status, metadata, and other post-re
  - body: { lat?: number, lon?: number, data_id?: integer, post_id: integer, user_id?: integer, state_sn?: string, data_type?: integer, post_tags?: string, post_type?: string, country_sn?: string, post_image?: string, post_title?: string, post_token?: string, post_author?: string, post_clicks?: integer, post_status?: integer, sticky_post?: integer, auto_geocode?: integer, post_content?: string, post_category?: string, post_filename?: string, image_imported?: integer, post_live_date?: string, recurring_type?: integer, revision_count?: integer, post_start_date?: string, post_expire_date?: string, auto_image_import?: integer, original_image_url?: string, revision_timestamp?: string, sticky_post_expiration_date?: string }
- `POST https://api.mcp.ai/api/brilliant_directories/update/lead` — Updates an existing lead record in the Brilliant Directories website database. The lead_id field is required to identify which lead to update. All other fields are optional - only provide the fields y
  - body: { lat?: number, lng?: number, nelat?: number, nelng?: number, swlat?: number, swlng?: number, status?: integer, sub_id?: integer, top_id?: integer, lead_id: integer, formname?: string, url_from?: string, lead_name?: string, origin_ip?: string, auto_match?: string, country_sn?: string, date_added?: string, lead_email?: string, lead_notes?: string, lead_phone?: string, lead_price?: number, sub_sub_id?: integer, flow_source?: string, adm_lvl_1_sn?: string, auto_geocode?: string, lead_message?: string, lead_location?: string, location_type?: string, users_to_match?: string, sub_category_name?: string, top_category_name?: string, revision_timestamp?: string, sub_sub_category_name?: string, send_lead_email_notification?: string }
- `POST https://api.mcp.ai/api/brilliant_directories/update/portfolio/group` — Tool to update a multi-image post (portfolio group) record in the Brilliant Directories database. Use when you need to modify existing portfolio content, change post details, update images, or modify 
  - body: { data_id?: integer, user_id?: integer, group_id: integer, state_sn?: string, data_type?: integer, post_tags?: string, country_sn?: string, group_desc?: string, group_name?: string, post_image?: string, group_order?: integer, group_token?: string, sticky_post?: integer, auto_geocode?: string, date_updated?: string, group_status?: integer, property_beds?: integer, property_type?: integer, group_category?: string, group_filename?: string, group_location?: string, property_baths?: integer, property_price?: integer, revision_count?: integer, property_status?: integer, post_image_title?: string, auto_image_import?: string, property_sqr_foot?: integer, post_image_description?: string, sticky_post_expiration_date?: string }
- `POST https://api.mcp.ai/api/brilliant_directories/update/unsubscribe` — Updates an existing unsubscribe list record in the Brilliant Directories database. Use this to modify unsubscribe settings for email campaigns.
  - body: { id: integer, code: string, date: integer, type: string, email: string, definitive: integer, website_id: integer }
- `POST https://api.mcp.ai/api/brilliant_directories/update/user` — Updates an existing user record in the Brilliant Directories website database. Modifies user profile information, contact details, social media links, account status, membership plan, and other user-r
  - body: { cv?: string, lat?: number, lon?: number, blog?: string, city?: string, logo?: string, email?: string, quote?: string, active?: string, awards?: string, company?: string, modtime?: string, twitter?: string, user_id: integer, website?: string, youtube?: string, about_me?: string, address1?: string, address2?: string, facebook?: string, featured?: integer, linkedin?: string, password?: string, position?: string, services?: string, snapchat?: string, state_ln?: string, verified?: integer, whatsapp?: string, zip_code?: string, google_id?: string, instagram?: string, last_name?: string, pinterest?: string, country_ln?: string, experience?: integer, first_name?: string, last_login?: string, nationwide?: integer, state_code?: string, affiliation?: string, cover_photo?: string, credentials?: string, facebook_id?: string, member_tags?: string, rep_matters?: string, signup_date?: string, auto_geocode?: string, country_code?: string, listing_type?: string, phone_number?: string, credit_action?: string, credit_amount?: number, images_action?: string, profession_id?: integer, profile_photo?: string, subscription_id?: integer, auto_image_import?: string, delete_categories?: string, member_tag_action?: string, search_description?: string, create_new_categories?: string }
- `POST https://api.mcp.ai/api/brilliant_directories/update/users/click` — Updates a user clicked link record and their related data from the database. Modifies click tracking data for existing click records. This action is used to update click tracking information such as c
  - body: { post_id?: integer, user_id?: integer, click_id: integer, click_ip?: string, click_url?: string, click_from?: string, click_name?: string, click_type?: string, click_token?: string, date_clicked?: string, visitor_token?: string, is_single_post?: integer }
- `POST https://api.mcp.ai/api/brilliant_directories/update/widget` — Tool to update an existing widget record in the Brilliant Directories database. Modifies widget settings including name, HTML/PHP content, CSS styles, and JavaScript code.
  - body: { widget_id: integer, widget_data?: string, widget_name?: string, widget_style?: string, widget_javascript?: string }

## Example prompts
- "What can I do in Brilliant Directories?"
- "Show me a summary of my Brilliant Directories account"

## More
- Page: https://mcp.ai/brilliant_directories
- Agent spec (llms.txt): https://mcp.ai/brilliant_directories/llms.txt
- Postman collection: https://mcp.ai/brilliant_directories/postman.json