{"_id":"@cuppa-ai/mcp-server","name":"@cuppa-ai/mcp-server","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@cuppa-ai/mcp-server","version":"0.1.0","description":"Cuppa AI MCP Server - Content generation, SEO optimization, and brand management tools for AI clients","license":"MIT","type":"module","main":"dist/index.js","bin":{"cuppa-mcp":"dist/bin/cli.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/bin/cli.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","zod":"^3.24.2"},"devDependencies":{"typescript":"^5.7.3","@types/node":"^22.13.4"},"engines":{"node":">=18"},"keywords":["mcp","cuppa","ai","content-generation","seo","model-context-protocol"],"_id":"@cuppa-ai/mcp-server@0.1.0","gitHead":"b0982f89346026b069f27690e199575deef45cd3","types":"./dist/index.d.ts","_nodeVersion":"20.9.0","_npmVersion":"10.1.0","dist":{"integrity":"sha512-j5MG5qhzLAEKAucE6krRuRMonutPurA4Z18yXnHOdgbyuruvt76f/cR3DpS5NGtNgjOGSTcnH4yWqTg0nnXOZQ==","shasum":"d3094db1ec69fc95d0c54ba83a670a13bb534602","tarball":"https://registry.npmjs.org/@cuppa-ai/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":86,"unpackedSize":337985,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDAp4ede+KE0zaJ87Ng8Pq/+cvLrlOgJAIft1/aHStU0AiBXmHdFDazQkmCml0IhzT34UR5tVRNj32BLA5eFxermYQ=="}]},"_npmUser":{"name":"cuppa--ai","email":"hello@cuppa.ai"},"directories":{},"maintainers":[{"name":"cuppa--ai","email":"hello@cuppa.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.0_1775158044882_0.2428647613590147"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-02T19:27:24.787Z","0.1.0":"2026-04-02T19:27:25.046Z","modified":"2026-04-02T19:27:25.253Z"},"maintainers":[{"name":"cuppa--ai","email":"hello@cuppa.ai"}],"description":"Cuppa AI MCP Server - Content generation, SEO optimization, and brand management tools for AI clients","keywords":["mcp","cuppa","ai","content-generation","seo","model-context-protocol"],"license":"MIT","readme":"# @cuppa-ai/mcp-server\n\nModel Context Protocol (MCP) server for [Cuppa AI](https://cuppa.ai). Gives AI clients (Cursor, Claude Desktop, Windsurf, etc.) full access to Cuppa's content generation, SEO optimization, and brand management capabilities.\n\n## Quick Start\n\n### 1. Get your API key\n\nGo to [Cuppa Settings > API Keys](https://app.cuppa.ai/team/settings/api/keys) and create a key.\n\n### 2. Configure your MCP client\n\n**Cursor** (`.cursor/mcp.json` in your project or global config):\n\n```json\n{\n  \"mcpServers\": {\n    \"cuppa\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@cuppa-ai/mcp-server\"],\n      \"env\": {\n        \"CUPPA_API_KEY\": \"cpa-your-key-here\"\n      }\n    }\n  }\n}\n```\n\n**Claude Desktop** (`claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"cuppa\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@cuppa-ai/mcp-server\"],\n      \"env\": {\n        \"CUPPA_API_KEY\": \"cpa-your-key-here\"\n      }\n    }\n  }\n}\n```\n\n**Windsurf / Cline / other MCP clients**: Same pattern. Point to `npx -y @cuppa-ai/mcp-server` with `CUPPA_API_KEY` env var.\n\n## Available Tools (70+)\n\n### Content Creation (6 tools)\n\n| Tool                 | Description                           |\n| -------------------- | ------------------------------------- |\n| `create_content`     | Generate an AI article from a keyword |\n| `get_content_status` | Poll article generation progress      |\n| `get_content`        | Retrieve generated article            |\n| `list_contents`      | List articles with filters            |\n| `delete_content`     | Delete an article                     |\n| `publish_content`    | Push to connected CMS                 |\n\n### Content Grading & SERP (5 tools)\n\n| Tool                | Description                      |\n| ------------------- | -------------------------------- |\n| `grade_content`     | Trigger SEO/readability grading  |\n| `get_content_grade` | Get grading results              |\n| `fetch_serp_data`   | Trigger SERP competitor analysis |\n| `get_serp_data`     | Get SERP analysis results        |\n| `optimize_content`  | Get AI optimization suggestions  |\n\n### Projects / Bulk Generation (4 tools)\n\n| Tool             | Description                    |\n| ---------------- | ------------------------------ |\n| `create_project` | Create bulk generation project |\n| `list_projects`  | List projects                  |\n| `get_project`    | Get project details            |\n| `export_project` | Export project articles        |\n\n### Research (4 tools)\n\n| Tool                   | Description                      |\n| ---------------------- | -------------------------------- |\n| `research_keywords`    | Keyword research from seed terms |\n| `research_serp`        | SERP analysis for a keyword      |\n| `research_competitors` | Competitor content analysis      |\n| `research_cluster`     | Topic cluster research           |\n\n### Images (2 tools)\n\n| Tool                   | Description                        |\n| ---------------------- | ---------------------------------- |\n| `generate_image`       | Generate an AI image               |\n| `generate_images_bulk` | Bulk image generation for articles |\n\n### Brand & Knowledge (7 tools)\n\n| Tool                        | Description                             |\n| --------------------------- | --------------------------------------- |\n| `get_brand`                 | Get Brand DNA for a site                |\n| `update_brand_context`      | Update brand context fields             |\n| `update_brand_visual_style` | Update colors, fonts, logo              |\n| `get_notebook`              | List client notes / meeting transcripts |\n| `list_knowledge`            | List knowledge sources                  |\n| `create_knowledge`          | Create text knowledge source            |\n| `get_knowledge`             | Get knowledge source details            |\n\n### Presets / AI Instructions (5 tools)\n\n| Tool            | Description          |\n| --------------- | -------------------- |\n| `list_presets`  | List writing presets |\n| `get_preset`    | Get preset details   |\n| `create_preset` | Create a preset      |\n| `update_preset` | Update a preset      |\n| `delete_preset` | Delete a preset      |\n\n### Templates (2 tools)\n\n| Tool             | Description           |\n| ---------------- | --------------------- |\n| `list_templates` | List custom templates |\n| `get_template`   | Get template details  |\n\n### Clusters (5 tools)\n\n| Tool                 | Description            |\n| -------------------- | ---------------------- |\n| `generate_cluster`   | Generate topic cluster |\n| `list_clusters`      | List clusters          |\n| `get_cluster`        | Get cluster details    |\n| `activate_cluster`   | Add cluster to plan    |\n| `deactivate_cluster` | Remove from plan       |\n\n### Content Planner & Strategy (7 tools)\n\n| Tool                      | Description                                       |\n| ------------------------- | ------------------------------------------------- |\n| `list_planner`            | List planner items                                |\n| `create_planner_item`     | Add to content plan                               |\n| `update_planner_item`     | Update planner item                               |\n| `delete_planner_item`     | Remove planner item                               |\n| `get_content_calendar`    | Unified calendar (articles + local + social)      |\n| `get_content_strategy`    | Get site content strategy settings                |\n| `update_content_strategy` | Update article defaults, social, newsletter, etc. |\n\n### Performance Hub (4 tools)\n\n| Tool                    | Description                                                   |\n| ----------------------- | ------------------------------------------------------------- |\n| `get_brand_performance` | KPIs, visibility score, and quick wins from Performance Hub   |\n| `get_content_health`    | Top pages, content decay, striking distance, cannibalization  |\n| `get_ai_visibility`     | LLM mentions, top prompts, cited pages, citation gaps         |\n| `get_backlinks`         | Domain rating, backlink stats, referring domains (via Ahrefs) |\n\n### Newsletters (3 tools)\n\n| Tool                  | Description                                        |\n| --------------------- | -------------------------------------------------- |\n| `list_newsletters`    | List generated newsletters for a site              |\n| `get_newsletter`      | Get newsletter details with full content and HTML  |\n| `generate_newsletter` | Generate weekly newsletter from published articles |\n\n### Social Media (12 tools)\n\n| Tool                    | Description                                                                                                                |\n| ----------------------- | -------------------------------------------------------------------------------------------------------------------------- |\n| `generate_social`       | Generate social post (from article OR standalone topic)                                                                    |\n| `generate_social_multi` | Multi-platform post generation                                                                                             |\n| `publish_social`        | Publish to platform immediately                                                                                            |\n| `schedule_social`       | Schedule a post for future publishing                                                                                      |\n| `list_social_platforms` | List connected platforms with best practices                                                                               |\n| `list_social_posts`     | List social posts with filters                                                                                             |\n| `get_social_post`       | Get social post details (with analytics)                                                                                   |\n| `update_social_post`    | Update draft/scheduled post                                                                                                |\n| `delete_social_post`    | Delete draft/scheduled post                                                                                                |\n| `get_social_analytics`  | Live social analytics: impressions, engagements, reach, followers, best posting times, content decay, top posts with links |\n| `generate_carousel`     | Generate LinkedIn carousel slides                                                                                          |\n| `publish_carousel`      | Publish carousel to LinkedIn                                                                                               |\n\n### Sites & GSC (3 tools)\n\n| Tool              | Description             |\n| ----------------- | ----------------------- |\n| `list_sites`      | List sites/brands       |\n| `create_site`     | Create a new site       |\n| `get_gsc_queries` | Get Search Console data |\n\n### Research Agents (3 tools)\n\n| Tool                | Description                   |\n| ------------------- | ----------------------------- |\n| `list_agents`       | List research agents          |\n| `get_agent`         | Get agent with latest results |\n| `trigger_agent_run` | Trigger manual agent run      |\n\n### Links & Infrastructure (5 tools)\n\n| Tool                  | Description                 |\n| --------------------- | --------------------------- |\n| `get_link_stats`      | Link Engine stats           |\n| `get_link_categories` | List link categories        |\n| `list_models`         | Available text models       |\n| `list_image_models`   | Available image models      |\n| `chat`                | Brand-aware chat completion |\n\n## Environment Variables\n\n| Variable        | Required | Description                                             |\n| --------------- | -------- | ------------------------------------------------------- |\n| `CUPPA_API_KEY` | Yes      | Your Cuppa API key (starts with `cpa-`)                 |\n| `CUPPA_API_URL` | No       | Override API base URL (default: `https://api.cuppa.ai`) |\n\n## Plan Requirements\n\nSome tools require specific plan tiers:\n\n| Feature                    | Minimum Plan |\n| -------------------------- | ------------ |\n| Content generation, images | All plans    |\n| Knowledge sources          | Power        |\n| Custom templates           | Business     |\n| Research agents            | Power        |\n| Link Engine                | Business     |\n| Brand Notebook             | Agency       |\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run locally\nCUPPA_API_KEY=cpa-xxx node dist/bin/cli.js\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-56302b45b4e7ebed640fa9d1bdc11daf"}