Imgur MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Imgur: 20 typed functions through one MCP server. No Imgur API key needed.
- Site
- imgur.com
- Functions
- 20
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Imgur alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/imgurOne MCP server for Imgur and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
getGalleryPostsLists the gallery feed (most viral, user submitted, or top) with sort and paging, logged out.Arguments
Name Type Required section"hot" | "top" | "new""hot" (default), "top", or "new" (newest user submissions).No sort"newest" | "top" | "viral""newest" (default; "top" for the top section), "top" or "viral".No pagenumber1-50, default 1.No Returns
ImgurPost[]interface ImgurMedia { id: string; type: string; mimeType: string; url: string; width: number | null; height: number | null; size: number | null; title: string | null; description: string | null; isAnimated: boolean; duration: number | null } interface ImgurPost { id: string; title: string; description: string | null; url: string; accountId: number | null; createdAt: string | null; views: number; upvotes: number; downvotes: number; points: number; comments: number; favorites: number; imageCount: number; isAlbum: boolean; isMature: boolean; cover: ImgurMedia | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/getGalleryPostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.getGalleryPosts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.getGalleryPosts())curl -X POST https://api.bowmark.ai/v1/sites/imgur/getGalleryPosts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.getGalleryPosts();getImageResolves a direct image/video id or i.imgur.com link to its media URL, size and type.Arguments
Name Type Required idOrUrlstringYes Returns
ImgurImageinterface ImgurImage { id: string; url: string; mimeType: string; width: number | null; height: number | null; size: number | null; views: number; title: string | null; description: string | null; isAnimated: boolean; mp4Url: string | null; createdAt: string | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/getImageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.getImage("xfwvhd6");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.getImage("xfwvhd6"))curl -X POST https://api.bowmark.ai/v1/sites/imgur/getImage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"xfwvhd6"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.getImage("xfwvhd6");getMyFavoritesLists the signed-in account's favorites, including private ones.Arguments
Name Type Required usernamestringYes sort"newest" | "oldest" | "top" | "best" | "worst""newest" (default), "oldest" or "top" (posts); "best"/"worst" for comments.No pagenumber1-50, default 1.No Returns
ImgurPost[]interface ImgurMedia { id: string; type: string; mimeType: string; url: string; width: number | null; height: number | null; size: number | null; title: string | null; description: string | null; isAnimated: boolean; duration: number | null } interface ImgurPost { id: string; title: string; description: string | null; url: string; accountId: number | null; createdAt: string | null; views: number; upvotes: number; downvotes: number; points: number; comments: number; favorites: number; imageCount: number; isAlbum: boolean; isMature: boolean; cover: ImgurMedia | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/getMyFavoritesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.getMyFavorites();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.getMyFavorites())curl -X POST https://api.bowmark.ai/v1/sites/imgur/getMyFavorites \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.getMyFavorites();getMyPostsLists the signed-in account's posts and uploads, including hidden ones.Arguments
Name Type Required usernamestringYes sort"newest" | "oldest" | "top" | "best" | "worst""newest" (default), "oldest" or "top" (posts); "best"/"worst" for comments.No pagenumber1-50, default 1.No Returns
ImgurPost[]interface ImgurMedia { id: string; type: string; mimeType: string; url: string; width: number | null; height: number | null; size: number | null; title: string | null; description: string | null; isAnimated: boolean; duration: number | null } interface ImgurPost { id: string; title: string; description: string | null; url: string; accountId: number | null; createdAt: string | null; views: number; upvotes: number; downvotes: number; points: number; comments: number; favorites: number; imageCount: number; isAlbum: boolean; isMature: boolean; cover: ImgurMedia | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/getMyPostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.getMyPosts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.getMyPosts())curl -X POST https://api.bowmark.ai/v1/sites/imgur/getMyPosts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.getMyPosts();getNotificationsLists the signed-in account's notifications (replies, votes, follows).Arguments
None.
Returns
ImgurNotification[]interface ImgurNotification { id: string; kind: string; viewed: boolean; text: string | null; postId: string | null; author: string | null; createdAt: string | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/getNotificationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.getNotifications();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.getNotifications())curl -X POST https://api.bowmark.ai/v1/sites/imgur/getNotifications \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.getNotifications();getPostGets one post by id or URL: title, description, media items, counts and author.Arguments
Name Type Required idOrUrlstringYes Returns
ImgurPostDetailinterface ImgurMedia { id: string; type: string; mimeType: string; url: string; width: number | null; height: number | null; size: number | null; title: string | null; description: string | null; isAnimated: boolean; duration: number | null } interface ImgurPost { id: string; title: string; description: string | null; url: string; accountId: number | null; createdAt: string | null; views: number; upvotes: number; downvotes: number; points: number; comments: number; favorites: number; imageCount: number; isAlbum: boolean; isMature: boolean; cover: ImgurMedia | null } interface ImgurAuthor { id: number | null; username: string; avatarUrl: string | null } interface ImgurPostDetail extends ImgurPost { author: ImgurAuthor | null; media: ImgurMedia[] }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/getPostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.getPost("<idOrUrl>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.getPost("<idOrUrl>"))curl -X POST https://api.bowmark.ai/v1/sites/imgur/getPost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"<idOrUrl>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.getPost("<idOrUrl>");getPostCommentsLists a post's comments with their replies, sorted best/new/top.Arguments
Name Type Required idOrUrlstring | ImgurCommentsArgsYes interface ImgurCommentsArgs { /** post id or URL */ id: string; /** default "best" */ sort?: "best" | "new" | "top"; page?: number; }Returns
ImgurComment[]interface ImgurAuthor { id: number | null; username: string; avatarUrl: string | null } interface ImgurComment { id: number; parentId: number | null; text: string; author: ImgurAuthor | null; postId: string; upvotes: number; downvotes: number; points: number; platform: string | null; createdAt: string | null; deleted: boolean; replies: ImgurComment[] }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/getPostCommentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.getPostComments("<idOrUrl>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.getPostComments("<idOrUrl>"))curl -X POST https://api.bowmark.ai/v1/sites/imgur/getPostComments \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"<idOrUrl>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.getPostComments("<idOrUrl>");getTagGets one tag (name, followers, total posts) and its posts, with sort and paging.Arguments
Name Type Required tagstring | ImgurTagArgsYes interface ImgurTagArgs { /** tag name or imgur.com/t/<tag> URL */ tag: string; /** default "viral" */ sort?: "viral" | "top" | "newest"; page?: number; }Returns
ImgurTaginterface ImgurMedia { id: string; type: string; mimeType: string; url: string; width: number | null; height: number | null; size: number | null; title: string | null; description: string | null; isAnimated: boolean; duration: number | null } interface ImgurPost { id: string; title: string; description: string | null; url: string; accountId: number | null; createdAt: string | null; views: number; upvotes: number; downvotes: number; points: number; comments: number; favorites: number; imageCount: number; isAlbum: boolean; isMature: boolean; cover: ImgurMedia | null } interface ImgurTag { name: string; displayName: string; description: string | null; followers: number; totalPosts: number; url: string; posts: ImgurPost[] }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/getTagCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.getTag("aww");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.getTag("aww"))curl -X POST https://api.bowmark.ai/v1/sites/imgur/getTag \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"tag":"aww"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.getTag("aww");getUserGets a user's public profile by username: bio, reputation, avatar, joined date.Arguments
Name Type Required usernamestringYes Returns
ImgurUserinterface ImgurUser { id: number; username: string; bio: string | null; reputation: number; reputationName: string | null; avatarUrl: string | null; coverUrl: string | null; createdAt: string | null; url: string; trophies: { name: string; description: string | null; imageUrl: string | null }[] }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/getUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.getUser("imgur");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.getUser("imgur"))curl -X POST https://api.bowmark.ai/v1/sites/imgur/getUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"imgur"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.getUser("imgur");getUserCommentsLists a user's public comments.Arguments
Name Type Required usernamestring | ImgurUserListArgsYes interface ImgurUserListArgs { username: string; /** "newest" (default), "oldest" or "top" (posts); "best"/"worst" for comments */ sort?: "newest" | "oldest" | "top" | "best" | "worst"; /** 1-50, default 1 */ page?: number; }Returns
ImgurUserComment[]interface ImgurUserComment { id: number; postId: string; text: string; author: string | null; upvotes: number; downvotes: number; points: number; platform: string | null; createdAt: string | null; parentId: number | null; deleted: boolean }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/getUserCommentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.getUserComments("J3lek");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.getUserComments("J3lek"))curl -X POST https://api.bowmark.ai/v1/sites/imgur/getUserComments \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"J3lek"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.getUserComments("J3lek");getUserFavoritesLists a user's public favorites.Arguments
Name Type Required usernamestring | ImgurUserListArgsYes interface ImgurUserListArgs { username: string; /** "newest" (default), "oldest" or "top" (posts); "best"/"worst" for comments */ sort?: "newest" | "oldest" | "top" | "best" | "worst"; /** 1-50, default 1 */ page?: number; }Returns
ImgurPost[]interface ImgurMedia { id: string; type: string; mimeType: string; url: string; width: number | null; height: number | null; size: number | null; title: string | null; description: string | null; isAnimated: boolean; duration: number | null } interface ImgurPost { id: string; title: string; description: string | null; url: string; accountId: number | null; createdAt: string | null; views: number; upvotes: number; downvotes: number; points: number; comments: number; favorites: number; imageCount: number; isAlbum: boolean; isMature: boolean; cover: ImgurMedia | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/getUserFavoritesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.getUserFavorites("J3lek");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.getUserFavorites("J3lek"))curl -X POST https://api.bowmark.ai/v1/sites/imgur/getUserFavorites \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"J3lek"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.getUserFavorites("J3lek");getUserPostsLists a user's public submitted posts.Arguments
Name Type Required usernamestring | ImgurUserListArgsYes interface ImgurUserListArgs { username: string; /** "newest" (default), "oldest" or "top" (posts); "best"/"worst" for comments */ sort?: "newest" | "oldest" | "top" | "best" | "worst"; /** 1-50, default 1 */ page?: number; }Returns
ImgurPost[]interface ImgurMedia { id: string; type: string; mimeType: string; url: string; width: number | null; height: number | null; size: number | null; title: string | null; description: string | null; isAnimated: boolean; duration: number | null } interface ImgurPost { id: string; title: string; description: string | null; url: string; accountId: number | null; createdAt: string | null; views: number; upvotes: number; downvotes: number; points: number; comments: number; favorites: number; imageCount: number; isAlbum: boolean; isMature: boolean; cover: ImgurMedia | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/getUserPostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.getUserPosts("J3lek");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.getUserPosts("J3lek"))curl -X POST https://api.bowmark.ai/v1/sites/imgur/getUserPosts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"username":"J3lek"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.getUserPosts("J3lek");listTagsLists trending and featured tags, the door to a tag's posts.Arguments
None.
Returns
ImgurTagSummary[]interface ImgurTagSummary { name: string; displayName: string; description: string | null; followers: number; totalPosts: number; url: string }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/listTagsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.listTags();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.listTags())curl -X POST https://api.bowmark.ai/v1/sites/imgur/listTags \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.listTags();searchPostsSearches imgur's gallery for posts matching a query, logged out.Arguments
Name Type Required querystring | ImgurSearchArgsYes interface ImgurSearchArgs { query: string; /** default "all" */ window?: "day" | "week" | "month" | "year" | "all"; /** default "top" */ sort?: "newest" | "top" | "viral"; page?: number; }Returns
ImgurPost[]interface ImgurMedia { id: string; type: string; mimeType: string; url: string; width: number | null; height: number | null; size: number | null; title: string | null; description: string | null; isAnimated: boolean; duration: number | null } interface ImgurPost { id: string; title: string; description: string | null; url: string; accountId: number | null; createdAt: string | null; views: number; upvotes: number; downvotes: number; points: number; comments: number; favorites: number; imageCount: number; isAlbum: boolean; isMature: boolean; cover: ImgurMedia | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/searchPostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.searchPosts("cats");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.searchPosts("cats"))curl -X POST https://api.bowmark.ai/v1/sites/imgur/searchPosts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"cats"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.searchPosts("cats");
addCommentComments on a post, or replies to a comment.Arguments
Name Type Required input{ id: string; text: string; parentId?: string }Yes Returns
ImgurWriteResultinterface ImgurWriteResult { ok: boolean; id: string; action: string; commentId: string | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/addCommentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.addComment({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.addComment({}))curl -X POST https://api.bowmark.ai/v1/sites/imgur/addComment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.addComment({});deleteCommentDeletes one of the signed-in account's own comments by its numeric id.Arguments
Name Type Required comment{ id: string }Yes Returns
ImgurWriteResultinterface ImgurWriteResult { ok: boolean; id: string; action: string; commentId: string | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/deleteCommentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.deleteComment({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.deleteComment({}))curl -X POST https://api.bowmark.ai/v1/sites/imgur/deleteComment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"comment":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.deleteComment({});favoritePostFavorites a post.Arguments
Name Type Required poststringYes Returns
ImgurWriteResultinterface ImgurWriteResult { ok: boolean; id: string; action: string; commentId: string | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/favoritePostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.favoritePost("<post>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.favoritePost("<post>"))curl -X POST https://api.bowmark.ai/v1/sites/imgur/favoritePost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"post":"<post>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.favoritePost("<post>");uploadImageUploads one image to the signed-in account from a remote https URL or base64 data.Arguments
Name Type Required input{ url?: string; base64?: string; title?: string; description?: string }Yes Returns
ImgurImageinterface ImgurImage { id: string; url: string; mimeType: string; width: number | null; height: number | null; size: number | null; views: number; title: string | null; description: string | null; isAnimated: boolean; mp4Url: string | null; createdAt: string | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/uploadImageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.uploadImage({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.uploadImage({}))curl -X POST https://api.bowmark.ai/v1/sites/imgur/uploadImage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.uploadImage({});voteCommentUp-, down- or vetoes the signed-in account's vote on a comment.Arguments
Name Type Required input{ id: string; vote?: "up" | "down" | "veto" }Yes Returns
ImgurWriteResultinterface ImgurWriteResult { ok: boolean; id: string; action: string; commentId: string | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/voteCommentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.voteComment({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.voteComment({}))curl -X POST https://api.bowmark.ai/v1/sites/imgur/voteComment \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.voteComment({});votePostUpvotes, downvotes or clears a vote on a post.Arguments
Name Type Required input{ id: string; vote?: "up" | "down" | "clear" }Yes Returns
ImgurWriteResultinterface ImgurWriteResult { ok: boolean; id: string; action: string; commentId: string | null }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/imgur/votePostCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.imgur.votePost({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.imgur.votePost({}))curl -X POST https://api.bowmark.ai/v1/sites/imgur/votePost \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"input":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.imgur.votePost({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/imgur/<function> - OpenAPI
/v1/sites/imgur/openapi.json