yourimageshare-mcp

smithery badge yourimageshare MCP server

MCP (Model Context Protocol) server for YourImageShare. Built for AI coding agents (Claude Code, Cursor, and other MCP-compatible tools) - paste a screenshot into a bug report, a PR description, or a support thread as a real URL instead of a base64 blob or a manual upload step. Works the same way with Claude Desktop and any other MCP client.

• Get an API key: sign in and open the API tab at yourimageshare.com/my-account.
• Full HTTP reference: yourimageshare.com/about/api.
• OpenAPI 3.1 spec: yourimageshare.com/openapi.json, if your tooling prefers that to this README.

Install / run

No install needed - run directly with npx:

npx yourimageshare-mcp

Also listed on Smithery, if your MCP client installs from there instead.

Claude Desktop / Claude Code config

Add to your MCP client's config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "yourimageshare": {
      "command": "npx",
      "args": ["-y", "yourimageshare-mcp"],
      "env": {
        "YIS_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Environment variables

Tools

upload_image

Upload a file. Provide either:

• path - a local file path this server process can read, or
• base64 + filename - inline file contents, for MCP clients with no local filesystem access.

Optional expiresIn (seconds, 60 to 2,592,000 = 30 days) auto-deletes the upload later. Returns the same JSON shape as the HTTP API's upload response (id, type, path, src, direct, expires_at).

list_uploads

Optional page (defaults to 1, 50 per page). Returns your uploads newest first.

delete_upload

Requires id (from upload_image/list_uploads). Permanently deletes the upload.

Notes

• This server only ever acts as the account tied to YIS_API_KEY - there's no way for a connected agent to act as any other account.
• Errors from the API (bad key, rate limit, file rejected by moderation, etc.) come back as a tool error result with the API's own message, not a crashed tool call.
• Built as a small, self-contained client rather than depending on the separate yourimageshare npm package, so this server's releases aren't coupled to that package's.

License

MIT

Support

yourimageshare.com/contact