# Ghost MCP > Ghost MCP connects your AI agent directly to your Ghost CMS, letting you manage and retrieve content without logging into a dashboard. List posts, check authors, pull taxonomy tags, or view site settings—all through natural conversation. Stop copy-pasting from admin panels; start working with live publication data instantly. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** blogging, publishing, content-creation, newsletter-platform, web-publishing ## Description This connection lets your AI agent read and write to your Ghost CMS directly. You can ask it to list all published blog posts, pulling the full HTML content and metadata for each one. Need to know what categories exist? Just ask it to retrieve all available taxonomy tags. It also helps you track who's writing by fetching profile details for active authors. Even site-level data is accessible; you can get global settings or list current membership tiers to understand your paywall rules. By using this MCP on Vinkius, your AI client keeps the entire publishing stack live and available without requiring you to switch apps or navigate complex menus. ## Tools ### verify_api_connection Checks if the connection between your AI agent and Ghost is working correctly. ### get_post_by_slug Fetches all details for a specific blog post using its unique URL slug. ### get_author_details Retrieves the full profile information and bio for a specified author. ### get_page_by_slug Gets details about non-blog pages (like 'About Us') by their slug. ### get_site_settings Accesses global site configurations, such as routing rules and title schemas. ### get_tag_details Retrieves metadata for a specific content category or tag. ### list_subscription_tiers Provides a list of all active membership levels and their associated pricing details. ### list_blog_authors Lists every author who has contributed content to the publication. ### list_static_pages Retrieves a list of all pages that are not blog posts, including their slugs and titles. ### list_published_posts Lists metadata for every article currently live on the site. ### list_content_tags Retrieves a comprehensive list of all available content categories and tags used across the site. ## Prompt Examples **Prompt:** ``` List the 5 most recent published posts. ``` **Response:** ``` Retrieving posts... I found 5 recent articles, including 'Welcome to Ghost' and 'Writing with Markdown'. Would you like to read the full content of any of them? ``` **Prompt:** ``` Get the content of the post with the slug 'welcome'. ``` **Response:** ``` Fetching post... The post 'Welcome' was published on October 1st. The main content is: 'Welcome, it's great to have you here...'. ``` **Prompt:** ``` List all active subscription tiers. ``` **Response:** ``` Fetching tiers... Your publication has 2 active tiers: 'Free' ($0/month) and 'Premium' ($5/month). ``` ## Capabilities ### Manage published articles Fetch details for specific posts by their slug, or list every article currently marked as published. ### Understand content structure List all available categorization tags and retrieve global site settings to understand how your content is organized. ### Track contributors Pull author profile details and list active writers across the entire publication. ### Review static pages Retrieve the full content and metadata for non-blog pages using their slugs. ### Inspect membership data List all active subscription tiers, helping you understand your paywall structure. ## Use Cases ### Need a quick content audit for SEO A developer needs to verify if all static pages have proper metadata. They instruct their agent to list_static_pages, then loop through the results, calling get_page_by_slug on each one to pull the full text and check for missing H1 tags. ### Drafting a contributor spotlight The Content Manager wants to write an announcement about a new writer. They ask their agent to list_blog_authors, identify the target author, and then use get_author_details to pull the necessary bio text for immediate inclusion in the draft. ### Planning a premium feature rollout The Editorial Lead needs to know how many paid tiers exist. They prompt their agent to list_subscription_tiers, allowing them to confirm the current pricing structure before announcing changes on social media. ### Generating an index of all topics A user wants a master list of everything published. They ask for list_published_posts and list_content_tags, getting two clean lists that they can then combine to create an exhaustive site index. ## Benefits - Access article content instantly: Instead of visiting the post in your browser to copy text, you can ask your agent to get post details by slug. This is faster and keeps your workflow contained. - Build a full site map programmatically: You don't have to click through multiple sections. Use list_static_pages and list_content_tags together to build an inventory of everything on the site via simple AI commands. - Understand your audience revenue: List subscription tiers instantly tells you what paywall rules are in place, letting you draft content that matches your pricing structure without manual checks. - Keep track of contributors easily: Use list_blog_authors and get_author_details to generate an up-to-date roster of writers and their professional bios for a newsletter sendout. - Get global site context on demand: Need to know how the site handles routing or what its primary title schema is? The get_site_settings tool gives you that data instantly, allowing developers to build against known standards. ## How It Works The bottom line is that you treat your entire CMS like one accessible data source within your AI workflow. 1. Subscribe to this MCP on the Vinkius Marketplace and provide your Ghost Base URL and Content API Key. 2. Connect your preferred AI client (like Cursor or Claude) to the Vinkius catalog, granting access to the Ghost tools. 3. Start by asking a natural language question—for example, 'List all authors and their profiles'—and watch your agent execute the required tool calls. ## Frequently Asked Questions **How do I use the Ghost MCP to list all published posts?** You ask your agent to list_published_posts. It will return a list of metadata for every article, including titles and publication dates. **Can I find out which tags are available using Ghost MCP?** Yes. Use the list_content_tags tool. This gives you a complete inventory of all categorization tags applied across your site. **How does get_author_details work with the Ghost MCP?** You provide the author's name or unique identifier, and the tool retrieves their full profile details, including bio and contribution history. **Do I need to manually enter my API key after connecting the Ghost MCP?** No. The connection process requires you to provide your Base URL and Content API Key once during setup. After that, your agent handles authentication automatically. **What is the difference between list_static_pages and list_published_posts?** list_published_posts only lists articles (blog posts). list_static_pages lists non-article pages like 'Contact' or 'About Us'.