# yourimageshare

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/MediaShareORG/yourimageshare  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/yourimageshare

## Description
MCP server exposing the YourImageShare upload API (upload/list/delete) as tools for AI agents.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "yourimageshare": {
    "command": "npx",
    "args": ["-y","yourimageshare"]
  }
}
```

## Documentation & README

# YourImageShare API

[![smithery badge](https://smithery.ai/badge/team-54m5/yourimageshare)](https://smithery.ai/servers/team-54m5/yourimageshare)
[![yourimageshare MCP server](https://glama.ai/mcp/servers/MediaShareORG/yourimageshare/badges/card.svg)](https://glama.ai/mcp/servers/MediaShareORG/yourimageshare)

Free JSON/REST API for [YourImageShare](https://yourimageshare.com) - a free
image and video hosting platform for anonymous and registered users. Use the
API to upload, list, and delete files programmatically instead of going
through the browser uploader.

- **Base URL:** `https://yourimageshare.com/api`
- **Auth:** an API key, sent as an `X-API-Key` header (preferred) or `?key=` fallback
- **Format:** JSON in and out, except uploads which are `multipart/form-data`
- **Full reference:** [API.md](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/API.md)
- **Live docs:** [yourimageshare.com/about/api](https://yourimageshare.com/about/api)
- **Postman collection:** [YourImageShare-API.postman_collection.json](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/YourImageShare-API.postman_collection.json)

## Get an API key

Sign in to your [account](https://yourimageshare.com/my-account) and open
the **API** tab. Your key is shown there, along with a **Regenerate**
button.

That tab also has a separate, scoped **Upload-only key** - use that one
instead anywhere the key ends up in something other people can see (a
forum plugin's page-source snippet, a public config file), since it can
only upload and not list/delete. See [Upload-only key](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/API.md#upload-only-key)
in the full reference. The [forum plugins](#forum-plugins) below already
use it.

## Quick example

```bash
curl "https://yourimageshare.com/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "uploads=@/path/to/photo.jpg"
```

```json
{
  "type": "success",
  "msg": "success",
  "data": {
    "id": "aB3xY9qRz1",
    "type": "image",
    "path": "https://i.yourimageshare.com/aB3xY9qRz1.webp",
    "src": "https://yourimageshare.com/ib/aB3xY9qRz1.webp",
    "direct": "https://yourimageshare.com/ib/aB3xY9qRz1"
  }
}
```

## Endpoints

| Method | Path | Description |
|---|---|---|
| `POST` | `/api` | Upload a file |
| `GET` | `/api` | List your uploads (paginated) |
| `DELETE` | `/api/{id}` | Delete one of your uploads |

Full request/response shapes, rate limits, error codes, and code samples in
curl, JavaScript, Python, PHP, and Go are in [API.md](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/API.md).

## Client libraries

Three official SDKs, so you don't have to hand-roll the HTTP calls, plus a
Discord bot built on top of one of them - source for all four lives in this
repo:

- **JavaScript/TypeScript:** [`yourimageshare`](https://www.npmjs.com/package/yourimageshare) on npm - `npm install yourimageshare`. Zero dependencies, works in Node.js and browsers. Source: [/js](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/js).
- **Python:** [`yourimageshare`](https://pypi.org/project/yourimageshare/) on PyPI - `pip install yourimageshare`. One dependency (`requests`), Python 3.8+. Source: [/python](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/python).
- **MCP server** (for AI coding agents - Claude Code, Cursor, and other MCP-compatible clients): [`yourimageshare-mcp`](https://www.npmjs.com/package/yourimageshare-mcp) on npm - `npx yourimageshare-mcp`, no install step. Also listed on [Smithery](https://smithery.ai/servers/team-54m5/yourimageshare) and [Glama](https://glama.ai/mcp/servers/MediaShareORG/yourimageshare). Source: [/mcp](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/mcp).
- **Discord bot**: `/upload file:<attachment>` slash command, built on the JS SDK. Self-hosted - run your own instance with your own bot token, same model as the ShareX/Flameshot integrations below, not a public bot we run. Source: [/discord](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/discord).

The three SDKs wrap the same three endpoints below (`upload`/`list`/`delete`)
with typed results and a proper exception on API errors instead of raw HTTP
handling, and are MIT licensed.

No official library for your language? The [full HTTP reference](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/API.md)
covers everything needed to call the API directly.

## Expiring uploads

Pass `expires_in` (seconds, 60 to 2,592,000) on upload to auto-delete a
file later - the storage object is removed and the page starts 410ing
within about 5 minutes of expiry. Omit it for a normal, permanent upload.

```bash
curl "https://yourimageshare.com/api" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "uploads=@/path/to/photo.jpg" \
  -F "expires_in=3600"
```

## Screenshot tools

Ready-made configs/scripts to upload straight from a screenshot tool, no
browser tab required:

- [`YourImageShare.sxcu`](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/YourImageShare.sxcu) - ShareX custom uploader
- [`yis-flameshot-upload.sh`](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/yis-flameshot-upload.sh) - Flameshot (Linux)
- [`yis-greenshot-upload.ps1`](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/yis-greenshot-upload.ps1) - Greenshot (Windows)

Setup instructions are in the comments at the top of each file, and on the
[live docs page](https://yourimageshare.com/about/api#screenshot-tools).

## Forum plugins

A real "Upload Image" button next to your forum's post editor - each one
uploads through `/api` and inserts BBCode at your cursor. All six are
configured with your **Upload-only key** (not your main API key), since
the key renders in every visitor's page source and the upload-only key
can only upload on your behalf - see [Upload-only key](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/API.md#upload-only-key).

- [`phpbb/`](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/forum-plugins/phpbb) - a real phpBB 3.2/3.3 extension ([download](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/forum-plugins/yourimageshare-phpbb.zip))
- [`smf/`](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/forum-plugins/smf) - a real SMF package ([download](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/forum-plugins/yourimageshare-smf.zip))
- [`mybb/`](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/forum-plugins/mybb) - a real MyBB 1.8 plugin ([download](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/forum-plugins/yourimageshare-mybb.zip))
- [`fluxbb/`](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/forum-plugins/fluxbb), [`punbb/`](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/forum-plugins/punbb), [`zetaboards/`](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/forum-plugins/zetaboards) - these three don't have a formal plugin system, so it's a small copy-paste snippet into your template/Admin CP instead

All six share one underlying widget, [`forum-upload.js`](https://github.com/MediaShareORG/yourimageshare/blob/HEAD/forum-plugins/forum-upload.js)
(also served live from `yourimageshare.com/assets/js/forum-upload.js`), so
fixes/improvements apply everywhere at once. Full setup instructions and
downloads are also on the [live docs page](https://yourimageshare.com/about/api#forum-plugins).

## Rate limits

Each API key gets 20 requests/minute and 500 requests/day by default, plus a
2,000/day ceiling per IP address as a backstop. Every response includes
`X-RateLimit-Limit`/`X-RateLimit-Remaining` headers; a `429` includes
`Retry-After`.

## Support

Questions or issues: [yourimageshare.com/contact](https://yourimageshare.com/contact).