MSN MCP server for AI agents

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

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

Connect

Just MSN

An MCP server for MSN 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/msn
Every site

One MCP server for MSN 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 15
  • convertCurrencyConverts an amount between two currencies at MSN Money's live FX cross rate, the rate msn.com/en-us/money/tools/currencyconverter shows: the rate…

    Arguments

    NameTypeRequired
    fromstring
    Three-letter ISO code, e.g. "USD".
    Yes
    tostring
    E.g. "EUR".
    Yes
    amountnumber
    Default 1.
    No

    Returns MsnCurrencyConversion

    interface MsnCurrencyConversion {
      from: string;
      to: string;
      amount: number;
      rate: number;  // units of `to` per one `from`
      converted: number;
      pairName: string;  // e.g. "US Dollar/Euro"
      timeLastTraded: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/msn/convertCurrency

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.msn.convertCurrency({ from: "USD", to: "EUR", amount: 500 });
  • getArticleReads one MSN article's full text, byline, publish time and images off its own article URL.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns MsnArticle

    interface MsnArticle {
      title: string;
      body: string;
      byline: string | null;
      publishedDateTime: string | null;
      images: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/msn/getArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.msn.getArticle("<url>");
  • getHourlyForecastReads the hour-by-hour forecast for a named city off MSN Weather's hourly page, starting with the current hour: temperature, feels-like, condition…

    Arguments

    NameTypeRequired
    locationstringYes
    options.hoursnumber
    How many hours from now, 1-240, default 24.
    No

    Returns MsnHourlyForecast

    interface MsnWeatherHour {
      time: string;  // local time with the city's own offset
      temperature: number;
      feelsLike: number;
      condition: string;  // the site's own label
      precipitationChance: number | null;  // percent
      humidity: number | null;  // percent
      windSpeedMph: number | null;
      windGust: string | null;
      summary: string | null;
    }
    
    interface MsnHourlyForecast {
      location: string;
      hours: MsnWeatherHour[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/msn/getHourlyForecast

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.msn.getHourlyForecast("Denver, CO");
  • getMarketSummaryReads the Dow Jones Industrial Average, S&P 500 and NASDAQ Composite.

    Arguments

    None.

    Returns MsnMarketSummary

    interface MsnStockQuote {
      symbol: string;
      displayName: string;
      securityType: string;
      price: number;
      priceChange: number;
      priceChangePercent: number;
      priceDayHigh: number;
      priceDayLow: number;
      priceDayOpen: number;
      pricePreviousClose: number;
      price52wHigh: number;
      price52wLow: number;
      accumulatedVolume: number;
      averageVolume: number | null;
      marketCap: number | null;
      marketCapCurrency: string | null;
      peRatio: number | null;
      currency: string;
      exchangeName: string;
      timeLastTraded: string;
    }
    
    interface MsnMarketSummary {
      dow: MsnStockQuote;
      sp500: MsnStockQuote;
      nasdaq: MsnStockQuote;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/msn/getMarketSummary

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.msn.getMarketSummary();
  • getPlaybackReturns every measured way to play one MSN video: all of MSN's direct progressive MP4 files, one per rendition, in the site's muxed menu.

    Arguments

    NameTypeRequired
    videostringYes

    Returns MsnPlayback

    interface MsnPlaybackFile {
      url: string;
      mimeType: string;
      codecs: string | null;
      width: number | null;
      height: number | null;
      fps: number | null;
      bitrate: number | null;
      bytes: number | null;
      qualityLabel: string | null;
      itag: number;
    }
    
    interface MsnPlayback {
      videoId: string;
      title: string | null;
      durationMs: number | null;
      live: boolean;
      embed: { url: string; hasAds: boolean | "unknown"; note: string } | null;
      files: { muxed: MsnPlaybackFile[]; videoOnly: MsnPlaybackFile[]; audioOnly: MsnPlaybackFile[] };
      expiresAt: string | null;
      referrer: "any" | "none" | string;
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/msn/getPlayback

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.msn.getPlayback({ video: "AA2gIg02" });
  • getScoresReturns one league's games on one date the way MSN Sports' scores page does for a visitor with no account: each game's start time, status (e.g.…

    Arguments

    NameTypeRequired
    league"nfl" | "nba" | "nhl" | "mlb" | "ncaaf" | "mls" | "epl" | "laliga" | "bundesliga" | "seriea" | "ligue1"Yes
    datestring
    "YYYY-MM-DD", a UTC day; default today.
    No

    Returns MsnScores

    interface MsnScoreTeam {
      name: string;
      alias: string;
      homeAway: string;  // the site's own label, "Home" or "Away"
      score: number | null;
      outcome: string | null;  // the site's own label, e.g. "Won", "Lost"; null before the game ends
      record: string | null;  // wins-losses[-ties]
    }
    
    interface MsnGame {
      id: string;
      name: string | null;  // e.g. "Sunday Night Football"
      startDateTime: string;
      status: string;  // the site's own label, read values off a result, e.g. "Final"
      venue: string | null;
      tv: string[];
      teams: MsnScoreTeam[];
    }
    
    interface MsnScores {
      league: string;
      date: string;
      games: MsnGame[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/msn/getScores

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.msn.getScores({ league: "nba", date: { $daysFromNow: -1 } });
  • getSectionFeedReturns a top-stories feed scoped to one of six sections.

    Arguments

    NameTypeRequired
    section"sports" | "entertainment" | "health" | "lifestyle" | "travel" | "autos"Yes
    options{ cursor?: string }No

    Returns MsnTopStories

    interface MsnStory {
      id: string;
      type: string;
      title: string;
      abstract: string;
      readTimeMin: number | null;
      url: string;
      publishedDateTime: string;
      providerName: string;
      imageUrl: string | null;
    }
    
    interface MsnTopStories {
      stories: MsnStory[];
      nextPageUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/msn/getSectionFeed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.msn.getSectionFeed("sports");
  • getStandingsReturns one league's current standings table the way MSN Sports' standings page does for a visitor with no account: every team with conference…

    Arguments

    NameTypeRequired
    league"nfl" | "nba" | "nhl" | "mlb" | "epl" | "laliga" | "bundesliga" | "seriea" | "ligue1"Yes

    Returns MsnStandings

    interface MsnStandingRow {
      team: string;
      alias: string;
      conference: string | null;  // null in soccer leagues
      division: string | null;
      overallRank: number | null;
      rankInConference: number | null;
      rankInDivision: number | null;
      wins: number;
      losses: number;
      ties: number;
      overtimeLosses: number;
      winningPercentage: number | null;
      gamesBack: number | null;
      gamesPlayed: number | null;
      points: number | null;  // table points (soccer, NHL); 0 where the league does not use them
      streak: string | null;  // e.g. "Winning 5"
      last10: string | null;  // e.g. "8-2"
    }
    
    interface MsnStandings {
      league: string;
      rows: MsnStandingRow[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/msn/getStandings

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.msn.getStandings({ league: "nba" });
  • getStockQuoteReads one ticker's current price, day range, 52-week range, volume, market cap and P/E off MSN Money the way msn.com/en-us/money/stockdetails does…

    Arguments

    NameTypeRequired
    symbolstringYes

    Returns MsnStockQuote

    interface MsnStockQuote {
      symbol: string;
      displayName: string;
      securityType: string;
      price: number;
      priceChange: number;
      priceChangePercent: number;
      priceDayHigh: number;
      priceDayLow: number;
      priceDayOpen: number;
      pricePreviousClose: number;
      price52wHigh: number;
      price52wLow: number;
      accumulatedVolume: number;
      averageVolume: number | null;
      marketCap: number | null;
      marketCapCurrency: string | null;
      peRatio: number | null;
      currency: string;
      exchangeName: string;
      timeLastTraded: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/msn/getStockQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.msn.getStockQuote("AAPL");
  • getTopStoriesReturns the top stories the MSN front page is showing right now, the way www.msn.com does for a visitor with no account: each story's headline, its…

    Arguments

    NameTypeRequired
    limitOrOptionsnumber | { limit?: number; cursor?: string }No

    Returns MsnTopStories

    interface MsnStory {
      id: string;
      type: string;
      title: string;
      abstract: string;
      readTimeMin: number | null;
      url: string;
      publishedDateTime: string;
      providerName: string;
      imageUrl: string | null;
    }
    
    interface MsnTopStories {
      stories: MsnStory[];
      nextPageUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/msn/getTopStories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.msn.getTopStories();
  • getVideoFeedLists the videos MSN's video section (www.msn.com/en-us/video) shows a visitor with no account: title, outlet, summary, publish time, thumbnail…

    Arguments

    NameTypeRequired
    limit5 | 10 | 20No
    cursorstring
    A prior call's nextPageUrl.
    No

    Returns MsnVideoFeed

    interface MsnVideo {
      id: string;
      title: string;
      abstract: string;
      url: string;  // the video's own MSN page
      publishedDateTime: string;
      providerName: string;
      imageUrl: string | null;
      durationSec: number | null;
      mp4Url: string | null;  // the largest progressive mp4 the site lists
      captionsUrl: string | null;
    }
    
    interface MsnVideoFeed {
      videos: MsnVideo[];
      nextPageUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/msn/getVideoFeed

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.msn.getVideoFeed();
  • getWeatherForecastReads the 10-day forecast for a named city off MSN Weather the way msn.com/en-us/weather/forecast/in-<City>,<ST> does for a visitor with no account…

    Arguments

    NameTypeRequired
    locationstringYes

    Returns MsnWeatherForecast

    interface MsnWeatherDay {
      date: string;
      highTemp: number;
      lowTemp: number;
      condition: string;  // the site's own labels, read the values off a result, never guess one from prose
      nightCondition: string;
      precipitationChance: number;
      nightPrecipitationChance: number;
      rainAmount: string;
      snowAmount: string;
      summary: string;
    }
    
    interface MsnWeatherForecast {
      location: string;
      currentTemperature: number;
      currentCondition: string;
      feelsLike: number;
      humidity: number;
      windSpeedMph: number;
      lastUpdated: string;
      days: MsnWeatherDay[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/msn/getWeatherForecast

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.msn.getWeatherForecast("Seattle, WA");
  • listSavedArticlesLists the articles the signed-in caller has saved to their MSN reading list.

    Arguments

    None.

    Returns MsnSavedArticles

    interface MsnSavedArticle {
      articleId: string;  // MSN's own content id, the "ar-<id>" in an article URL
      targetType: string;  // the site's own label for what was saved, as MSN stores it
      url: string;  // the bare ar-<id> MSN URL, pass it to getArticle
      metadata: Record<string, unknown>;  // whatever MSN stored beside the save, unchanged
    }
    
    interface MsnSavedArticles {
      articles: MsnSavedArticle[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/msn/listSavedArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.msn.listSavedArticles();
  • searchNewsSearches MSN's own aggregated news index the way its front-page search does and returns matching stories in the same shape as getTopStories.

    Arguments

    NameTypeRequired
    querystringYes
    options{ cursor?: string }No

    Returns MsnTopStories

    interface MsnStory {
      id: string;
      type: string;
      title: string;
      abstract: string;
      readTimeMin: number | null;
      url: string;
      publishedDateTime: string;
      providerName: string;
      imageUrl: string | null;
    }
    
    interface MsnTopStories {
      stories: MsnStory[];
      nextPageUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/msn/searchNews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.msn.searchNews("finance");
  • searchVideosFinds videos in MSN's video section by a topic the caller types (e.g. "apollo 11 moon landing"), returning the same rows getVideoFeed returns (title…

    Arguments

    NameTypeRequired
    querystringYes
    options.limit5 | 10 | 20No
    options.cursorstring
    A prior call's nextPageUrl.
    No

    Returns MsnVideoFeed

    interface MsnVideo {
      id: string;
      title: string;
      abstract: string;
      url: string;  // the video's own MSN page
      publishedDateTime: string;
      providerName: string;
      imageUrl: string | null;
      durationSec: number | null;
      mp4Url: string | null;  // the largest progressive mp4 the site lists
      captionsUrl: string | null;
    }
    
    interface MsnVideoFeed {
      videos: MsnVideo[];
      nextPageUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/msn/searchVideos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.msn.searchVideos("apollo 11 moon landing");
Act 1
  • saveArticleAdds an article to the signed-in caller's MSN reading list.

    Arguments

    NameTypeRequired
    articleIdstring
    The ar-<id> segment of an article URL, or a row's own articleId.
    Yes

    Returns MsnSaveArticleResult

    interface MsnSaveArticleResult {
      articleId: string;
      saved: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/msn/saveArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.msn.saveArticle({ articleId: "<articleId>" });

Use it from code