directify-mcp 1.3.1 → 1.4.0

package/README.md

@@ -163,6 +163,10 @@ Ask Claude: *"List my Directify directories"* - or find it in the URL when viewi
 | Tool | Description |
 |------|-------------|
 | `list_custom_fields` | List all custom fields (useful to know field names for listings) |
+| `get_custom_field` | Get a custom field definition |
+| `create_custom_field` | Create a custom field definition (text, number, select, etc.) |
+| `update_custom_field` | Update a custom field definition |
+| `delete_custom_field` | Delete a custom field (also removes its values from listings) |
 
 ### Listings
 
@@ -170,12 +174,14 @@ Ask Claude: *"List my Directify directories"* - or find it in the URL when viewi
 |------|-------------|
 | `list_listings` | List all listings (paginated) |
 | `get_listing` | Get full listing details with custom fields |
-| `create_listing` | Create a new listing with custom field values |
-| `update_listing` | Update a listing |
+| `create_listing` | Create a new listing with custom field values (and link organizers) |
+| `update_listing` | Update a listing (including its linked organizers) |
 | `delete_listing` | Delete a listing |
 | `check_listing_exists` | Check if a URL already exists |
 | `bulk_create_listings` | Create up to 100 listings at once |
 
+Listings can be linked to one or more organizers by passing an `organizers` array of organizer IDs to `create_listing` / `update_listing` (use `list_organizers` to find the IDs). On update, the array replaces the current set.
+
 ### Articles
 
 | Tool | Description |
@@ -198,6 +204,20 @@ Ask Claude: *"List my Directify directories"* - or find it in the URL when viewi
 | `delete_page` | Delete a page |
 | `toggle_page` | Toggle published/unpublished status |
 
+### Organizers
+
+Organizers represent entities like agencies, studios, or event hosts that can be linked to multiple listings.
+
+| Tool | Description |
+|------|-------------|
+| `list_organizers` | List all organizers (with their linked listings) |
+| `get_organizer` | Get organizer details (with linked listings) |
+| `create_organizer` | Create a new organizer |
+| `update_organizer` | Update an organizer |
+| `delete_organizer` | Delete an organizer |
+
+To link an organizer to a listing, pass the organizer's ID in the `organizers` array of `create_listing` / `update_listing` (see Listings above).
+
 ## Example Conversations
 
 ### Create a listing
@@ -224,6 +244,18 @@ Claude will use `create_article` with markdown content.
 
 Claude will use `list_listings`, then `update_listing` for each one.
 
+### Link listings to an organizer
+
+> **You:** Create an organizer "Acme Events", then add these 3 festival listings and link them all to it.
+
+Claude will use `create_organizer`, then `create_listing` for each festival with the new organizer's ID in the `organizers` array.
+
+### Define a custom field
+
+> **You:** Add a "Price Range" dropdown field with options $, $$, and $$$, and make it filterable.
+
+Claude will use `create_custom_field` with `type: "select"`, the options, and `filterable: true` — then you can set the value per listing via `create_listing` / `update_listing`.
+
 ### Create programmatic SEO pages
 
 > **You:** Create comparison pages for "NYC vs Chicago pizza", "NYC vs LA tacos", and "NYC vs Boston seafood" with SEO titles and descriptions.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "directify-mcp",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "MCP server for Directify - manage your directory websites through AI assistants like Claude.",
   "main": "src/index.js",
   "bin": {

package/src/tools.js

@@ -242,6 +242,116 @@ export const listCustomFields = {
   },
 };
 
