Directify MCP Server

MCP (Model Context Protocol) server for Directify - manage your directory websites through AI assistants like Claude, Cursor, and other MCP-compatible tools.

What is this?

This MCP server lets AI assistants directly manage your Directify directories. Ask Claude to create listings, update categories, publish articles, and more - all through natural language.

You can use it in two ways:

• Local - Install the npm package and run it on your machine (see Installation)
• Remote - Use the hosted server with zero installation (see Remote Server)

Installation

npm install -g directify-mcp

Setup

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "directify": {
      "command": "npx",
      "args": ["-y", "directify-mcp"],
      "env": {
        "DIRECTIFY_API_TOKEN": "your-api-token-here",
        "DIRECTIFY_DIRECTORY_ID": "123"
      }
    }
  }
}

Claude Code

claude mcp add directify -- npx -y directify-mcp

# Then set environment variables in your shell:
export DIRECTIFY_API_TOKEN="your-api-token-here"
export DIRECTIFY_DIRECTORY_ID="123"

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "directify": {
      "command": "npx",
      "args": ["-y", "directify-mcp"],
      "env": {
        "DIRECTIFY_API_TOKEN": "your-api-token-here",
        "DIRECTIFY_DIRECTORY_ID": "123"
      }
    }
  }
}

Remote Server (No Installation Required)

If you prefer not to install anything locally, you can use the hosted remote MCP server. This works with any MCP client that supports remote servers via mcp-remote.

Claude Desktop (Remote)

{
  "mcpServers": {
    "directify": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.directify.app/mcp",
        "--header", "Authorization:Bearer YOUR_API_TOKEN",
        "--header", "X-Directory-ID:YOUR_DIRECTORY_ID"
      ]
    }
  }
}

Cursor (Remote)

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "directify": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.directify.app/mcp",
        "--header", "Authorization:Bearer YOUR_API_TOKEN",
        "--header", "X-Directory-ID:YOUR_DIRECTORY_ID"
      ]
    }
  }
}

The X-Directory-ID header is optional. If omitted, the AI will ask which directory to use (or you can call list_directories to discover them).

Configuration

| Environment Variable | Required | Description | |---------------------|----------|-------------| | DIRECTIFY_API_TOKEN | Yes | Your API token from Settings > API | | DIRECTIFY_DIRECTORY_ID | No | Default directory ID (can also pass per-tool) |

Getting your API token

1. Go to your Directify dashboard
2. Navigate to Settings > API
3. Click the Key icon to generate a new token
4. Copy the token

Finding your Directory ID

Ask Claude: "List my Directify directories" - or find it in the URL when viewing your directory in the dashboard (/app/{directory_id}/...).

Available Tools

Directories

| Tool | Description | |------|-------------| | list_directories | List all directories you own |

Categories

| Tool | Description | |------|-------------| | list_categories | List all categories in a directory | | get_category | Get details of a specific category | | create_category | Create a new category | | update_category | Update a category | | delete_category | Delete a category |

Tags

| Tool | Description | |------|-------------| | list_tags | List all tags | | get_tag | Get a specific tag | | create_tag | Create a new tag | | update_tag | Update a tag | | delete_tag | Delete a tag |

Custom Fields

| 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

| Tool | Description | |------|-------------| | 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 (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.

Note: the listing URL acts as a unique key per directory. Creating a listing (single or bulk) with a URL that already exists in the directory updates that existing listing instead of creating a duplicate. Give each listing its own unique URL, or omit the URL to always create a new listing.

Articles

| Tool | Description | |------|-------------| | list_articles | List all blog articles (paginated) | | get_article | Get article details | | create_article | Create a new article (HTML or Markdown) | | update_article | Update an article | | delete_article | Delete an article | | toggle_article | Toggle active/inactive status |

Custom Pages

| Tool | Description | |------|-------------| | list_pages | List all custom pages | | get_page | Get page details | | create_page | Create a custom page (markdown content, placement, SEO) | | update_page | Update a page | | 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

You: Add a new restaurant called "Bella Trattoria" at 123 Main St, Italian cuisine, price range $$$, open Mon-Sat 11am-10pm.

Claude will use create_listing with the appropriate fields.

Bulk import

You: Create 5 test listings for Japanese restaurants in San Francisco with different names and addresses.

Claude will use bulk_create_listings to create all 5 at once.

Manage content

You: Write a blog article about the top 10 Italian restaurants and publish it.

Claude will use create_article with markdown content.

Update listings

You: Update all listings that don't have a description and add a short one based on their name and category.

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.

Claude will use create_page for each with markdown content, unlisted placement, and SEO metadata.

Manage custom pages

You: Add an About Us page to the navbar and a Terms of Service page to the footer.

Claude will use create_page with placement: "navbar" and placement: "footer".

Rate Limits

The Directify API allows 120 requests per minute per directory. The MCP server handles rate limit errors gracefully and will inform the AI assistant to retry.

License

MIT