# Smithery configuration for @misarblog/mcp
# Listed as: misar/misarblog-mcp  (https://smithery.ai/servers/misar/misarblog-mcp)
#
# GENERATED by scripts/mcp/generate-distribution.mjs — do not edit by hand.
# The tool list below is derived from the server's real catalogue; the previous
# hand-written lists had drifted from what the servers actually served.
name: Misar.Blog MCP Server
description: >
  Publish and manage articles, series, comments, reactions, newsletters, and analytics — from any AI assistant.
  23 tools, 8 prompts, 5 resources.
homepage: https://www.misar.blog
license: MIT
tags:
  - writing
  - content
  - publishing
  - blogging
  - seo
  - analytics
  - mcp-server
  - claude
  - cursor
  - windsurf
  - misar

startCommand:
  type: stdio
  configSchema:
    type: object
    properties:
      apiKey:
        type: string
        title: API Key
        description: >
          Your Misar.Blog API key (mbk_…). Create one at https://www.misar.blog/dashboard/settings/api-keys
          — or leave blank and run the "login" tool to authenticate via browser.
        x-secret: true
      baseUrl:
        type: string
        title: Base URL
        description: Only needed for self-hosted instances.
        default: ""
    required: []
  commandFunction: |-
    (config) => ({
      command: "npx",
      args: ["-y", "@misarblog/mcp@latest"],
      env: {
        ...(config.apiKey ? { MISARBLOG_API_KEY: config.apiKey } : {}),
        ...(config.baseUrl ? { MISARBLOG_BASE_URL: config.baseUrl } : {}),
      },
    })

tools:
  - name: upgrade
    description: "Show your current Misar.Blog plan, how much of each quota you have left, and what upgrading unlocks. Call it any time — not only after hitting a limit. Set open=true to open the checkout page in your browser."
  - name: get_profile
    description: "Get your Misar.Blog creator profile"
  - name: get_analytics_summary
    description: "Get analytics summary (views, revenue, subscribers) for a time period"
  - name: list_my_articles
    description: "List your articles on Misar.Blog"
  - name: get_article
    description: "Get a single article by slug, including full markdown content"
  - name: publish_article
    description: "Publish a new article (or schedule it) on Misar.Blog"
  - name: create_draft
    description: "Save an article as a draft on Misar.Blog (for review before publishing)"
  - name: update_article
    description: "Update the title, body, or tags of an existing article or draft. Only the fields you pass are changed; omitted fields keep their current values."
  - name: search_articles
    description: "Search PUBLISHED articles across Misar.Blog by keyword, tag, or author — including other creators' work. Use list_my_articles for your own drafts and unpublished posts."
  - name: research_topic
    description: "Research a topic and get AI-generated insights, sources, and a content outline. Useful before writing an article."
  - name: generate_title_seo
    description: "Generate 5 SEO/AEO/GEO-optimized article titles from a topic or keyword prompt. Targets high-volume, low-competition long-tail keywords. Optimized for Google, AI answer engines (ChatGPT, Perplexity, Claude), Google AI Overviews, and AI search experiences. Each title includes a keyword strategy hint."
  - name: suggest_titles
    description: "Generate 5 compelling, SEO-friendly article title options from your existing article content. Use generate_title_seo instead if you want to target specific keywords or have not written content yet."
  - name: generate_cover_image
    description: "Generate a cover image using AI and upload it to the Misar.Blog CDN"
  - name: get_series
    description: "List all your series on Misar.Blog"
  - name: create_series
    description: "Create a new series to group related articles"
  - name: add_to_series
    description: "Add an existing article to a series"
  - name: list_comments
    description: "Get public comments for an article. Rate-limited by IP — no API key required."
  - name: get_follow_status
    description: "Get public follow status and follower count for a user by their profile UUID. No API key required."
  - name: list_newsletter_subscribers
    description: "Get your newsletter subscriber list. Requires API key authentication."
  - name: list_newsletter_issues
    description: "Get your sent and scheduled newsletter issues. Requires API key authentication."
  - name: get_reactions
    description: "Get reaction counts and your reactions for an article. Requires API key."
  - name: add_reaction
    description: "Add a reaction to an article. No-ops if already reacted. Requires API key."
  - name: remove_reaction
    description: "Remove a specific reaction from an article. Requires API key."

prompts:
  - name: draft_article
    description: "Write a complete, SEO-optimised article draft and save it to Misar.Blog."
  - name: improve_seo
    description: "Audit an article for SEO/AEO/GEO and apply the improvements."
  - name: write_newsletter
    description: "Draft a newsletter issue from recent published articles."
  - name: article_ideas
    description: "Generate article ideas grounded in what has and has not been covered."
  - name: social_caption
    description: "Write platform-specific promotional captions for an article."
  - name: optimize_headline
    description: "Generate and rank stronger headline options for an article."
  - name: series_plan
    description: "Plan a multi-part article series and set it up on Misar.Blog."
  - name: engagement_report
    description: "Summarise blog performance and recommend what to do next."