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.

Functions
20
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Imgur

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/imgur
Every site

One MCP server for Imgur and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both 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.

Read 14
  • getGalleryPostsLists the gallery feed (most viral, user submitted, or top) with sort and paging, logged out.

    Arguments

    NameTypeRequired
    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
    pagenumber
    1-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/getGalleryPosts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.getGalleryPosts();
  • getImageResolves a direct image/video id or i.imgur.com link to its media URL, size and type.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns ImgurImage

    interface 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/getImage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.getImage("xfwvhd6");
  • getMyFavoritesLists the signed-in account's favorites, including private ones.

    Arguments

    NameTypeRequired
    usernamestringYes
    sort"newest" | "oldest" | "top" | "best" | "worst"
    "newest" (default), "oldest" or "top" (posts); "best"/"worst" for comments.
    No
    pagenumber
    1-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/getMyFavorites

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.getMyFavorites();
  • getMyPostsLists the signed-in account's posts and uploads, including hidden ones.

    Arguments

    NameTypeRequired
    usernamestringYes
    sort"newest" | "oldest" | "top" | "best" | "worst"
    "newest" (default), "oldest" or "top" (posts); "best"/"worst" for comments.
    No
    pagenumber
    1-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/getMyPosts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/getNotifications

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.getNotifications();
  • getPostGets one post by id or URL: title, description, media items, counts and author.

    Arguments

    NameTypeRequired
    idOrUrlstringYes

    Returns ImgurPostDetail

    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 }
    
    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/getPost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.getPost("<idOrUrl>");
  • getPostCommentsLists a post's comments with their replies, sorted best/new/top.

    Arguments

    NameTypeRequired
    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/getPostComments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.getPostComments("<idOrUrl>");
  • getTagGets one tag (name, followers, total posts) and its posts, with sort and paging.

    Arguments

    NameTypeRequired
    tagstring | ImgurTagArgsYes
    interface ImgurTagArgs {
      /** tag name or imgur.com/t/<tag> URL */
      tag: string;
      /** default "viral" */
      sort?: "viral" | "top" | "newest";
      page?: number;
    }

    Returns ImgurTag

    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 }
    
    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/getTag

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.getTag("aww");
  • getUserGets a user's public profile by username: bio, reputation, avatar, joined date.

    Arguments

    NameTypeRequired
    usernamestringYes

    Returns ImgurUser

    interface 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/getUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.getUser("imgur");
  • getUserCommentsLists a user's public comments.

    Arguments

    NameTypeRequired
    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/getUserComments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.getUserComments("J3lek");
  • getUserFavoritesLists a user's public favorites.

    Arguments

    NameTypeRequired
    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/getUserFavorites

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.getUserFavorites("J3lek");
  • getUserPostsLists a user's public submitted posts.

    Arguments

    NameTypeRequired
    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/getUserPosts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/listTags

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.listTags();
  • searchPostsSearches imgur's gallery for posts matching a query, logged out.

    Arguments

    NameTypeRequired
    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/searchPosts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.searchPosts("cats");
Act 6
  • addCommentComments on a post, or replies to a comment.

    Arguments

    NameTypeRequired
    input{ id: string; text: string; parentId?: string }Yes

    Returns ImgurWriteResult

    interface ImgurWriteResult { ok: boolean; id: string; action: string; commentId: string | null }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/imgur/addComment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.addComment({});
  • deleteCommentDeletes one of the signed-in account's own comments by its numeric id.

    Arguments

    NameTypeRequired
    comment{ id: string }Yes

    Returns ImgurWriteResult

    interface ImgurWriteResult { ok: boolean; id: string; action: string; commentId: string | null }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/imgur/deleteComment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.deleteComment({});
  • favoritePostFavorites a post.

    Arguments

    NameTypeRequired
    poststringYes

    Returns ImgurWriteResult

    interface ImgurWriteResult { ok: boolean; id: string; action: string; commentId: string | null }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/imgur/favoritePost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.favoritePost("<post>");
  • uploadImageUploads one image to the signed-in account from a remote https URL or base64 data.

    Arguments

    NameTypeRequired
    input{ url?: string; base64?: string; title?: string; description?: string }Yes

    Returns ImgurImage

    interface 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/uploadImage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.uploadImage({});
  • voteCommentUp-, down- or vetoes the signed-in account's vote on a comment.

    Arguments

    NameTypeRequired
    input{ id: string; vote?: "up" | "down" | "veto" }Yes

    Returns ImgurWriteResult

    interface ImgurWriteResult { ok: boolean; id: string; action: string; commentId: string | null }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/imgur/voteComment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.voteComment({});
  • votePostUpvotes, downvotes or clears a vote on a post.

    Arguments

    NameTypeRequired
    input{ id: string; vote?: "up" | "down" | "clear" }Yes

    Returns ImgurWriteResult

    interface ImgurWriteResult { ok: boolean; id: string; action: string; commentId: string | null }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/imgur/votePost

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.imgur.votePost({});

Use it from code