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

21 tools across 5 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 4 read-only resources (sharpii://models, sharpii://aspect-ratios, sharpii://presets/skin-modes, sharpii://docs/quickstart) and 4 prompts (cinematic_portrait, product_shot, animate_my_photo, make_a_short).

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):

--api-key=shp_... CLI flag.
SHARPII_API_KEY env var.
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

Full setup walkthrough: sharpii.ai/api-documentation/mcp
API reference: sharpii.ai/api-documentation

License

MIT.