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.

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

Connect

Just AOL

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/aol
Every site

One MCP server for AOL 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
  • getArticleReads one AOL article in full.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns AolArticle

    interface 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/getArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol.getArticle("<url>");
  • getArticleCommentsReads the reader comments under one AOL article.

    Arguments

    NameTypeRequired
    args{ url: string; sort?: "best" | "newest" | "oldest"; limit?: number; offset?: number }Yes

    Returns AolArticleComments

    interface 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/getArticleComments

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol.getArticleComments({});
  • getDailyHoroscopeReads today's AOL horoscope for one zodiac sign.

    Arguments

    NameTypeRequired
    signstringYes

    Returns AolHoroscope

    interface 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/getDailyHoroscope

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol.getDailyHoroscope("libra");
  • getFrontPageReads the aol.com front page as the visitor sees it.

    Arguments

    NameTypeRequired
    limitnumberNo

    Returns AolFrontPage

    interface 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/getFrontPage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol.getFrontPage();
  • getLocalNewsLists local news for a US city and state.

    Arguments

    NameTypeRequired
    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/getLocalNews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol.getLocalNews({ city: "Seattle", state: "WA" });
  • getMarketSummaryReads the market strip AOL shows on its front page.

    Arguments

    None.

    Returns AolMarketSummary

    interface 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/getMarketSummary

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol.getMarketSummary();
  • getRecipeReads one AOL recipe, title, ingredients, steps, times, servings and image, given its slug or url.

    Arguments

    NameTypeRequired
    slugOrUrlstringYes

    Returns AolRecipe

    interface 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/getRecipe

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol.getRecipe("yakitori-chicken");
  • getWeatherReads the current conditions and the hourly and multi-day forecast for one place.

    Arguments

    NameTypeRequired
    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/getWeather

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/listFavorites

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/listGames

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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/listNewsletters

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol.listNewsletters();
  • listSectionArticlesLists the articles in one AOL section or sub-section, newest first, page by page.

    Arguments

    NameTypeRequired
    sectionstring
    A section path from listSections, e.g. "/news/" or "/entertainment/celebrity/".
    Yes
    pagenumber
    Page number, 1-based. Default 1.
    No

    Returns AolSectionArticles

    interface 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/listSectionArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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 AolSectionList

    interface AolSection {
      title: string;
      path: string;
      parentPath?: string;
    }
    
    interface AolSectionList {
      sections: AolSection[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aol/listSections

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol.listSections();
  • searchRecipesSearches AOL Food's recipe collection by keyword.

    Arguments

    NameTypeRequired
    keywordstringYes

    Returns { recipes: AolRecipeSummary[] }

    interface AolRecipeSummary {
      id: number;
      title: string;
      slug: string;
      image?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aol/searchRecipes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol.searchRecipes("chicken");
  • searchWeatherLocationsFinds weather locations by place name.

    Arguments

    NameTypeRequired
    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/searchWeatherLocations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol.searchWeatherLocations({ query: "San Francisco" });
Act 3
  • addFavoriteSaves a link to the signed-in caller's AOL Favorites, optionally into a folder.

    Arguments

    NameTypeRequired
    args{ name: string; url?: string; parentId?: string }Yes

    Returns AolFavorite

    interface AolFavorite {
      id: string;
      name: string;
      type: "folder" | "link";
      url?: string;
      children?: AolFavorite[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aol/addFavorite

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.aol.addFavorite({});
  • removeFavoriteDeletes a saved link or folder from the signed-in caller's AOL Favorites.

    Arguments

    NameTypeRequired
    idstringYes

    Returns { removed: true }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aol/removeFavorite

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    args{ email: string; newsletterId?: string }Yes

    Returns { subscribed: true; newsletterId: string }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/aol/subscribeNewsletter

    Call it

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

Use it from code