AOL API and MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on AOL. No AOL API key needed.
Add to your agent
Paste this into Claude Code, Cursor, Codex or any agent. It adds the server itself.
Read https://bowmark.ai/sites/aol.md and add Bowmark's AOL MCP server to my agent.Run this in a terminal, then sign in when the browser opens.
claude mcp add --transport http bowmark-aol https://api.bowmark.ai/mcp/site/aolPress the button, or add this to ~/.cursor/mcp.json.
{
"mcpServers": {
"bowmark-aol": {
"url": "https://api.bowmark.ai/mcp/site/aol"
}
}
}Press the button, or run this in a terminal.
code --add-mcp '{"name":"bowmark-aol","type":"http","url":"https://api.bowmark.ai/mcp/site/aol"}'Run this in a terminal.
codex mcp add bowmark-aol --url https://api.bowmark.ai/mcp/site/aolIn Claude, open Plugins → Add → Add custom connector, paste this URL, and pick Sign in now.
https://api.bowmark.ai/mcp/site/aolIn ChatGPT, open Plugins, press +, choose Add custom MCP server and paste this URL.
https://api.bowmark.ai/mcp/site/aolAny MCP client that takes a remote (streamable HTTP) server: give it this URL.
https://api.bowmark.ai/mcp/site/aolFunctions
Open a function to see its parameters and run it with your own API key.
addFavoriteSaves a link to the signed-in caller's AOL Favorites, optionally into a folder.Sign in requiredAOL accountNot connected. This runs on your own account, and Bowmark never sees your password.RecommendedChrome extensionPOST /v1/sites/aol/addFavorite
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/aol/addFavorite \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'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({}))Responsereturns AolFavoriteinterface AolFavorite { id: string; name: string; type: "folder" | "link"; url?: string; children?: AolFavorite[]; }getArticleReads one AOL article in full.POST /v1/sites/aol/getArticle
Parameters
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>"}'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>"))Responsereturns AolArticleinterface AolArticle { title: string; url: string; author?: string; publisher?: string; publishedAt?: string; modifiedAt?: string; body: string; images: string[]; commentCount?: string; }getArticleCommentsReads the reader comments under one AOL article.POST /v1/sites/aol/getArticleComments
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/aol/getArticleComments \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'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({}))Responsereturns 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[]; }getDailyHoroscopeReads today's AOL horoscope for one zodiac sign.POST /v1/sites/aol/getDailyHoroscope
Parameters
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"}'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"))Responsereturns AolHoroscopeinterface AolHoroscope { sign: "aries" | "taurus" | "gemini" | "cancer" | "leo" | "virgo" | "libra" | "scorpio" | "sagittarius" | "capricorn" | "aquarius" | "pisces"; /** YYYY-MM-DD. */ date: string; reading: string; }getFrontPageReads the aol.com front page as the visitor sees it.POST /v1/sites/aol/getFrontPage
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/aol/getFrontPage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'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())Responsereturns AolFrontPageinterface AolStoryRow { title: string; url: string; summary?: string; image?: string; source?: string; sourceUrl?: string; publishedAt?: string; } interface AolFrontPage { stories: AolStoryRow[]; }getLocalNewsLists local news for a US city and state.POST /v1/sites/aol/getLocalNews
Parameters
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"}}'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"}))Responsereturns { articles: AolLocalNewsArticle[] }interface AolLocalNewsArticle { id?: string; title: string; url: string; summary?: string; image?: string; provider?: string; providerLogo?: string; publishedAt?: string; }getMarketSummaryReads the market strip AOL shows on its front page.POST /v1/sites/aol/getMarketSummary
Parameters
No parameters.
curl -X POST https://api.bowmark.ai/v1/sites/aol/getMarketSummary \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'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())Responsereturns AolMarketSummaryinterface AolMarketIndex { name: string; ticker: string; price: string; change?: string; changePercent?: string; } interface AolMarketSummary { indices: AolMarketIndex[]; }getRecipeReads one AOL recipe, title, ingredients, steps, times, servings and image, given its slug or url.POST /v1/sites/aol/getRecipe
Parameters
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"}'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"))Responsereturns AolRecipeinterface AolRecipe { title: string; image?: string; servings?: string; prepTime?: string; cookTime?: string; ingredients: string[]; steps: string[]; }getWeatherReads the current conditions and the hourly and multi-day forecast for one place.POST /v1/sites/aol/getWeather
Parameters
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"}'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"))Responsereturns 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[]; }listFavoritesReads the signed-in caller's AOL Favorites.Sign in requiredAOL accountNot connected. This runs on your own account, and Bowmark never sees your password.RecommendedChrome extensionPOST /v1/sites/aol/listFavorites
Parameters
No parameters.
curl -X POST https://api.bowmark.ai/v1/sites/aol/listFavorites \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'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())Responsereturns { favorites: AolFavorite[] }interface AolFavorite { id: string; name: string; type: "folder" | "link"; url?: string; children?: AolFavorite[]; }listGamesLists AOL Games' free web games.POST /v1/sites/aol/listGames
Parameters
No parameters.
curl -X POST https://api.bowmark.ai/v1/sites/aol/listGames \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'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())Responsereturns { games: AolGame[] }interface AolGame { id: number; name: string; provider: string; category: string; href: string; image?: string; }listNewslettersLists AOL's newsletter signup(s).POST /v1/sites/aol/listNewsletters
Parameters
No parameters.
curl -X POST https://api.bowmark.ai/v1/sites/aol/listNewsletters \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'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())Responsereturns { newsletters: AolNewsletter[] }interface AolNewsletter { id: string; title: string; description?: string; }listSectionArticlesLists the articles in one AOL section or sub-section, newest first, page by page.POST /v1/sites/aol/listSectionArticles
Parameters
A section path from listSections, e.g. "/news/" or "/entertainment/celebrity/".
Page number, 1-based. Default 1.
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/"}}'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/"}))Responsereturns AolSectionArticlesinterface AolStoryRow { title: string; url: string; summary?: string; image?: string; source?: string; sourceUrl?: string; publishedAt?: string; } interface AolSectionArticles { section: string; page: number; articles: AolStoryRow[]; }listSectionsLists AOL's sections and sub-sections (News > Politics, Business, Sports > NFL, Entertainment > Celebrity, Finance > Insurance, Food, Travel, Health…POST /v1/sites/aol/listSections
Parameters
No parameters.
curl -X POST https://api.bowmark.ai/v1/sites/aol/listSections \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'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())Responsereturns AolSectionListinterface AolSection { title: string; path: string; parentPath?: string; } interface AolSectionList { sections: AolSection[]; }removeFavoriteDeletes a saved link or folder from the signed-in caller's AOL Favorites.Sign in requiredAOL accountNot connected. This runs on your own account, and Bowmark never sees your password.RecommendedChrome extensionPOST /v1/sites/aol/removeFavorite
Parameters
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>"}'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>"))ResponseRun the request to see the response here.
searchRecipesSearches AOL Food's recipe collection by keyword.POST /v1/sites/aol/searchRecipes
Parameters
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"}'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"))Responsereturns { recipes: AolRecipeSummary[] }interface AolRecipeSummary { id: number; title: string; slug: string; image?: string; }searchWeatherLocationsFinds weather locations by place name.POST /v1/sites/aol/searchWeatherLocations
Parameters
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"}}'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"}))Responsereturns { locations: AolWeatherLocation[] }interface AolWeatherLocation { woeid: string; displayName: string; fullDisplayName: string; latitude?: number; longitude?: number; }subscribeNewsletterSubscribes an email address to one aol.com newsletter, as the site's own sign-up box does.POST /v1/sites/aol/subscribeNewsletter
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/aol/subscribeNewsletter \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'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({}))ResponseRun the request to see the response here.