Snapchat MCP server for AI agents

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

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

Connect

Just Snapchat

An MCP server for Snapchat 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/snapchat
Every site

One MCP server for Snapchat 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 20
  • getEpisodeReads one show episode's own page (www.snapchat.com/p/<publisherId>/<storyId>).

    Arguments

    NameTypeRequired
    publisherIdstringYes
    storyIdstringYes

    Returns SnapchatEpisode

    interface SnapchatStorySnap {
      snapId: string;
      snapMediaType?: string;
      mediaUrl?: string;
      mediaPreviewUrl?: string;
    }
    
    interface SnapchatEpisode {
      storyId: string;
      title?: string;
      publishedAtSec?: number;
      snaps: SnapchatStorySnap[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/getEpisode

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.getEpisode({
      publisherId: "73365ee2-f2ad-455d-8c1a-e07c83b1b045",
      storyId: "3298916203413504"
    });
  • getLensReads one Lens's own page (www.snapchat.com/lens/<scannableUuid>).

    Arguments

    NameTypeRequired
    scannableUuidstringYes

    Returns SnapchatLensDetail

    interface SnapchatLens {
      lensId: string;
      scannableUuid: string;
      name: string;
      creatorUsername?: string;
      creatorDisplayName?: string;
      previewImageUrl?: string;
      previewVideoUrl?: string;
      iconUrl?: string;
      unlockUrl?: string;
      searchTags?: string[];
      official: boolean;
    }
    
    interface SnapchatLensDetail extends SnapchatLens {
      moreLenses: SnapchatLens[];
      spotlightsUsingThisLens: Array<{ thumbnailUrl?: string; storyPageUrl?: string }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/getLens

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.getLens("565e7595ec4e4a0da689762b127308ef");
  • getLocalGuideReads a city's local guide (www.snapchat.com/local/<country>/<state>/<city>[/<category>]).

    Arguments

    NameTypeRequired
    pathstringYes
    categorystringNo

    Returns SnapchatLocalGuide

    interface SnapchatLocalPlaceSnap {
      snapId: string;
      posterUsername?: string;
      posterDisplayName?: string;
      mediaUrl?: string;
      thumbnailUrl?: string;
      postedAtMs?: number;
    }
    
    interface SnapchatLocalPlace {
      placeId: string;
      name: string;
      category?: string;
      placeUrl?: string;
      address?: string;
      photoUrl?: string;
      snaps: SnapchatLocalPlaceSnap[];
    }
    
    interface SnapchatLocalCategory {
      slug: string;
      displayName: string;
      places: SnapchatLocalPlace[];
    }
    
    interface SnapchatLocalGuide {
      city: string;
      state?: string;
      categories: SnapchatLocalCategory[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/getLocalGuide

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.getLocalGuide({ path: "/local/united-states/new-york/new-york" });
  • getMyProfileReads the signed-in caller's own Snapchat account.

    Arguments

    None.

    Returns SnapchatMyProfile

    interface SnapchatMyProfile {
      userId: string; // the account's uuid
      username?: string;
      displayName?: string;
      mutableUsername?: string;
      isOfficial?: boolean;
      isPopular?: boolean;
      snapProId?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/getMyProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.getMyProfile();
  • getProfileReads one Snapchat account's public page by username.

    Arguments

    NameTypeRequired
    usernamestringYes

    Returns SnapchatProfileRow

    interface SnapchatProfileRow {
      username: string;
      displayName: string;
      snapcodeImageUrl: string;
      kind: string; // the site's $case: "userInfo" for an ordinary account, "publicProfileInfo" for one with followers/bio/category
      bio?: string;
      websiteUrl?: string;
      subscriberCount?: number;
      categoryStringId?: string;
      badge?: boolean;
      relatedAccounts?: Array<{ username: string; displayName: string }>;
      profile: Record<string, unknown>; // the site's own userProfile object, untouched
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/getProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.getProfile("nba");
  • getShowReads one Discover show or publisher page (www.snapchat.com/p/<publisherId>).

    Arguments

    NameTypeRequired
    publisherIdstringYes

    Returns SnapchatShow

    interface SnapchatShowEpisodeSummary {
      storyId: string;
      title?: string;
      thumbnailUrl?: string;
      publishedAtSec?: number;
      seasonNumber?: number;
      episodeNumber?: number;
    }
    
    interface SnapchatShowSeason {
      seasonNumber: number;
      episodeCount: number;
    }
    
    interface SnapchatShow {
      publisherId: string;
      title?: string;
      bio?: string;
      websiteUrl?: string;
      subscriberCount?: number;
      profilePictureUrl?: string;
      episodes: SnapchatShowEpisodeSummary[]; // snapList is always empty here; getEpisode reads the snaps
      seasons: SnapchatShowSeason[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/getShow

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.getShow("73365ee2-f2ad-455d-8c1a-e07c83b1b045");
  • getSpotlightVideoReads one Spotlight video by its share url or snap id.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns SnapchatSpotlightVideoDetail

    interface SnapchatSpotlightVideo {
      storyId: string;
      snapId: string;
      mediaUrl?: string;
      mediaPreviewUrl?: string;
      name?: string;
      viewCount?: number;
      uploadDateMs?: number;
      durationMs?: number;
      width?: number;
      height?: number;
      creatorUsername?: string;
      creatorDisplayName?: string;
      creatorUrl?: string;
      canonicalUrl?: string; // www.snapchat.com/@<creator>/spotlight/<storyId>, what getSpotlightVideo takes
    }
    
    interface SnapchatSpotlightVideoDetail {
      name?: string;
      description?: string;
      viewCount?: number;
      uploadDateMs?: number;
      durationMs?: number;
      width?: number;
      height?: number;
      contentUrl?: string;
      creatorUsername?: string;
      creatorDisplayName?: string;
      creatorUrl?: string;
      relatedVideos: SnapchatSpotlightVideo[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/getSpotlightVideo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.getSpotlightVideo("<url>");
  • listDiscoverStoriesReads the public Discover feed at www.snapchat.com/discover.

    Arguments

    None.

    Returns SnapchatDiscoverFeed

    interface SnapchatDiscoverStory {
      id: string;
      kind: string; // the site's __typename: "PremiumPublisherStory" (a Show) or "SnapProStory" (a creator)
      title?: string;
      creatorUsername?: string;
      creatorDisplayName?: string;
      thumbnailUrl?: string;
      tapId?: string;
      snapCount: number;
      canonicalUrl: string; // story.snapchat.com/p/<id>
    }
    
    interface SnapchatDiscoverFeed {
      stories: SnapchatDiscoverStory[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/listDiscoverStories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.listDiscoverStories();
  • listFriendsLists the signed-in caller's Snapchat friends.

    Arguments

    None.

    Returns SnapchatFriend[]

    interface SnapchatFriend {
      userId: string; // the friend's uuid
      username?: string;
      displayName?: string;
      friendLinkType?: number; // 2 friend · 3 pending · 4 following · 5 blocked …
      addedAt?: number; // unix ms
      bitmojiAvatarId?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/listFriends

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.listFriends();
  • listFriendStoriesLists the Stories the signed-in caller's friends have posted, with each Story's snaps.

    Arguments

    None.

    Returns SnapchatFriendStories

    interface SnapchatFriendStorySnap {
      snapId?: string;
      mediaUrl?: string;
      mediaType?: number; // Snapchat's own enum
      durationSec?: number;
      thumbnailUrl?: string;
      caption?: string;
      title?: string;
      createdAt?: number; // unix ms
      expiresAt?: number; // unix ms
    }
    
    interface SnapchatFriendStory {
      userId?: string;
      username?: string;
      displayName?: string;
      snaps: SnapchatFriendStorySnap[];
    }
    
    interface SnapchatFriendStories {
      stories: SnapchatFriendStory[];
      cards: number; // cards the feed returned, the caller's own story included
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/listFriendStories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.listFriendStories();
  • listLensesReads the Lens Explorer's top lenses at www.snapchat.com/lens.

    Arguments

    None.

    Returns SnapchatLensList

    interface SnapchatLens {
      lensId: string;
      scannableUuid: string;
      name: string;
      creatorUsername?: string;
      creatorDisplayName?: string;
      previewImageUrl?: string;
      previewVideoUrl?: string;
      iconUrl?: string;
      unlockUrl?: string;
      searchTags?: string[];
      official: boolean;
    }
    
    interface SnapchatLensCategory {
      name: string;
      displayName: string;
      selected: boolean;
    }
    
    interface SnapchatLensList {
      lenses: SnapchatLens[];
      categories: SnapchatLensCategory[];
      hasMore: boolean;
      nextCursorId?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/listLenses

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.listLenses();
  • listLocalCitiesLists the cities Snapchat publishes local guides for, off the homepage's 'Explore local favorites' section, with each guide's path.

    Arguments

    None.

    Returns SnapchatLocalCities

    interface SnapchatLocalCity {
      name: string;
      state?: string;
      path: string; // what getLocalGuide takes
    }
    
    interface SnapchatLocalCities {
      cities: SnapchatLocalCity[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/listLocalCities

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.listLocalCities();
  • listProfileHighlightsLists a public profile's saved Story highlights (curated Stories kept on the profile), with each highlight's snaps, paged.

    Arguments

    NameTypeRequired
    usernamestringYes

    Returns SnapchatProfileHighlights

    interface SnapchatStorySnap {
      snapId: string;
      snapMediaType?: string;
      mediaUrl?: string;
      mediaPreviewUrl?: string;
    }
    
    interface SnapchatProfileHighlight {
      highlightId?: string;
      title?: string;
      thumbnailUrl?: string;
      snaps: SnapchatStorySnap[];
    }
    
    interface SnapchatProfileHighlights {
      username: string;
      highlights: SnapchatProfileHighlight[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/listProfileHighlights

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.listProfileHighlights("nba");
  • listProfileLensesLists the Lenses a public profile has published, with lens name, preview image and video, icon and unlock link, paged.

    Arguments

    NameTypeRequired
    usernamestringYes

    Returns SnapchatProfileLenses

    interface SnapchatProfileLens {
      name: string;
      creatorDisplayName?: string;
      previewImageUrl?: string;
      previewVideoUrl?: string;
      iconUrl?: string;
      unlockUrl?: string;
      scannableUuid?: string; // what getLens takes
    }
    
    interface SnapchatProfileLenses {
      username: string;
      lenses: SnapchatProfileLens[];
      cursor?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/listProfileLenses

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.listProfileLenses("nba");
  • listProfileSpotlightsLists the Spotlight videos a public profile has posted, with title, upload date, view count, duration and video url, paged.

    Arguments

    NameTypeRequired
    usernamestringYes

    Returns SnapchatProfileSpotlights

    interface SnapchatSpotlightVideo {
      storyId: string;
      snapId: string;
      mediaUrl?: string;
      mediaPreviewUrl?: string;
      name?: string;
      viewCount?: number;
      uploadDateMs?: number;
      durationMs?: number;
      width?: number;
      height?: number;
      creatorUsername?: string;
      creatorDisplayName?: string;
      creatorUrl?: string;
      canonicalUrl?: string; // www.snapchat.com/@<creator>/spotlight/<storyId>, what getSpotlightVideo takes
    }
    
    interface SnapchatProfileSpotlights {
      username: string;
      videos: SnapchatSpotlightVideo[];
      cursor?: string; // the site's next-page token; only the first page is read
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/listProfileSpotlights

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.listProfileSpotlights("nba");
  • listProfileStoryLists the snaps in a public profile's current Story.

    Arguments

    NameTypeRequired
    usernamestringYes

    Returns SnapchatProfileStory

    interface SnapchatStorySnap {
      snapId: string;
      snapMediaType?: string;
      mediaUrl?: string;
      mediaPreviewUrl?: string;
    }
    
    interface SnapchatProfileStory {
      username: string;
      hasStory: boolean;
      snaps: SnapchatStorySnap[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/listProfileStory

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.listProfileStory("nba");
  • listSpotlightCommentsReads the public comments under one Spotlight video.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns SnapchatSpotlightComments

    interface SnapchatSpotlightComment {
      text: string;
      posterDisplayName?: string;
      timestampMs?: number;
      reactCount?: number;
      replyCount?: number;
    }
    
    interface SnapchatSpotlightComments {
      comments: SnapchatSpotlightComment[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/listSpotlightComments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.listSpotlightComments("<url>");
  • listSpotlightFeedReads the Spotlight feed, Snapchat's public short-video feed at www.snapchat.com/spotlight, returning each video's creator, caption, view count…

    Arguments

    None.

    Returns SnapchatSpotlightFeed

    interface SnapchatSpotlightVideo {
      storyId: string;
      snapId: string;
      mediaUrl?: string;
      mediaPreviewUrl?: string;
      name?: string;
      viewCount?: number;
      uploadDateMs?: number;
      durationMs?: number;
      width?: number;
      height?: number;
      creatorUsername?: string;
      creatorDisplayName?: string;
      creatorUrl?: string;
      canonicalUrl?: string; // www.snapchat.com/@<creator>/spotlight/<storyId>, what getSpotlightVideo takes
    }
    
    interface SnapchatSpotlightFeed {
      videos: SnapchatSpotlightVideo[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/listSpotlightFeed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.listSpotlightFeed();
  • listTopicSpotlightsLists the Spotlight videos filed under one hashtag topic (www.snapchat.com/tag/<hashtag>), the feed a person opens by tapping a hashtag.

    Arguments

    NameTypeRequired
    hashtagstringYes

    Returns SnapchatTopicSpotlights

    interface SnapchatSpotlightVideo {
      storyId: string;
      snapId: string;
      mediaUrl?: string;
      mediaPreviewUrl?: string;
      name?: string;
      viewCount?: number;
      uploadDateMs?: number;
      durationMs?: number;
      width?: number;
      height?: number;
      creatorUsername?: string;
      creatorDisplayName?: string;
      creatorUrl?: string;
      canonicalUrl?: string; // www.snapchat.com/@<creator>/spotlight/<storyId>, what getSpotlightVideo takes
    }
    
    interface SnapchatTopicSpotlights {
      hashtag: string;
      videos: SnapchatSpotlightVideo[];
      relatedTopics: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/listTopicSpotlights

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.listTopicSpotlights("funny");
  • searchSnapchatSearches Snapchat the way the site's own search page does.

    Arguments

    NameTypeRequired
    querystringYes

    Returns SnapchatSearchResult

    interface SnapchatSearchItem {
      kind: string; // "lens" | "storyCard" (a Spotlight video) | "user" | "snapProEntity" | "show" | "place" | "publisherEdition" (an episode) | "topic" | …
      id: string; // Spotlight snap id, user id, profile id, publisherId (show), storyId (episode), place id, topic text; a lens's id is its lensId (getLens takes the uuid in result.unlockUrl)
      title?: string;
      username?: string;
      result: Record<string, unknown>; // the site's own object for that item, untouched
    }
    
    interface SnapchatSearchResult {
      query: string;
      sections: Array<{
        section: string; // "Lenses" | "Spotlight" | "Add Friends" | "Subscribe" | "Shows" | "Places" | "Episodes" | "Topics"
        kind: string; // the site's section kind: "lenses" | "spotlight" | "users" | "profiles" | "publishers" | "places" | "episodes" | "topics"
        items: SnapchatSearchItem[];
      }>;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/searchSnapchat

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.searchSnapchat("pizza");
Act 5
  • addFriendSends a friend add from the signed-in caller's account to one Snapchat user by their user id (a uuid) or username (resolved with…

    Arguments

    NameTypeRequired
    input{ userId: string } | { username: string }Yes

    Returns SnapchatFriendActionResult

    interface SnapchatFriendActionResult {
      userId: string;
      added: boolean; // Snapchat accepted the add
      failureReason?: number; // Snapchat's own refusal enum, when it refused
      message?: string;
      username?: string; // set when the add was made by username
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/addFriend

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.addFriend({});
  • blockUserBlocks one Snapchat account from contacting the signed-in caller, by user id (a uuid) or username (resolved with AtlasGw/GetUserIdByUsername).

    Arguments

    NameTypeRequired
    input{ userId: string } | { username: string }Yes

    Returns SnapchatFriendChangeResult

    interface SnapchatFriendChangeResult {
      userId: string;
      username?: string; // set when called by username
      done: boolean; // Snapchat accepted the remove / block
      failureReason?: number; // Snapchat's own refusal enum, when it refused
      message?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/blockUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.blockUser({});
  • removeFriendRemoves one Snapchat user from the signed-in caller's friends, by user id (a uuid) or username (resolved with AtlasGw/GetUserIdByUsername).

    Arguments

    NameTypeRequired
    input{ userId: string } | { username: string }Yes

    Returns SnapchatFriendChangeResult

    interface SnapchatFriendChangeResult {
      userId: string;
      username?: string; // set when called by username
      done: boolean; // Snapchat accepted the remove / block
      failureReason?: number; // Snapchat's own refusal enum, when it refused
      message?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/removeFriend

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.removeFriend({});
  • unblockUserUnblocks one Snapchat account the signed-in caller blocked, by user id (a uuid) or username (resolved with AtlasGw/GetUserIdByUsername).

    Arguments

    NameTypeRequired
    input{ userId: string } | { username: string }Yes

    Returns SnapchatFriendChangeResult

    interface SnapchatFriendChangeResult {
      userId: string;
      username?: string; // set when called by username
      done: boolean; // Snapchat accepted the remove / block
      failureReason?: number; // Snapchat's own refusal enum, when it refused
      message?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/unblockUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.snapchat.unblockUser({});
  • updateDisplayNameChanges the signed-in caller's Snapchat display name.

    Arguments

    NameTypeRequired
    input{ displayName: string }Yes

    Returns SnapchatDisplayNameResult

    interface SnapchatDisplayNameResult {
      displayName: string; // the name sent
      status: number; // Snapchat's own status enum (field 1), 0 when none was sent
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/snapchat/updateDisplayName

    Call it

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

Use it from code