AOL MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on AOL: 18 typed functions through one MCP server. No AOL API key needed.
- Site
- aol.com
- Functions
- 18
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for AOL 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/aolOne MCP server for AOL 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.
getArticleReads one AOL article in full.Arguments
Name Type Required urlstringYes Returns
AolArticleinterface AolArticle { title: string; url: string; author?: string; publisher?: string; publishedAt?: string; modifiedAt?: string; body: string; images: string[]; commentCount?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/getArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.getArticle("<url>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.getArticle("<url>"))curl -X POST https://api.bowmark.ai/v1/sites/aol/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.aol.getArticle("<url>");getArticleCommentsReads the reader comments under one AOL article.Arguments
Name Type Required args{ url: string; sort?: "best" | "newest" | "oldest"; limit?: number; offset?: number }Yes Returns
AolArticleCommentsinterface AolComment { id: string; parentId?: string; depth: number; author?: string; authorUsername?: string; text: string; postedAt: string; edited: boolean; likes: number; dislikes: number; replyCount: number; replies: AolComment[]; } interface AolArticleComments { postId: string; totalCount: number; commentCount: number; replyCount: number; sort: "best" | "newest" | "oldest"; offset: number; hasMore: boolean; comments: AolComment[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/getArticleCommentsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.getArticleComments({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.getArticleComments({}))curl -X POST https://api.bowmark.ai/v1/sites/aol/getArticleComments \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aol.getArticleComments({});getDailyHoroscopeReads today's AOL horoscope for one zodiac sign.Arguments
Name Type Required signstringYes Returns
AolHoroscopeinterface AolHoroscope { sign: "aries" | "taurus" | "gemini" | "cancer" | "leo" | "virgo" | "libra" | "scorpio" | "sagittarius" | "capricorn" | "aquarius" | "pisces"; /** YYYY-MM-DD. */ date: string; reading: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/getDailyHoroscopeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.getDailyHoroscope("libra");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.getDailyHoroscope("libra"))curl -X POST https://api.bowmark.ai/v1/sites/aol/getDailyHoroscope \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"sign":"libra"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aol.getDailyHoroscope("libra");getFrontPageReads the aol.com front page as the visitor sees it.Arguments
Name Type Required limitnumberNo Returns
AolFrontPageinterface AolStoryRow { title: string; url: string; summary?: string; image?: string; source?: string; sourceUrl?: string; publishedAt?: string; } interface AolFrontPage { stories: AolStoryRow[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/getFrontPageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.getFrontPage();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.getFrontPage())curl -X POST https://api.bowmark.ai/v1/sites/aol/getFrontPage \ -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.aol.getFrontPage();getLocalNewsLists local news for a US city and state.Arguments
Name Type Required args{ city: string; state: string; limit?: number; page?: number }Yes Returns
{ articles: AolLocalNewsArticle[] }interface AolLocalNewsArticle { id?: string; title: string; url: string; summary?: string; image?: string; provider?: string; providerLogo?: string; publishedAt?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/getLocalNewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.getLocalNews({ city: "Seattle", state: "WA" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.getLocalNews({"city": "Seattle", "state": "WA"}))curl -X POST https://api.bowmark.ai/v1/sites/aol/getLocalNews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"city":"Seattle","state":"WA"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aol.getLocalNews({ city: "Seattle", state: "WA" });getMarketSummaryReads the market strip AOL shows on its front page.Arguments
None.
Returns
AolMarketSummaryinterface AolMarketIndex { name: string; ticker: string; price: string; change?: string; changePercent?: string; } interface AolMarketSummary { indices: AolMarketIndex[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/getMarketSummaryCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.getMarketSummary();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.getMarketSummary())curl -X POST https://api.bowmark.ai/v1/sites/aol/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.aol.getMarketSummary();getRecipeReads one AOL recipe, title, ingredients, steps, times, servings and image, given its slug or url.Arguments
Name Type Required slugOrUrlstringYes Returns
AolRecipeinterface AolRecipe { title: string; image?: string; servings?: string; prepTime?: string; cookTime?: string; ingredients: string[]; steps: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/getRecipeCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.getRecipe("yakitori-chicken");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.getRecipe("yakitori-chicken"))curl -X POST https://api.bowmark.ai/v1/sites/aol/getRecipe \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"slugOrUrl":"yakitori-chicken"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aol.getRecipe("yakitori-chicken");getWeatherReads the current conditions and the hourly and multi-day forecast for one place.Arguments
Name Type Required woeidstringYes Returns
AolWeatherData/** Current conditions. US units: °F, mph, miles, inHg. */ interface AolWeatherCondition { description: string; /** °F */ temperature: number; /** Percent. */ humidity?: number; /** mph */ windSpeed?: number; /** inHg */ pressure?: number; uvIndex?: number; /** Miles. */ visibility?: number; /** °F */ dewPoint?: number; } interface AolWeatherHour { /** ISO 8601, UTC. */ time: string; description: string; /** °F */ temperature: number; /** Percent chance of precipitation. */ chanceOfRain?: number; } interface AolWeatherForecastDay { /** YYYY-MM-DD in the location's own time zone. */ date: string; description: string; /** °F */ high: number; /** °F */ low: number; /** Percent chance of precipitation. */ chanceOfRain?: number; /** HH:MM local time. */ sunrise?: string; /** HH:MM local time. */ sunset?: string; } interface AolWeatherData { location: { woeid: string; name: string; state?: string; countryCode?: string; country?: string; utcOffsetSeconds?: number; latitude?: number; longitude?: number; }; current: AolWeatherCondition; hourly: AolWeatherHour[]; daily: AolWeatherForecastDay[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/getWeatherCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.getWeather("2487956");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.getWeather("2487956"))curl -X POST https://api.bowmark.ai/v1/sites/aol/getWeather \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"woeid":"2487956"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aol.getWeather("2487956");listFavoritesReads the signed-in caller's AOL Favorites.Arguments
None.
Returns
{ favorites: AolFavorite[] }interface AolFavorite { id: string; name: string; type: "folder" | "link"; url?: string; children?: AolFavorite[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/listFavoritesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.listFavorites();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.listFavorites())curl -X POST https://api.bowmark.ai/v1/sites/aol/listFavorites \ -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.aol.listFavorites();listGamesLists AOL Games' free web games.Arguments
None.
Returns
{ games: AolGame[] }interface AolGame { id: number; name: string; provider: string; category: string; href: string; image?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/listGamesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.listGames();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.listGames())curl -X POST https://api.bowmark.ai/v1/sites/aol/listGames \ -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.aol.listGames();listNewslettersLists AOL's newsletter signup(s).Arguments
None.
Returns
{ newsletters: AolNewsletter[] }interface AolNewsletter { id: string; title: string; description?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/listNewslettersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.listNewsletters();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.listNewsletters())curl -X POST https://api.bowmark.ai/v1/sites/aol/listNewsletters \ -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.aol.listNewsletters();listSectionArticlesLists the articles in one AOL section or sub-section, newest first, page by page.Arguments
Name Type Required sectionstringA section path from listSections, e.g. "/news/" or "/entertainment/celebrity/".Yes pagenumberPage number, 1-based. Default 1.No Returns
AolSectionArticlesinterface AolStoryRow { title: string; url: string; summary?: string; image?: string; source?: string; sourceUrl?: string; publishedAt?: string; } interface AolSectionArticles { section: string; page: number; articles: AolStoryRow[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/listSectionArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.listSectionArticles({ section: "/news/" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.listSectionArticles({"section": "/news/"}))curl -X POST https://api.bowmark.ai/v1/sites/aol/listSectionArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"section":"/news/"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aol.listSectionArticles({ section: "/news/" });listSectionsLists AOL's sections and sub-sections (News > Politics, Business, Sports > NFL, Entertainment > Celebrity, Finance > Insurance, Food, Travel, Health…Arguments
None.
Returns
AolSectionListinterface AolSection { title: string; path: string; parentPath?: string; } interface AolSectionList { sections: AolSection[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/listSectionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.listSections();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.listSections())curl -X POST https://api.bowmark.ai/v1/sites/aol/listSections \ -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.aol.listSections();searchRecipesSearches AOL Food's recipe collection by keyword.Arguments
Name Type Required keywordstringYes Returns
{ recipes: AolRecipeSummary[] }interface AolRecipeSummary { id: number; title: string; slug: string; image?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/searchRecipesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.searchRecipes("chicken");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.searchRecipes("chicken"))curl -X POST https://api.bowmark.ai/v1/sites/aol/searchRecipes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"keyword":"chicken"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aol.searchRecipes("chicken");searchWeatherLocationsFinds weather locations by place name.Arguments
Name Type Required args{ query?: string; country?: string }No Returns
{ locations: AolWeatherLocation[] }interface AolWeatherLocation { woeid: string; displayName: string; fullDisplayName: string; latitude?: number; longitude?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/searchWeatherLocationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.searchWeatherLocations({ query: "San Francisco" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.searchWeatherLocations({"query": "San Francisco"}))curl -X POST https://api.bowmark.ai/v1/sites/aol/searchWeatherLocations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"San Francisco"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aol.searchWeatherLocations({ query: "San Francisco" });
addFavoriteSaves a link to the signed-in caller's AOL Favorites, optionally into a folder.Arguments
Name Type Required args{ name: string; url?: string; parentId?: string }Yes Returns
AolFavoriteinterface AolFavorite { id: string; name: string; type: "folder" | "link"; url?: string; children?: AolFavorite[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/addFavoriteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.addFavorite({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.addFavorite({}))curl -X POST https://api.bowmark.ai/v1/sites/aol/addFavorite \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aol.addFavorite({});removeFavoriteDeletes a saved link or folder from the signed-in caller's AOL Favorites.Arguments
Name Type Required idstringYes Returns
{ removed: true }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/removeFavoriteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.removeFavorite("<id>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.removeFavorite("<id>"))curl -X POST https://api.bowmark.ai/v1/sites/aol/removeFavorite \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"<id>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aol.removeFavorite("<id>");subscribeNewsletterSubscribes an email address to one aol.com newsletter, as the site's own sign-up box does.Arguments
Name Type Required args{ email: string; newsletterId?: string }Yes Returns
{ subscribed: true; newsletterId: string }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/aol/subscribeNewsletterCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.aol.subscribeNewsletter({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.aol.subscribeNewsletter({}))curl -X POST https://api.bowmark.ai/v1/sites/aol/subscribeNewsletter \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.aol.subscribeNewsletter({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/aol/<function> - OpenAPI
/v1/sites/aol/openapi.json