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.

Functions

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 required

    POST /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":{}}'
    Sign in to run
    Responsereturns AolFavorite
    interface 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>"}'
    Sign in to run
    Responsereturns AolArticle
    interface 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":{}}'
    Sign in to run
    Responsereturns 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[];
    }
  • 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"}'
    Sign in to run
    Responsereturns AolHoroscope
    interface 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 '{}'
    Sign in to run
    Responsereturns AolFrontPage
    interface 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"}}'
    Sign in to run
    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 '{}'
    Sign in to run
    Responsereturns AolMarketSummary
    interface 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"}'
    Sign in to run
    Responsereturns AolRecipe
    interface 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"}'
    Sign in to run
    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 required

    POST /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 '{}'
    Sign in to run
    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 '{}'
    Sign in to run
    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 '{}'
    Sign in to run
    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/"}}'
    Sign in to run
    Responsereturns 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[];
    }
  • 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 '{}'
    Sign in to run
    Responsereturns AolSectionList
    interface 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 required

    POST /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>"}'
    Sign in to run
    Response

    Run 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"}'
    Sign in to run
    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"}}'
    Sign in to run
    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":{}}'
    Sign in to run
    Response

    Run the request to see the response here.