mcpField
Y

yourimageshare

Local
github.com/MediaShareORGFiles & Storage1Updated 1w ago
Repository

About yourimageshare

yourimageshare is an MCP server for AI coding agents and other MCP clients to manage YourImageShare uploads. It accepts local files, inline data, or public URLs and provides upload, listing, editing, and deletion tools.

Key features

  1. 01Upload files from paths, base64, or URLs
  2. 02Retrieve and edit upload details
  3. 03List and permanently delete uploads
  4. 04Set visibility and expiration

Use cases

  1. 01Add screenshot URLs to bug reports
  2. 02Share images in pull requests
  3. 03Provide images in support threads

MCP support

Exposes YourImageShare upload management through MCP tools, including upload, retrieval, listing, updating, and deletion. It uses the account associated with `YIS_API_KEY`.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "mediashareorg-yourimageshare": {
      "command": "npx",
      "args": [
        "-y",
        "yourimageshare-mcp"
      ],
      "env": {
        "YIS_API_KEY": "<YIS_API_KEY>"
      }
    }
  }
}
Run commandnpx -y yourimageshare-mcp
Environment variables to set
YIS_API_KEYSecretYour YourImageShare API key. Get one at yourimageshare.com/my-account under the API tab.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmyourimageshare-mcp1.0.6

Tools

3

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
pathstringNoLocal file path to upload.
base64stringNoBase64-encoded file contents. Requires `filename`.
filenamestringNoFilename to use. Required with `base64`; inferred from `path` otherwise.
expiresInintegerNoAuto-delete after this many seconds (60 to 2,592,000 = 30 days). Omit for a permanent upload.

Details

From the project README

yourimageshare-mcp

npm version npm downloads 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.

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

VariableRequiredPurpose
YIS_API_KEYyesYour YourImageShare API key.
YIS_BASE_URLnoOverride the API base URL (default https://yourimageshare.com/api). For testing only.

Tools

upload_image

Upload a file (up to 200 MB - files over 90 MB are sent in pieces automatically). Provide exactly one of:

  • path - a local file path this server process can read,
  • base64 + filename - inline file contents, for MCP clients with no local filesystem access, or
  • url - a public http(s) link the YourImageShare server downloads itself.

Optional expiresIn (seconds, 60 to 2,592,000 = 30 days) auto-deletes the upload later. If the account already uploaded this exact file, the existing upload is returned with duplicate: true; set allowDuplicate to store a new copy. Returns id, type, path, src, direct, thumb (280 px WebP thumbnail), width, height, size, locked, expires_at and duplicate - store src, since path can change after conversion.

Also optional: visibility (unlisted by default - file and page for anyone with the link; private - file only, no page for others; public - listed), title (90 characters) and description (500). New uploads return a one-time delete_url.

get_upload

Requires id. Returns that upload's links, thumbnail, size, visibility, title and description.

update_upload

Requires id, plus any of visibility, title, description. Only what you pass changes; an empty string clears a title or description.

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.