DeviantArt MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on DeviantArt: 26 typed functions through one MCP server. No DeviantArt API key needed.

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

Connect

Just DeviantArt

An MCP server for DeviantArt 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/deviantart
Every site

One MCP server for DeviantArt 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 17
  • browseTagLists the deviations filed under one tag ("landscape", "fanart", "oc"), as the site's /tag/<tag> page shows them, paginated.

    Arguments

    NameTypeRequired
    args{ tag: string; cursor?: string }Yes

    Returns DeviantartTagResult

    interface DeviantartGalleryItem {
      deviationId: string;
      title: string;
      url?: string;
      shortUrl?: string;
      author?: { username?: string; usericon?: string };
      type?: string;
      publishedTime?: string;
      isMature?: boolean;
      mediaUrl?: string;
      stats?: { views?: number; favourites?: number; comments?: number; downloads?: number };
    }
    
    interface DeviantartTagResult {
      tag: string;
      results: DeviantartGalleryItem[];
      hasMore: boolean;
      nextCursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/browseTag

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.browseTag({ tag: "landscape" });
  • getCommentsReads a deviation's comment thread.

    Arguments

    NameTypeRequired
    args{ url?: string; deviationId?: string; order?: "newest" | "oldest"; cursor?: string }Yes

    Returns DeviantartCommentThread

    interface DeviantartComment {
      commentId: string;
      parentId?: string;
      posted?: string;
      edited?: string;
      text: string;
      replies?: number;
      likes?: number;
      hidden?: string;
      author?: { username?: string; usericon?: string };
    }
    
    interface DeviantartCommentThread {
      total: number;
      comments: DeviantartComment[];
      hasMore: boolean;
      nextCursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/getComments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.getComments({ deviationId: "341719204" });
  • getDailyDeviationsLists the Daily Deviations.

    Arguments

    NameTypeRequired
    args{ date?: string }Yes

    Returns DeviantartDailyDeviationsResult

    interface DeviantartDailyDeviation {
      deviationId: string;
      title: string;
      url?: string;
      author?: { username?: string; usericon?: string };
      mediaUrl?: string;
      stats?: { views?: number; favourites?: number; comments?: number; downloads?: number };
    }
    
    interface DeviantartDailyDeviationsResult {
      results: DeviantartDailyDeviation[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/getDailyDeviations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.getDailyDeviations({});
  • getDeviationReads one deviation in full.

    Arguments

    NameTypeRequired
    args{ url: string } | { deviationId: string; username: string }Yes

    Returns DeviantartDeviation

    interface DeviantartDeviation {
      deviationId: string;
      title: string;
      url?: string;
      author?: { username?: string; usericon?: string };
      publishedTime?: string;
      type?: string;
      mediaUrl?: string;
      originalWidth?: number;
      originalHeight?: number;
      description?: string;
      /** A literature or journal deviation's words, as plain text. */
      text?: string;
      tags?: string[];
      license?: string;
      isMature?: boolean;
      isAiGenerated?: boolean;
      stats?: { views?: number; favourites?: number; comments?: number; downloads?: number };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/getDeviation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.getDeviation({});
  • getNotificationsReads the signed-in caller's notifications.

    Arguments

    NameTypeRequired
    args{ cursor?: string }No

    Returns DeviantartNotificationsResult

    interface DeviantartNotification {
      messageId: string;
      type?: string;
      time?: string;
      fromUsername?: string;
      deviationId?: string;
      deviationTitle?: string;
      url?: string;
    }
    
    interface DeviantartNotificationsResult {
      notifications: DeviantartNotification[];
      hasMore: boolean;
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/getNotifications

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.getNotifications({});
  • getRelatedDeviationsLists the deviations an art page shows under one artwork.

    Arguments

    NameTypeRequired
    args{ url: string } | { deviationId: string; username: string }Yes

    Returns DeviantartRelatedResult

    interface DeviantartGalleryItem {
      deviationId: string;
      title: string;
      url?: string;
      shortUrl?: string;
      author?: { username?: string; usericon?: string };
      type?: string;
      publishedTime?: string;
      isMature?: boolean;
      mediaUrl?: string;
      stats?: { views?: number; favourites?: number; comments?: number; downloads?: number };
    }
    
    interface DeviantartRelatedResult {
      moreByArtist: DeviantartGalleryItem[];
      recommended: DeviantartGalleryItem[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/getRelatedDeviations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.getRelatedDeviations({});
  • getUserFavouritesLists the deviations an artist has favourited.

    Arguments

    NameTypeRequired
    args{ username: string; folderId?: string; offset?: number }Yes

    Returns DeviantartGalleryResult

    interface DeviantartGalleryItem {
      deviationId: string;
      title: string;
      url?: string;
      shortUrl?: string;
      author?: { username?: string; usericon?: string };
      type?: string;
      publishedTime?: string;
      isMature?: boolean;
      mediaUrl?: string;
      stats?: { views?: number; favourites?: number; comments?: number; downloads?: number };
    }
    
    interface DeviantartGalleryResult {
      results: DeviantartGalleryItem[];
      estimatedTotal: number;
      hasMore: boolean;
      nextOffset?: number;
      locked?: { reason: string };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/getUserFavourites

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.getUserFavourites({ username: "raphael-lacoste" });
  • getUserGalleryLists an artist's gallery, every deviation they posted, newest first, or one gallery folder's contents, with each deviation's id, title, url…

    Arguments

    NameTypeRequired
    args{ username: string; folderId?: string; offset?: number }Yes

    Returns DeviantartGalleryResult

    interface DeviantartGalleryItem {
      deviationId: string;
      title: string;
      url?: string;
      shortUrl?: string;
      author?: { username?: string; usericon?: string };
      type?: string;
      publishedTime?: string;
      isMature?: boolean;
      mediaUrl?: string;
      stats?: { views?: number; favourites?: number; comments?: number; downloads?: number };
    }
    
    interface DeviantartGalleryResult {
      results: DeviantartGalleryItem[];
      estimatedTotal: number;
      hasMore: boolean;
      nextOffset?: number;
      locked?: { reason: string };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/getUserGallery

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.getUserGallery({ username: "raphael-lacoste" });
  • getUserPostsLists an artist's posts, journals, status updates and polls from their Posts tab, with title, posted time, excerpt and url.

    Arguments

    NameTypeRequired
    args{ username: string }Yes

    Returns DeviantartPostsResult

    interface DeviantartPost {
      deviationId: string;
      type?: string;
      title?: string;
      url?: string;
      publishedTime?: string;
      excerpt?: string;
      isMature?: boolean;
      author?: { username?: string; usericon?: string };
      stats?: { views?: number; favourites?: number; comments?: number; downloads?: number };
    }
    
    interface DeviantartPostsResult {
      total: number;
      counters?: { all?: number; journals?: number; polls?: number; statuses?: number };
      hasMore: boolean;
      results: DeviantartPost[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/getUserPosts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.getUserPosts({ username: "raphael-lacoste" });
  • getUserProfileReads an artist's public profile.

    Arguments

    NameTypeRequired
    args{ username: string }Yes

    Returns DeviantartUserProfile

    interface DeviantartUserProfile {
      userId: number;
      username: string;
      usericon?: string;
      tagline?: string;
      country?: string;
      website?: string;
      gender?: string;
      joinedDate?: string;
      stats?: { deviations?: number; watchers?: number; watching?: number; pageviews?: number; favourites?: number; commentsReceivedProfile?: number };
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/getUserProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.getUserProfile({ username: "raphael-lacoste" });
  • getUserWatchersLists the people who watch (follow) an artist.

    Arguments

    NameTypeRequired
    args{ username: string; offset?: number }Yes

    Returns DeviantartWatchersResult

    interface DeviantartWatcher {
      userId: number;
      username: string;
      usericon?: string;
      accountType?: string;
      isGroup: boolean;
    }
    
    interface DeviantartWatchersResult {
      watchers: DeviantartWatcher[];
      total?: number;
      hasMore: boolean;
      nextOffset?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/getUserWatchers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.getUserWatchers({ username: "raphael-lacoste" });
  • getWatchFeedReads the signed-in caller's Watch feed.

    Arguments

    NameTypeRequired
    args{ cursor?: string }No

    Returns DeviantartWatchFeedResult

    interface DeviantartGalleryItem {
      deviationId: string;
      title: string;
      url?: string;
      shortUrl?: string;
      author?: { username?: string; usericon?: string };
      type?: string;
      publishedTime?: string;
      isMature?: boolean;
      mediaUrl?: string;
      stats?: { views?: number; favourites?: number; comments?: number; downloads?: number };
    }
    
    interface DeviantartWatchFeedResult {
      results: DeviantartGalleryItem[];
      hasMore: boolean;
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/getWatchFeed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.getWatchFeed({});
  • listGalleryFoldersLists an artist's gallery folders.

    Arguments

    NameTypeRequired
    args{ username: string; offset?: number }Yes

    Returns DeviantartGalleryFolderList

    interface DeviantartGalleryFolder {
      folderId: string;
      name: string;
      size?: number;
      hasSubfolders?: boolean;
      parentId?: string;
      coverUrl?: string;
    }
    
    interface DeviantartGalleryFolderList {
      folders: DeviantartGalleryFolder[];
      hasMore: boolean;
      nextOffset?: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/listGalleryFolders

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.listGalleryFolders({ username: "raphael-lacoste" });
  • listNotesReads the signed-in caller's Notes inbox.

    Arguments

    NameTypeRequired
    args{ cursor?: string }No

    Returns DeviantartNotesResult

    interface DeviantartNoteThread {
      roomId: string;
      kind?: string;
      name?: string;
      withUsernames: string[];
      lastMessage?: string;
      lastMessageFrom?: string;
      updatedAt?: string;
    }
    
    interface DeviantartNotesResult {
      threads: DeviantartNoteThread[];
      hasMore: boolean;
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/listNotes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.listNotes({});
  • searchDeviationsSearches DeviantArt for artwork by free text ("dragon", "watercolor landscape") and returns each deviation's id, title, url, author, thumbnail, type…

    Arguments

    NameTypeRequired
    args{ query: string; cursor?: string }Yes

    Returns DeviantartSearchResult

    interface DeviantartDeviationRow {
      deviationId: string;
      title: string;
      url?: string;
      authorUser?: { username?: string; usericon?: string };
      preview?: { src?: string };
      type?: string;
      stats?: { favourites?: number; comments?: number };
    }
    
    interface DeviantartSearchResult {
      results: DeviantartDeviationRow[];
      estimatedTotal: number;
      hasMore: boolean;
      nextCursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/searchDeviations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.searchDeviations({ query: "landscape" });
  • searchShopSearches the DeviantArt Shop's exclusives.

    Arguments

    NameTypeRequired
    args{ query?: string; cursor?: string }Yes

    Returns DeviantartShopResult

    interface DeviantartGalleryItem {
      deviationId: string;
      title: string;
      url?: string;
      shortUrl?: string;
      author?: { username?: string; usericon?: string };
      type?: string;
      publishedTime?: string;
      isMature?: boolean;
      mediaUrl?: string;
      stats?: { views?: number; favourites?: number; comments?: number; downloads?: number };
    }
    
    interface DeviantartShopItem extends DeviantartGalleryItem {
      isAiGenerated?: boolean;
      saleStatus?: string;
      priceUsd?: number;
      discountUsd?: number;
      discountName?: string;
      minOfferUsd?: number;
    }
    
    interface DeviantartShopResult {
      results: DeviantartShopItem[];
      estimatedTotal: number;
      hasMore: boolean;
      nextCursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/searchShop

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.searchShop({ query: "dragon" });
  • suggestTagsAutocompletes a partial tag ("lands" → landscape, landscapephotography, landscapepainting …), the finder that turns a caller's words into a tag…

    Arguments

    NameTypeRequired
    args{ query: string }Yes

    Returns { tags: string[] }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/suggestTags

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.suggestTags({ query: "lands" });
Act 9
  • favouriteDeviationAdds a deviation to the signed-in caller's Favourites, taking the deviation url or id.

    Arguments

    NameTypeRequired
    args{ url?: string; deviationId?: string }Yes

    Returns DeviantartFavouriteResult

    interface DeviantartFavouriteResult {
      deviationId: string;
      favourited: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/favouriteDeviation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.favouriteDeviation({});
  • postCommentPosts a comment on a deviation (or a reply to a comment) as the signed-in caller.

    Arguments

    NameTypeRequired
    args{ url?: string; deviationId?: string; text: string; parentId?: string }Yes

    Returns DeviantartPostedComment

    interface DeviantartPostedComment {
      commentId: string;
      text: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/postComment

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.postComment({});
  • sendNoteSends a private note (DeviantArt's direct message, now a chat DM) from the signed-in caller to another user, taking their username and the message…

    Arguments

    NameTypeRequired
    args{ username: string; text: string }Yes

    Returns DeviantartSentNote

    interface DeviantartSentNote {
      username: string;
      roomId: string | null;
      sent: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/sendNote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.sendNote({});
  • submitDeviationUploads an image (by URL) to the signed-in caller's DeviantArt account through the site's own upload door and returns the new deviation's id.

    Arguments

    NameTypeRequired
    args{ imageUrl: string; folderName?: string }Yes

    Returns DeviantartSubmittedDeviation

    interface DeviantartSubmittedDeviation {
      deviationId: string;
      submitted: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/submitDeviation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.submitDeviation({});
  • unfavouriteDeviationRemoves a deviation from the signed-in caller's Favourites.

    Arguments

    NameTypeRequired
    args{ url?: string; deviationId?: string }Yes

    Returns DeviantartFavouriteResult

    interface DeviantartFavouriteResult {
      deviationId: string;
      favourited: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/unfavouriteDeviation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.unfavouriteDeviation({});
  • unwatchUserStops watching an artist from the signed-in caller's account.

    Arguments

    NameTypeRequired
    args{ username: string }Yes

    Returns DeviantartWatchResult

    interface DeviantartWatchResult {
      username: string;
      watching: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/unwatchUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.unwatchUser({});
  • updateDeviationSets the description of a deviation the signed-in caller owns (for example the one submitDeviation just uploaded), through the site's own…

    Arguments

    NameTypeRequired
    args{ deviationId: string | number; description: string }Yes

    Returns DeviantartDeviationUpdate

    interface DeviantartDeviationUpdate {
      deviationId: string;
      updated: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/updateDeviation

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.updateDeviation({});
  • updateProfileEdits the signed-in caller's own About section: reads the site's current about-module settings, overlays changes (field names as the site's own…

    Arguments

    NameTypeRequired
    args{ username: string; changes: Record<string, string | number | boolean> }Yes

    Returns DeviantartProfileUpdate

    interface DeviantartProfileUpdate {
      username: string;
      saved: boolean;
      fields: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/updateProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.deviantart.updateProfile({});
  • watchUserWatches (follows) an artist from the signed-in caller's account, taking their username.

    Arguments

    NameTypeRequired
    args{ username: string }Yes

    Returns DeviantartWatchResult

    interface DeviantartWatchResult {
      username: string;
      watching: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/deviantart/watchUser

    Call it

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

Use it from code