JSPM

@sharpiiai/mcp

0.2.0
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 29
  • Score
    100M100P100Q73057F
  • License MIT

Sharpii MCP server — generate images, videos, audio, upscale, and edit media via Claude / Cursor / Claude Code

Package Exports

  • @sharpiiai/mcp
  • @sharpiiai/mcp/dist/stdio.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@sharpiiai/mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@sharpiiai/mcp

The official MCP server for Sharpii.ai. Lets Claude / Claude Code / Cursor / Windsurf generate images, videos, audio, upscale, and edit media via natural language.

npx -y @sharpiiai/mcp --api-key=shp_your_key

Install in your host

Claude Desktop / Claude Code / Cursor / Windsurf

Add to your host's MCP config:

{
  "mcpServers": {
    "sharpii": {
      "command": "npx",
      "args": ["-y", "@sharpiiai/mcp"],
      "env": { "SHARPII_API_KEY": "shp_..." }
    }
  }
}

Get an API key at sharpii.ai/account/api-keys.

What it does

20 tools across 6 areas:

Area Tools
Settings & diagnostics set_api_key, debug_credentials, list_models
Credits & usage get_credit_balance, get_usage
Tasks get_task, wait_for_task, upload_file, download_output
Image generate_image, generate_image_and_wait, upscale_image, edit_skin
Video generate_video, edit_video, animate_image, lipsync
Audio generate_speech, generate_music, clone_voice

Plus 5 read-only resources (sharpii://models, sharpii://aspect-ratios, sharpii://presets/skin-modes, sharpii://presets/voices, sharpii://docs/quickstart) and 25 prompts — 4 direct workflows (cinematic_portrait, product_shot, animate_my_photo, make_a_short) and 21 planning skills that ask clarifying questions first, never generate blindly:

Skill What it does
vibe_picker Surfaces 8 vibes when the user is unsure
scene_customizer Asks what to change in a supplied photo before feeding it to a model
scene_planner Storyboards multi-shot sequences before generating
videographer Walks through lens / move / framing / lighting / palette
viral_hook_writer Drafts 5 hook scripts before any visuals
ugc_maker Full UGC ad pipeline (persona + hook + scene + voice + lipsync)
social_hook 3-second visual scroll-stopper
explainer_video Educational / SaaS explainer
talking_head_avatar Portrait + script → lipsynced video
product_360, brand_story, music_video_concept Format-specific planners
cinematic_style, anime_action, cgi_3d_style, fight_scene, motion_design_ad Style prompt-engineers
ecommerce_ad, fashion_lookbook, real_estate_tour, food_beverage_ad Industry templates

Output mode — where generated media goes

By default every result is auto-saved to a local folder, in addition to the CDN URL:

  • macOS / Linux: ~/Documents/Sharpii/
  • Windows: %USERPROFILE%\Documents\Sharpii\

Override the folder with SHARPII_MCP_OUTPUT_DIR=/absolute/path. To skip the local copy entirely (URLs only), set SHARPII_MCP_OUTPUT_MODE=urls.

Var Default Effect
SHARPII_MCP_OUTPUT_MODE files files (default) auto-downloads to disk + returns URL + local path. urls returns CDN URLs only.
SHARPII_MCP_OUTPUT_DIR ~/Documents/Sharpii/ Directory for saved files.
SHARPII_MCP_FILENAME_TEMPLATE {model}-{task_id_short}-{index}.{ext} Filename template tokens.

Changing the API key

Three priorities (highest first):

  1. --api-key=shp_... CLI flag.
  2. SHARPII_API_KEY env var.
  3. The set_api_key tool — persists to ~/.sharpii/mcp.json. Use this to swap keys without editing host config JSON.

Local files

Every media argument accepts a URL, a local path, or a base64 data URI. Local paths are uploaded to Sharpii's CDN automatically before the API call:

Upscale ./photo.jpg to 8K with the smart upscaler.

The MCP reads the file from your project directory, uploads it, and submits the upscale job — no manual upload step needed.

Errors

Every tool error has a structured _meta.sharpii.error_code, e.g.:

Code Meaning
no_api_key Set SHARPII_API_KEY or use set_api_key.
credits_too_low Top up at sharpii.ai/billing.
unknown_model Call list_models.
content_policy_violation Re-prompt; no charge.

Run debug_credentials first when something's not working.

Documentation

License

MIT.