{"_id":"@densh/ghost-mcp-server","_rev":"3-7b82ae113e23acb9df7ffe52c92c6340","name":"@densh/ghost-mcp-server","dist-tags":{"latest":"1.1.2"},"versions":{"1.1.0":{"name":"@densh/ghost-mcp-server","version":"1.1.0","keywords":[],"author":{"name":"densh"},"license":"MIT","_id":"@densh/ghost-mcp-server@1.1.0","maintainers":[{"name":"densh","email":"hello@denishartl.com"}],"homepage":"https://github.com/denishartl/ghost-mcp-server#readme","bugs":{"url":"https://github.com/denishartl/ghost-mcp-server/issues"},"bin":{"ghost-mcp-server":"build/index.js"},"dist":{"shasum":"d2443036e6ff77b400629d93e011639c492cae7e","tarball":"https://registry.npmjs.org/@densh/ghost-mcp-server/-/ghost-mcp-server-1.1.0.tgz","fileCount":13,"integrity":"sha512-RUo1/S45nkMueK5Q+drf/jkZ1u0b9dAg3fz8NP1TItKZP8SLSnZ197S1w2EMEM/97ejMHN46HNPliUVKIXbwaQ==","signatures":[{"sig":"MEUCIHL60zKJb8JDfbwnIa8OxrxVbVrEdzeENIoHqK5qJO8DAiEA4ap9A3CJrJzVVFQKDt0OIjBRMBNQUGMN0+OxagnxqEU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":98266},"main":"build/index.js","type":"module","gitHead":"1fb12436dc43392cba6ea4a1b0c165553a57aedd","scripts":{"dev":"ts-node --esm src/index.ts","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","inspect":"CLIENT_PORT=8080 SERVER_PORT=9000 npx @modelcontextprotocol/inspector build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"densh","email":"hello@denishartl.com"},"repository":{"url":"git+https://github.com/denishartl/ghost-mcp-server.git","type":"git"},"_npmVersion":"11.6.2","description":"Ghost MCP Server for interacting with Ghost CMS API","directories":{},"_nodeVersion":"25.2.1","dependencies":{"form-data":"^4.0.1","image-size":"^1.2.0","@types/form-data":"^2.2.1","@tryghost/admin-api":"^1.13.12","@modelcontextprotocol/sdk":"^1.4.1"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.3.3","@types/node":"^20.11.5"},"_npmOperationalInternal":{"tmp":"tmp/ghost-mcp-server_1.1.0_1766702498807_0.9762529012906513","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@densh/ghost-mcp-server","version":"1.1.1","keywords":[],"author":{"name":"densh"},"license":"MIT","_id":"@densh/ghost-mcp-server@1.1.1","maintainers":[{"name":"densh","email":"hello@denishartl.com"}],"homepage":"https://github.com/denishartl/ghost-mcp-server#readme","bugs":{"url":"https://github.com/denishartl/ghost-mcp-server/issues"},"bin":{"ghost-mcp-server":"build/index.js"},"dist":{"shasum":"017d2a3aa5b4e9d1209f9b323227fc41962e6ec8","tarball":"https://registry.npmjs.org/@densh/ghost-mcp-server/-/ghost-mcp-server-1.1.1.tgz","fileCount":13,"integrity":"sha512-Ra+Mf6H1L1XqNyQN2SfRKdIYnbn5OuXVKNFV4/LPSavr+7QdNWni5IyTDJuYY5JsoFTYj6AUSUee3MmJiZVW5g==","signatures":[{"sig":"MEYCIQDttu9vVRoURltyOD49DiH35nXl8pNLm6rYCq+GvSw2wAIhAP1vpg7heeMx4wh/oidfb0ag4Bzlmc9pNywZmlC1o7/S","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":98331},"main":"build/index.js","type":"module","gitHead":"07e34cd43892c5b86870686c4a2c38e8a2c05ea6","scripts":{"dev":"ts-node --esm src/index.ts","build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","inspect":"CLIENT_PORT=8080 SERVER_PORT=9000 npx @modelcontextprotocol/inspector build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"densh","email":"hello@denishartl.com"},"repository":{"url":"git+https://github.com/denishartl/ghost-mcp-server.git","type":"git"},"_npmVersion":"11.6.2","description":"Ghost MCP Server for interacting with Ghost CMS API","directories":{},"_nodeVersion":"25.2.1","dependencies":{"form-data":"^4.0.1","image-size":"^1.2.0","@types/form-data":"^2.2.1","@tryghost/admin-api":"^1.13.12","@modelcontextprotocol/sdk":"^1.4.1"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.3.3","@types/node":"^20.11.5"},"_npmOperationalInternal":{"tmp":"tmp/ghost-mcp-server_1.1.1_1766702941087_0.002688471343450294","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"@densh/ghost-mcp-server","version":"1.1.2","description":"Ghost MCP Server for interacting with Ghost CMS API","type":"module","main":"build/index.js","scripts":{"build":"tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"","start":"node build/index.js","dev":"ts-node --esm src/index.ts","inspect":"CLIENT_PORT=8080 SERVER_PORT=9000 npx @modelcontextprotocol/inspector build/index.js","prepublishOnly":"npm run build"},"bin":{"ghost-mcp-server":"build/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.4.1","@tryghost/admin-api":"^1.13.12","@types/form-data":"^2.2.1","form-data":"^4.0.1","image-size":"^1.2.0"},"devDependencies":{"@types/node":"^20.11.5","ts-node":"^10.9.2","typescript":"^5.3.3"},"repository":{"type":"git","url":"git+https://github.com/denishartl/ghost-mcp-server.git"},"keywords":[],"author":{"name":"densh"},"license":"MIT","bugs":{"url":"https://github.com/denishartl/ghost-mcp-server/issues"},"homepage":"https://github.com/denishartl/ghost-mcp-server#readme","gitHead":"20fc04340f23c70985a9b4fcec27fbffdb63ceaf","_id":"@densh/ghost-mcp-server@1.1.2","_nodeVersion":"25.2.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-2R26T6z4sx2vsRRqYw8wbFKT252LqkKXP04TO5ht+PZfihblz72hjr8EUdGye3rTI0OHnv2v5EC/1E5CUMBTcQ==","shasum":"58a762811fb03ca88fac4b6b9e334845d94b4293","tarball":"https://registry.npmjs.org/@densh/ghost-mcp-server/-/ghost-mcp-server-1.1.2.tgz","fileCount":13,"unpackedSize":98248,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCID52NpAaXfzsJYjKbQPxWRKk9KM2rX2zj/HNP1wuuMdrAiBfbjvvvgrnvFze++h+tTwXPwDQEfp8N+HxkOxkZVQUwQ=="}]},"_npmUser":{"name":"densh","email":"hello@denishartl.com"},"directories":{},"maintainers":[{"name":"densh","email":"hello@denishartl.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ghost-mcp-server_1.1.2_1766703026972_0.596443300884242"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-25T22:41:38.679Z","modified":"2025-12-25T22:50:27.338Z","1.1.0":"2025-12-25T22:41:38.952Z","1.1.1":"2025-12-25T22:49:01.226Z","1.1.2":"2025-12-25T22:50:27.123Z"},"bugs":{"url":"https://github.com/denishartl/ghost-mcp-server/issues"},"author":{"name":"densh"},"license":"MIT","homepage":"https://github.com/denishartl/ghost-mcp-server#readme","keywords":[],"repository":{"type":"git","url":"git+https://github.com/denishartl/ghost-mcp-server.git"},"description":"Ghost MCP Server for interacting with Ghost CMS API","maintainers":[{"name":"densh","email":"hello@denishartl.com"}],"readme":"# Ghost MCP Server\n\nA Model Context Protocol (MCP) server that integrates with the Ghost Admin API. This server enables programmatic access to Ghost CMS features including post management, page management, member management, and more.\n\n## Features\n\n- Post Management (create, read, update, delete, search)\n- Page Management (create, read, update, delete)\n- Tag Management\n- Author Management\n- Member Management (create, read, update, delete, search)\n- Image Upload (Base64 and URL-based)\n\n## Prerequisites\n\n- Node.js (v18 or higher recommended)\n- Ghost CMS instance\n- Ghost Admin API key\n\n## Installation\n\nInstall the package using npm:\n\n```bash\nnpm install @densh/ghost-mcp-server\n```\n\n## Configuration\n\n1. Create a new custom integration in your Ghost Admin dashboard under Settings > Integrations.\n\n2. Set the following environment variables:\n\n```bash\n# macOS/Linux\nexport GHOST_API_URL=\"https://your-ghost-blog.com\"\nexport GHOST_ADMIN_API_KEY=\"your_admin_api_key\"\n\n# Windows (PowerShell)\n$env:GHOST_API_URL=\"https://your-ghost-blog.com\"\n$env:GHOST_ADMIN_API_KEY=\"your_admin_api_key\"\n```\n\nAlternatively, you can create a `.env` file:\n\n```env\nGHOST_API_URL=https://your-ghost-blog.com\nGHOST_ADMIN_API_KEY=your_admin_api_key\n```\n\n## Usage\n\nAfter installation, start the server with:\n\n```bash\nnpx @densh/ghost-mcp-server\n```\n\n## Available Tools\n\n### get_posts\nRetrieves a list of blog posts.\n\nInput:\n```json\n{\n  \"limit\": \"number\", // Optional: Number of posts to retrieve (1-100, default: 10)\n  \"page\": \"number\"   // Optional: Page number (default: 1)\n}\n```\n\n### get_post\nRetrieves a specific post by ID.\n\nInput:\n```json\n{\n  \"id\": \"string\" // Required: Post ID\n}\n```\n\n### search_posts\nSearches for posts.\n\nInput:\n```json\n{\n  \"query\": \"string\", // Required: Search query\n  \"limit\": \"number\"  // Optional: Number of posts to retrieve (1-100, default: 10)\n}\n```\n\n### create_post\nCreates a new post.\n\nInput:\n```json\n{\n  \"title\": \"string\",     // Required: Post title\n  \"html\": \"string\",      // Optional: HTML content\n  \"lexical\": \"string\",   // Optional: Lexical content\n  \"status\": \"string\",    // Optional: Post status (published/draft/scheduled)\n  \"visibility\": \"string\" // Optional: Visibility level (public/members/paid/tiers)\n}\n```\n\n### update_post\nUpdates an existing post.\n\nInput:\n```json\n{\n  \"id\": \"string\",       // Required: Post ID\n  \"title\": \"string\",    // Optional: Post title\n  \"html\": \"string\",     // Optional: HTML content\n  \"lexical\": \"string\",  // Optional: Lexical content\n  \"status\": \"string\"    // Optional: Post status\n}\n```\n\n### delete_post\nDeletes a post.\n\nInput:\n```json\n{\n  \"id\": \"string\" // Required: Post ID\n}\n```\n\n### get_pages\nRetrieves a list of pages.\n\nInput:\n```json\n{\n  \"limit\": \"number\",     // Optional: Number of pages to retrieve (1-100, default: 10)\n  \"page\": \"number\",      // Optional: Page number (default: 1)\n  \"order\": \"string\",     // Optional: Sort order\n  \"formats\": [\"string\"], // Optional: Content formats (html/mobiledoc/lexical)\n  \"include\": [\"string\"]  // Optional: Related data to include (authors/tags)\n}\n```\n\n### get_members\nRetrieves a list of members.\n\nInput:\n```json\n{\n  \"limit\": \"number\",     // Optional: Number of members to retrieve (1-100, default: 10)\n  \"page\": \"number\",      // Optional: Page number (default: 1)\n  \"order\": \"string\",     // Optional: Sort order\n  \"include\": [\"string\"]  // Optional: Related data to include (labels/newsletters)\n}\n```\n\n### search_members\nSearches for members.\n\nInput:\n```json\n{\n  \"query\": \"string\",     // Required: Search query\n  \"limit\": \"number\",     // Optional: Number of members to retrieve (1-100, default: 10)\n  \"include\": [\"string\"]  // Optional: Related data to include (labels/newsletters)\n}\n```\n\n### upload_image\nUploads an image from Base64 data.\n\nInput:\n```json\n{\n  \"file\": \"string\",   // Required: Base64 encoded image data\n  \"purpose\": \"string\" // Optional: Image purpose (image/profile_image/icon)\n}\n```\n\n### upload_image_from_url\nDownloads an image from a URL and uploads it to Ghost. Returns the permanent Ghost URL.\n\nInput:\n```json\n{\n  \"url\": \"string\",      // Required: Source URL of the image to download\n  \"filename\": \"string\", // Optional: Desired filename (without extension)\n  \"purpose\": \"string\",  // Optional: Image purpose (image/profile_image/icon, default: image)\n  \"ref\": \"string\"       // Optional: Reference identifier for tracking\n}\n```\n\nOutput (success):\n```json\n{\n  \"success\": true,\n  \"ghost_url\": \"https://your-ghost-blog.com/content/images/2025/12/image.png\",\n  \"filename\": \"image.png\",\n  \"size_bytes\": 245678,\n  \"mime_type\": \"image/png\"\n}\n```\n\nOutput (failure):\n```json\n{\n  \"success\": false,\n  \"error\": \"Failed to download: 403 Forbidden\"\n}\n```\n\nSupported formats: PNG, JPEG, GIF, WebP, SVG. Maximum file size: 128MB.\n\n### Debugging\n\nSince MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector), which is available as a package script:\n\n```bash\nnpm run inspect\n```\n\nThe Inspector will provide a URL to access debugging tools in your browser.\n\n## License\n\nMIT License","readmeFilename":"README.md"}