+const CUSTOM_FIELD_TYPES = [
+  'text', 'number', 'date', 'file_upload', 'url', 'email', 'rich_editor',
+  'markdown', 'textarea', 'checkbox', 'rating', 'select', 'list',
+  'multi_select', 'button', 'javascript', 'html',
+];
+
+export const getCustomField = {
+  name: 'get_custom_field',
+  description: 'Get the definition of a specific custom field.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      directory_id: { type: 'string', description: 'Directory ID' },
+      custom_field_id: { type: 'string', description: 'Custom field ID' },
+    },
+    required: ['custom_field_id'],
+  },
+  handler: async ({ directory_id, custom_field_id }) => {
+    const dir = resolveDirectory(directory_id);
+    const data = await api.get(`/directories/${dir}/custom-fields/${custom_field_id}`);
+    return data.data || data;
+  },
+};
+
+export const createCustomField = {
+  name: 'create_custom_field',
+  description:
+    'Create a new custom field definition for a directory. Field values are then set on listings by passing the field name as a key (see create_listing / update_listing).',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      directory_id: { type: 'string', description: 'Directory ID' },
+      label: { type: 'string', description: 'Human-readable field label (shown to users)' },
+      type: { type: 'string', enum: CUSTOM_FIELD_TYPES, description: 'Field type' },
+      name: { type: 'string', description: 'Machine name/key used when setting values (auto-derived from label, snake_cased, if omitted)' },
+      fieldable_type: { type: 'string', enum: ['listing', 'organizer', 'article'], description: 'What the field attaches to (default: listing)' },
+      placeholder: { type: 'string', description: 'Input placeholder text' },
+      description: { type: 'string', description: 'Help text shown under the field' },
+      default_value: { type: 'string', description: 'Default value' },
+      value_prefix: { type: 'string', description: 'Prefix shown before the value (e.g. "$")' },
+      value_suffix: { type: 'string', description: 'Suffix shown after the value (e.g. "/mo")' },
+      options: { type: 'array', items: { type: 'string' }, description: 'Options for select / multi_select / list field types' },
+      is_required: { type: 'boolean', description: 'Whether the field is required' },
+      is_visible: { type: 'boolean', description: 'Whether the field is shown on the listing page (default: true)' },
+      show_on_card: { type: 'boolean', description: 'Show the value on listing cards' },
+      show_on_public_submission: { type: 'boolean', description: 'Show the field on the public submission form' },
+      filterable: { type: 'boolean', description: 'Allow filtering listings by this field' },
+      order: { type: 'number', description: 'Sort order among fields' },
+    },
+    required: ['label', 'type'],
+  },
+  handler: async ({ directory_id, ...body }) => {
+    const dir = resolveDirectory(directory_id);
+    const data = await api.post(`/directories/${dir}/custom-fields`, body);
+    return data.data || data;
+  },
+};
+
+export const updateCustomField = {
+  name: 'update_custom_field',
+  description: 'Update an existing custom field definition. Only pass fields you want to change.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      directory_id: { type: 'string', description: 'Directory ID' },
+      custom_field_id: { type: 'string', description: 'Custom field ID to update' },
+      label: { type: 'string', description: 'Human-readable field label' },
+      type: { type: 'string', enum: CUSTOM_FIELD_TYPES, description: 'Field type' },
+      name: { type: 'string', description: 'Machine name/key used when setting values' },
+      fieldable_type: { type: 'string', enum: ['listing', 'organizer', 'article'], description: 'What the field attaches to' },
+      placeholder: { type: 'string', description: 'Input placeholder text' },
+      description: { type: 'string', description: 'Help text shown under the field' },
+      default_value: { type: 'string', description: 'Default value' },
+      value_prefix: { type: 'string', description: 'Prefix shown before the value' },
+      value_suffix: { type: 'string', description: 'Suffix shown after the value' },
+      options: { type: 'array', items: { type: 'string' }, description: 'Options for select / multi_select / list field types' },
+      is_required: { type: 'boolean', description: 'Whether the field is required' },
+      is_visible: { type: 'boolean', description: 'Whether the field is shown on the listing page' },
+      show_on_card: { type: 'boolean', description: 'Show the value on listing cards' },
+      show_on_public_submission: { type: 'boolean', description: 'Show the field on the public submission form' },
+      filterable: { type: 'boolean', description: 'Allow filtering listings by this field' },
+      order: { type: 'number', description: 'Sort order among fields' },
+    },
+    required: ['custom_field_id'],
+  },
+  handler: async ({ directory_id, custom_field_id, ...body }) => {
+    const dir = resolveDirectory(directory_id);
+    const data = await api.put(`/directories/${dir}/custom-fields/${custom_field_id}`, body);
+    return data.data || data;
+  },
+};
+
+export const deleteCustomField = {
+  name: 'delete_custom_field',
+  description: 'Delete a custom field definition from a directory. This also removes the field\'s values from all listings.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      directory_id: { type: 'string', description: 'Directory ID' },
+      custom_field_id: { type: 'string', description: 'Custom field ID to delete' },
+    },
+    required: ['custom_field_id'],
+  },
+  handler: async ({ directory_id, custom_field_id }) => {
+    const dir = resolveDirectory(directory_id);
+    await api.delete(`/directories/${dir}/custom-fields/${custom_field_id}`);
+    return { success: true, message: `Custom field ${custom_field_id} deleted.` };
+  },
+};
+
 // ─── Listings ───
 
 export const listListings = {
@@ -282,7 +392,7 @@ export const getListing = {
 export const createListing = {
   name: 'create_listing',
   description:
-    'Create a new listing in a directory. You can include custom field values by using the field name as a key (use list_custom_fields to see available fields).',
+    'Create a new listing in a directory. You can include custom field values by using the field name as a key (use list_custom_fields to see available fields). Link the listing to organizers by passing their IDs (use list_organizers to find them).',
   inputSchema: {
     type: 'object',
     properties: {
@@ -309,6 +419,11 @@ export const createListing = {
         items: { type: 'number' },
         description: 'Array of tag IDs',
       },
+      organizers: {
+        type: 'array',
+        items: { type: 'number' },
+        description: 'Array of organizer IDs to link this listing to (must belong to the same directory; use list_organizers to find them)',
+      },
       is_active: { type: 'boolean', description: 'Active status (default: true)' },
       is_featured: { type: 'boolean', description: 'Featured status' },
       custom_fields: {
@@ -329,7 +444,7 @@ export const createListing = {
 
 export const updateListing = {
   name: 'update_listing',
-  description: 'Update an existing listing. Only pass fields you want to change.',
+  description: "Update an existing listing. Only pass fields you want to change. Pass organizers to replace the listing's linked organizers (omit it to leave them untouched).",
   inputSchema: {
     type: 'object',
     properties: {
@@ -357,6 +472,11 @@ export const updateListing = {
         items: { type: 'number' },
         description: 'Array of tag IDs',
       },
+      organizers: {
+        type: 'array',
+        items: { type: 'number' },
+        description: 'Array of organizer IDs to link this listing to. Replaces the current set; pass [] to unlink all. Out-of-directory IDs are ignored.',
+      },
       is_active: { type: 'boolean', description: 'Active status' },
       is_featured: { type: 'boolean', description: 'Featured status' },
       custom_fields: {
@@ -436,6 +556,7 @@ export const bulkCreateListings = {
             description: { type: 'string' },
             categories: { type: 'array', items: { type: 'number' } },
             tags: { type: 'array', items: { type: 'number' } },
+            organizers: { type: 'array', items: { type: 'number' } },
           },
           required: ['name'],
           additionalProperties: true,
@@ -856,6 +977,10 @@ export const allTools = [
   updateTag,
   deleteTag,
   listCustomFields,
+  getCustomField,
+  createCustomField,
+  updateCustomField,
+  deleteCustomField,
   listListings,
   getListing,
   createListing,