{
  "name": "com.justneeda/justneeda",
  "title": "JustNeeda",
  "description": "Done-for-you agency for small local businesses: website ($99/month), social media management, content packs, local SEO and Google Business Profile. $0 down, month-to-month, everything by message.",
  "version": "1.2.0",
  "homepage": "https://justneeda.com",
  "documentation": "https://justneeda.com/docs/mcp",
  "support": "https://justneeda.com/support",
  "support_email": "contact@justneeda.com",
  "privacy_policy": "https://justneeda.com/legal/privacy",
  "terms_of_service": "https://justneeda.com/legal/terms",
  "icon": "https://justneeda.com/icon-512.png",
  "openapi": "https://justneeda.com/openapi.json",
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://justneeda.com/api/mcp"
    }
  ],
  "authentication": {
    "type": "oauth2",
    "spec": "OAuth 2.1 with PKCE (S256) and dynamic client registration",
    "protected_resource_metadata": "https://justneeda.com/.well-known/oauth-protected-resource/api/mcp",
    "authorization_server_metadata": "https://justneeda.com/.well-known/oauth-authorization-server",
    "scopes": [
      "sites:read",
      "sites:write"
    ]
  },
  "capabilities": {
    "tools": true,
    "resources": true,
    "prompts": true
  },
  "tools": [
    {
      "name": "check_brief",
      "title": "Check a business description",
      "description": "Validate a business description before generating a website, without creating anything or using quota. Returns the normalized brief that create_preview would use, or a clear message saying what is missing. Use it to fix the description with the user first.",
      "annotations": {
        "title": "Check a business description",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "list_sites",
      "title": "List my websites",
      "description": "List the website previews and published sites in the signed-in JustNeeda account, newest first, with their status, preview link, edits left and live URL when published.",
      "annotations": {
        "title": "List my websites",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_preview",
      "title": "Get a website preview",
      "description": "Get one website preview: generation status, preview link, the page outline (headline, services, about, FAQ, contact, theme) and how many free changes are left. Set include_full_content to get every section's text.",
      "annotations": {
        "title": "Get a website preview",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "list_edits",
      "title": "List edits of a website",
      "description": "List every change requested on a website, on the preview and after publishing, with its status (applying, applied, failed), plus the number of edits used and left.",
      "annotations": {
        "title": "List edits of a website",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_publish_status",
      "title": "Get publishing status",
      "description": "Track whether a website is still a preview, ready to publish, being published after payment, live or paused (subscription ended). Returns the live URL, the plan and billing status, changes left this month and any pending edit.",
      "annotations": {
        "title": "Get publishing status",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "create_preview",
      "title": "Generate a website preview",
      "description": "Generate a complete one-page website from a business description and save it as a free, private preview in the account. Takes about a minute; the call waits up to 50 seconds, then returns the preview (or status 'generating': call get_preview again shortly). Nothing is published and nothing is charged. Limited to a few previews per day.",
      "annotations": {
        "title": "Generate a website preview",
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": false
      }
    },
    {
      "name": "edit_preview",
      "title": "Edit a website preview",
      "description": "Apply one plain-English change to an unpublished preview, e.g. 'make the headline warmer' or 'add a gift card service'. The AI rewrites the affected content and replaces the current version. Previews include 2 free changes; publishing unlocks 20 more. Waits up to 50 seconds for the result.",
      "annotations": {
        "title": "Edit a website preview",
        "readOnlyHint": false,
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": false
      }
    },
    {
      "name": "start_publish",
      "title": "Start publishing a website",
      "description": "Create a secure Stripe checkout link to put a ready preview online: a monthly plan of $99 with $0 down (hosting, SSL, domain, maintenance, 10 edits a month, local SEO basics, support), month-to-month, cancelled from the billing portal. This tool does not charge anything: give the link to the user, who pays in their browser. The site goes live at a justneeda.com address right after payment; follow it with get_publish_status.",
      "annotations": {
        "title": "Start publishing a website",
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "edit_live_site",
      "title": "Edit a published website",
      "description": "Apply one plain-English change to a published, live website. The change replaces the current content on the public site. Each request uses one of the 10 changes included each month (sites bought once before 2026-11-12 keep their 20 changes in total). Waits up to 50 seconds for the result.",
      "annotations": {
        "title": "Edit a published website",
        "readOnlyHint": false,
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "update_site_contact",
      "title": "Update contact details on a live site",
      "description": "Change the contact details shown on a published website (email, phone, address, hours, booking link, city) without using an AI edit. Only the fields you pass are changed; the public site updates immediately.",
      "annotations": {
        "title": "Update contact details on a live site",
        "readOnlyHint": false,
        "destructiveHint": true,
        "idempotentHint": true,
        "openWorldHint": true
      }
    },
    {
      "name": "list_services",
      "title": "List JustNeeda services",
      "description": "List every JustNeeda service ('I just need X'): what it delivers, its monthly price in USD ($0 down, month-to-month), changes included each month, limits, and the brief fields order_service expects. The website is ordered with create_preview instead.",
      "annotations": {
        "title": "List JustNeeda services",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "order_service",
      "title": "Order a service",
      "description": "Start a subscription to a catalog service (community, content, seo...): monthly plan in USD, $0 down, month-to-month. Validates the brief and returns a Stripe checkout link the user opens and pays in their browser; the first delivery starts right after payment and lands in the order space (order_url), then every month. Nothing is charged by this call. Never invent facts for the brief: ask the user.",
      "annotations": {
        "title": "Order a service",
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "list_orders",
      "title": "List my service orders",
      "description": "List the catalog orders (content packs, community management, SEO reports) in the signed-in account, newest first, with status and private order link. Websites are listed by list_sites.",
      "annotations": {
        "title": "List my service orders",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "get_order",
      "title": "Get a service order",
      "description": "Get one catalog order with its deliverables: the content pack (articles and posts), the SEO report (score, issues, rewrites, schema, plan), or for community management the calendar, upcoming and published posts, connections and monthly reports. Set include_full_content for every text in full.",
      "annotations": {
        "title": "Get a service order",
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      }
    },
    {
      "name": "revise_content",
      "title": "Rewrite a piece of a content pack",
      "description": "Rewrite one article or one social post of a delivered content pack, following a plain-English instruction. Uses one of the included rewrites; a failed rewrite is not counted.",
      "annotations": {
        "title": "Rewrite a piece of a content pack",
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": false
      }
    },
    {
      "name": "recheck_seo",
      "title": "Re-check a site after SEO fixes",
      "description": "Crawl the site of an SEO order again and return the new score and remaining issues. Uses one of the extra re-checks included each month (the monthly check itself is automatic).",
      "annotations": {
        "title": "Re-check a site after SEO fixes",
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      }
    },
    {
      "name": "update_post",
      "title": "Edit, rewrite or skip a scheduled post",
      "description": "Change a community management post before it is published: replace its text (action edit), rewrite it with AI from an instruction (action rewrite, uses one monthly rewrite), skip it, or restore a skipped post.",
      "annotations": {
        "title": "Edit, rewrite or skip a scheduled post",
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": false
      }
    },
    {
      "name": "cancel_subscription",
      "title": "Cancel or resume a subscription",
      "description": "Cancel any catalog subscription (community management, content, SEO) at the end of the paid month (nothing more is charged, deliveries stop at that date), or resume it before that date with resume=true. Confirm with the user first.",
      "annotations": {
        "title": "Cancel or resume a subscription",
        "readOnlyHint": false,
        "destructiveHint": true,
        "idempotentHint": true,
        "openWorldHint": true
      }
    }
  ],
  "prompts": [
    {
      "name": "build_my_website",
      "title": "Build my website",
      "description": "Turn a short business description into a website preview, then review it together."
    },
    {
      "name": "improve_my_preview",
      "title": "Improve my preview",
      "description": "Review a preview with the user and apply up to two changes."
    },
    {
      "name": "publish_my_site",
      "title": "Publish my site",
      "description": "Check a preview is ready, get the checkout link and follow publication."
    }
  ]
}