directify-mcp 1.0.0 → 1.1.0

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 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "directify-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "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,
 ];