directify-mcp 1.0.0 → 1.1.1

package/README.md

@@ -6,6 +6,10 @@
 
 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](#installation))
+- **Remote** - Use the hosted server with zero installation (see [Remote Server](#remote-server-no-installation-required))
+
 ## Installation
 
 ```bash
@@ -62,6 +66,52 @@ Add to `.cursor/mcp.json` in your project:
 }
 ```
 
+## 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)
+
+```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"
+      ]
+    }
+  }
+}
+```
+
+### Cursor (Remote)
+
+Add to `.cursor/mcp.json`:
+
+```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 |
@@ -137,6 +187,17 @@ Ask Claude: *"List my Directify directories"* - or find it in the URL when viewi
 | `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 |
+
 ## Example Conversations
 
 ### Create a listing
@@ -163,6 +224,18 @@ Claude will use `create_article` with markdown content.
 
 Claude will use `list_listings`, then `update_listing` for each one.
 
+### 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.

package/package.json

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

package/src/tools.js

@@ -593,6 +593,139 @@ export const toggleArticle = {
   },
 };
 
+// ─── Custom Pages ───
+
+export const listPages = {
+  name: 'list_pages',
+  description: 'List all custom pages in a directory. Custom pages are for static content like About, Terms, comparison pages, etc.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      directory_id: { type: 'string', description: 'Directory ID' },
+    },
+  },
+  handler: async ({ directory_id }) => {
+    const dir = resolveDirectory(directory_id);
+    const data = await api.get(`/directories/${dir}/pages`);
+    return data;
+  },
+};
+
+export const getPage = {
+  name: 'get_page',
+  description: 'Get full details of a specific custom page.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      directory_id: { type: 'string', description: 'Directory ID' },
+      page_id: { type: 'string', description: 'Page ID' },
+    },
+    required: ['page_id'],
+  },
+  handler: async ({ directory_id, page_id }) => {
+    const dir = resolveDirectory(directory_id);
+    const data = await api.get(`/directories/${dir}/pages/${page_id}`);
+    return data.data || data;
+  },
+};
+
+export const createPage = {
+  name: 'create_page',
+  description: 'Create a custom page. Great for programmatic SEO pages (comparisons, location pages), About, Terms, etc. Content is markdown.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      directory_id: { type: 'string', description: 'Directory ID' },
+      title: { type: 'string', description: 'Page title (required)' },
+      slug: { type: 'string', description: 'URL slug (auto-generated from title if not set)' },
+      markdown: { type: 'string', description: 'Page content in markdown' },
+      placement: { type: 'string', enum: ['navbar', 'footer', 'sidebar', 'unlisted'], description: 'Where the page link appears (default: unlisted)' },
+      is_published: { type: 'boolean', description: 'Published status (default: true)' },
+      order: { type: 'number', description: 'Sort order for navigation' },
+      seo_title: { type: 'string', description: 'SEO title' },
+      seo_description: { type: 'string', description: 'SEO meta description' },
+    },
+    required: ['title'],
+  },
+  handler: async ({ directory_id, seo_title, seo_description, ...body }) => {
+    const dir = resolveDirectory(directory_id);
+    if (seo_title || seo_description) {
+      body.seo = {};
+      if (seo_title) body.seo.title = seo_title;
+      if (seo_description) body.seo.description = seo_description;
+    }
+    const data = await api.post(`/directories/${dir}/pages`, body);
+    return data.data || data;
+  },
+};
+
+export const updatePage = {
+  name: 'update_page',
+  description: 'Update an existing custom page. Only pass fields you want to change.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      directory_id: { type: 'string', description: 'Directory ID' },
+      page_id: { type: 'string', description: 'Page ID to update' },
+      title: { type: 'string', description: 'Page title' },
+      slug: { type: 'string', description: 'URL slug' },
+      markdown: { type: 'string', description: 'Page content in markdown' },
+      placement: { type: 'string', enum: ['navbar', 'footer', 'sidebar', 'unlisted'], description: 'Where the page link appears' },
+      is_published: { type: 'boolean', description: 'Published status' },
+      order: { type: 'number', description: 'Sort order for navigation' },
+      seo_title: { type: 'string', description: 'SEO title' },
+      seo_description: { type: 'string', description: 'SEO meta description' },
+    },
+    required: ['page_id'],
+  },
+  handler: async ({ directory_id, page_id, seo_title, seo_description, ...body }) => {
+    const dir = resolveDirectory(directory_id);
+    if (seo_title || seo_description) {
+      body.seo = {};
+      if (seo_title) body.seo.title = seo_title;
+      if (seo_description) body.seo.description = seo_description;
+    }
+    const data = await api.put(`/directories/${dir}/pages/${page_id}`, body);
+    return data.data || data;
+  },
+};
+
+export const deletePage = {
+  name: 'delete_page',
+  description: 'Delete a custom page from a directory.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      directory_id: { type: 'string', description: 'Directory ID' },
+      page_id: { type: 'string', description: 'Page ID to delete' },
+    },
+    required: ['page_id'],
+  },
+  handler: async ({ directory_id, page_id }) => {
+    const dir = resolveDirectory(directory_id);
+    await api.delete(`/directories/${dir}/pages/${page_id}`);
+    return { success: true, message: `Page ${page_id} deleted.` };
+  },
+};
+
+export const togglePage = {
+  name: 'toggle_page',
+  description: 'Toggle a custom page between published and unpublished status.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      directory_id: { type: 'string', description: 'Directory ID' },
+      page_id: { type: 'string', description: 'Page ID to toggle' },
+    },
+    required: ['page_id'],
+  },
+  handler: async ({ directory_id, page_id }) => {
+    const dir = resolveDirectory(directory_id);
+    const data = await api.patch(`/directories/${dir}/pages/${page_id}/toggle`);
+    return data.data || data;
+  },
+};
+
 // ─── Export all tools ───
 
 export const allTools = [
@@ -621,4 +754,10 @@ export const allTools = [
   updateArticle,
   deleteArticle,
   toggleArticle,
+  listPages,
+  getPage,
+  createPage,
+  updatePage,
+  deletePage,
+  togglePage,
 ];