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.
- Site
- msn.com
- Functions
- 16
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/msnOne MCP server for MSN 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.
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
Name Type Required fromstringThree-letter ISO code, e.g. "USD".Yes tostringE.g. "EUR".Yes amountnumberDefault 1.No Returns
MsnCurrencyConversioninterface 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/convertCurrencyCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.msn.convertCurrency({ from: "USD", to: "EUR", amount: 500 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.msn.convertCurrency({"from": "USD", "to": "EUR", "amount": 500}))curl -X POST https://api.bowmark.ai/v1/sites/msn/convertCurrency \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"from":"USD","to":"EUR","amount":500}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required urlstringYes Returns
MsnArticleinterface MsnArticle { title: string; body: string; byline: string | null; publishedDateTime: string | null; images: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/msn/getArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.msn.getArticle("<url>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.msn.getArticle("<url>"))curl -X POST https://api.bowmark.ai/v1/sites/msn/getArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"<url>"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required locationstringYes options.hoursnumberHow many hours from now, 1-240, default 24.No Returns
MsnHourlyForecastinterface 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/getHourlyForecastCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.msn.getHourlyForecast("Denver, CO");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.msn.getHourlyForecast("Denver, CO"))curl -X POST https://api.bowmark.ai/v1/sites/msn/getHourlyForecast \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"location":"Denver, CO"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.msn.getHourlyForecast("Denver, CO");getMarketSummaryReads the Dow Jones Industrial Average, S&P 500 and NASDAQ Composite.Arguments
None.
Returns
MsnMarketSummaryinterface 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/getMarketSummaryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.msn.getMarketSummary();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.msn.getMarketSummary())curl -X POST https://api.bowmark.ai/v1/sites/msn/getMarketSummary \ -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.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
Name Type Required videostringYes Returns
MsnPlaybackinterface 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/getPlaybackCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.msn.getPlayback({ video: "AA2gIg02" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.msn.getPlayback({"video": "AA2gIg02"}))curl -X POST https://api.bowmark.ai/v1/sites/msn/getPlayback \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"video":"AA2gIg02"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required league"nfl" | "nba" | "nhl" | "mlb" | "ncaaf" | "mls" | "epl" | "laliga" | "bundesliga" | "seriea" | "ligue1"Yes datestring"YYYY-MM-DD", a UTC day; default today.No Returns
MsnScoresinterface 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/getScoresCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.msn.getScores({ league: "nba", date: { $daysFromNow: -1 } });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.msn.getScores({"league": "nba", "date": {"$daysFromNow": -1}}))curl -X POST https://api.bowmark.ai/v1/sites/msn/getScores \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"nba","date":{"$daysFromNow":-1}}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.msn.getScores({ league: "nba", date: { $daysFromNow: -1 } });getSectionFeedReturns a top-stories feed scoped to one of six sections.Arguments
Name Type Required section"sports" | "entertainment" | "health" | "lifestyle" | "travel" | "autos"Yes options{ cursor?: string }No Returns
MsnTopStoriesinterface 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/getSectionFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.msn.getSectionFeed("sports");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.msn.getSectionFeed("sports"))curl -X POST https://api.bowmark.ai/v1/sites/msn/getSectionFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"section":"sports"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required league"nfl" | "nba" | "nhl" | "mlb" | "epl" | "laliga" | "bundesliga" | "seriea" | "ligue1"Yes Returns
MsnStandingsinterface 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/getStandingsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.msn.getStandings({ league: "nba" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.msn.getStandings({"league": "nba"}))curl -X POST https://api.bowmark.ai/v1/sites/msn/getStandings \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"league":"nba"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required symbolstringYes Returns
MsnStockQuoteinterface 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/getStockQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.msn.getStockQuote("AAPL");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.msn.getStockQuote("AAPL"))curl -X POST https://api.bowmark.ai/v1/sites/msn/getStockQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"symbol":"AAPL"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required limitOrOptionsnumber | { limit?: number; cursor?: string }No Returns
MsnTopStoriesinterface 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/getTopStoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.msn.getTopStories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.msn.getTopStories())curl -X POST https://api.bowmark.ai/v1/sites/msn/getTopStories \ -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.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
Name Type Required limit5 | 10 | 20No cursorstringA prior call's nextPageUrl.No Returns
MsnVideoFeedinterface 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/getVideoFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.msn.getVideoFeed();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.msn.getVideoFeed())curl -X POST https://api.bowmark.ai/v1/sites/msn/getVideoFeed \ -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.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
Name Type Required locationstringYes Returns
MsnWeatherForecastinterface 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/getWeatherForecastCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.msn.getWeatherForecast("Seattle, WA");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.msn.getWeatherForecast("Seattle, WA"))curl -X POST https://api.bowmark.ai/v1/sites/msn/getWeatherForecast \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"location":"Seattle, WA"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.msn.getWeatherForecast("Seattle, WA");listSavedArticlesLists the articles the signed-in caller has saved to their MSN reading list.Arguments
None.
Returns
MsnSavedArticlesinterface 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/listSavedArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.msn.listSavedArticles();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.msn.listSavedArticles())curl -X POST https://api.bowmark.ai/v1/sites/msn/listSavedArticles \ -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.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
Name Type Required querystringYes options{ cursor?: string }No Returns
MsnTopStoriesinterface 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/searchNewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.msn.searchNews("finance");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.msn.searchNews("finance"))curl -X POST https://api.bowmark.ai/v1/sites/msn/searchNews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"finance"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required querystringYes options.limit5 | 10 | 20No options.cursorstringA prior call's nextPageUrl.No Returns
MsnVideoFeedinterface 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/searchVideosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.msn.searchVideos("apollo 11 moon landing");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.msn.searchVideos("apollo 11 moon landing"))curl -X POST https://api.bowmark.ai/v1/sites/msn/searchVideos \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"apollo 11 moon landing"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.msn.searchVideos("apollo 11 moon landing");
saveArticleAdds an article to the signed-in caller's MSN reading list.Arguments
Name Type Required articleIdstringThe ar-<id> segment of an article URL, or a row's own articleId.Yes Returns
MsnSaveArticleResultinterface MsnSaveArticleResult { articleId: string; saved: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/msn/saveArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.msn.saveArticle({ articleId: "<articleId>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.msn.saveArticle({"articleId": "<articleId>"}))curl -X POST https://api.bowmark.ai/v1/sites/msn/saveArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"articleId":"<articleId>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.msn.saveArticle({ articleId: "<articleId>" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/msn/<function> - OpenAPI
/v1/sites/msn/openapi.json