Skip to main content

​
What is the MCP server?

The Model Context Protocol (MCP) is an open standard that lets AI assistants use external tools. The Directify MCP server exposes your directory’s management actions — creating listings, categories, tags, custom fields, organizers, articles, and pages — as tools the AI can call. Once connected, you simply chat:
“Add a listing called Bella Trattoria, Italian category, price range $$, and link it to the Acme Events organizer.”
…and the assistant does it for you.

​
Video walkthrough

📹 Video coming soon — a full walkthrough of connecting the MCP server to Claude. Follow @venelinkochev on YouTube to get notified.

​
Step 1 — Get your credentials

1

Generate an API token

In your Directify dashboard, go to Settings → API and click the Key icon to generate a token. Copy it — it’s shown only once.
2

Note your Directory ID

Find it in the dashboard URL (/app/{directory_id}/...). It’s optional in most setups — if you skip it, the assistant will ask which directory to use, or you can say “list my directories”.

​
Step 2 — Choose remote or local

Remote (recommended)

Use our hosted server at https://mcp.directify.app/mcp. No installation — nothing to install or update.

Local

Run the directify-mcp npm package on your own machine. Requires Node.js 18+.

​
Step 3 — Add it to your AI client

Replace YOUR_API_TOKEN with your token and YOUR_DIRECTORY_ID with your directory’s ID in the examples below.
Open Settings → Developer → Edit Config, or edit the file directly:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Remote (recommended):
{
  "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"
      ]
    }
  }
}
Local:
{
  "mcpServers": {
    "directify": {
      "command": "npx",
      "args": ["-y", "directify-mcp"],
      "env": {
        "DIRECTIFY_API_TOKEN": "YOUR_API_TOKEN",
        "DIRECTIFY_DIRECTORY_ID": "YOUR_DIRECTORY_ID"
      }
    }
  }
}
Fully quit and reopen Claude Desktop (not just close the window) for the change to take effect.
The X-Directory-ID / DIRECTIFY_DIRECTORY_ID value is optional. Omit it to let the assistant work across all your directories — it’ll ask which one to use, or you can call list_directories.

​
Step 4 — Try it out

Restart your AI client, then ask:
“List my Directify directories.”
“Create a listing called ‘Blue Bottle Coffee’ in the Cafés category.”
“What custom fields does this directory have? Add a filterable ‘Price Range’ select field with options $, $$, $$$.”
“Create an organizer ‘Acme Events’ and link these three listings to it.”

​
What can it do?

The MCP server exposes tools for every major part of your directory:
AreaExamples
Directorieslist directories you own
Listingslist, get, create, update, delete, bulk-create, check-exists, set custom field values, link organizers
Categorieslist, get, create, update, delete
Tagslist, get, create, update, delete
Custom Fieldslist, get, create, update, delete field definitions
Organizerslist, get, create, update, delete
Articleslist, get, create, update, delete, toggle published
Custom Pageslist, get, create, update, delete, toggle published

​
Troubleshooting

  • Make sure you have Node.js 18+ installed (node --version) — npx needs it.
  • Fully quit and reopen Claude Desktop (closing the window isn’t enough).
  • Double-check the JSON is valid (no trailing commas, matched brackets).
Your API token is missing, mistyped, or revoked. Generate a fresh one at Settings → API and update your config. The header format is exactly Authorization:Bearer YOUR_API_TOKEN (note the single space after Bearer).
The token must belong to the account that owns the directory, and the X-Directory-ID must be one of your directories. Ask the assistant to “list my directories” to see valid IDs.
The API allows 120 requests per minute per directory. For large bulk jobs, ask the assistant to batch the work or slow down.
Prefer the terminal or want to script things? Use the Directify CLI instead — same actions, no AI required.