Yourimageshare MCP server

YourImageShare API

Free JSON/REST API for YourImageShare - 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
• Live docs: yourimageshare.com/about/api
• Postman collection: YourImageShare-API.postman_collection.json

Get an API key

Sign in to your 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 in the full reference. The forum plugins below already use it.

Quick example

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

{
  "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

Full request/response shapes, rate limits, error codes, and code samples in curl, JavaScript, Python, PHP, and Go are in API.md.

Client libraries

Ten official SDKs (across nine languages/runtimes, JS/TS counted once with two registries), so you don't have to hand-roll the HTTP calls, plus a Discord bot built on top of one of them:

Shortened. The full README is on GitHub.