CNN MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on CNN: 14 typed functions through one MCP server. No CNN API key needed.

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

Connect

Just CNN

An MCP server for CNN 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/cnn
Every site

One MCP server for CNN 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 11
  • getArticleRead the full text and metadata of one CNN article.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns cnnArticle

    interface cnnArticleImage {
      url: string;
      caption: string | null;
      credit: string | null;
    }
    
    interface cnnArticle {
      url: string;
      headline: string;
      description: string | null;
      articleBody: string;
      author: string[];
      section: string | null;
      datePublished: string | null;
      dateModified: string | null;
      wordCount: number | null;
      images: cnnArticleImage[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cnn/getArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cnn.getArticle("<url>");
  • getMarketsDataFinancial and markets data from CNN Money.

    Arguments

    None.

    Returns cnnMarketsData

    interface cnnMarketIndex {
      name: string;
      symbol: string;
      value: string;
      change: string | null;
      changePercent: string | null;
    }
    
    interface cnnMarketsData {
      indices: cnnMarketIndex[];
      currencies: cnnMarketIndex[];
      commodities: cnnMarketIndex[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cnn/getMarketsData

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cnn.getMarketsData();
  • getVideoGet metadata for one CNN video.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns cnnVideoDetail

    interface cnnVideo {
      id: string;
      headline: string;
      description: string | null;
      duration: string | null;
      url: string;
      thumbnailUrl: string | null;
    }
    
    interface cnnVideoDetail extends cnnVideo {
      datePublished: string | null;
      author: string | null;
      keywords: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cnn/getVideo

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cnn.getVideo("<url>");
  • listCategoriesThe section categories CNN publishes.

    Arguments

    None.

    Returns cnnCategory[]

    interface cnnCategory {
      id: string;
      name: string;
      path: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cnn/listCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cnn.listCategories();
  • listHeadlinesThe top headlines from CNN's home page.

    Arguments

    NameTypeRequired
    sectionstringNo

    Returns cnnHeadline[]

    interface cnnHeadline {
      id: string;
      headline: string;
      snippet: string;
      url: string;
      timestamp: string | null;
      section: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cnn/listHeadlines

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cnn.listHeadlines();
  • listMyNewsThe signed-in viewer's personalized My News feed, built from their followed topics, newest first.

    Arguments

    NameTypeRequired
    limitnumberNo

    Returns cnnMyNewsResult

    interface cnnTrendingItem {
      headline: string;
      url: string;
      contentType: string;
      section: string | null;
      description: string | null;
      thumbnailUrl: string | null;
      lastPublishDate: string | null;
    }
    
    interface cnnMyNewsResult {
      items: cnnTrendingItem[];
      followedTopics: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cnn/listMyNews

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cnn.listMyNews();
  • listNewslettersThe CNN newsletters available to subscribe to.

    Arguments

    None.

    Returns cnnNewsletter[]

    interface cnnNewsletter {
      id: string;
      name: string;
      frequency: string | null;
      description: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cnn/listNewsletters

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cnn.listNewsletters();
  • listSectionHeadlinesThe latest headlines in one CNN section by section NAME ("Politics", "World", "Business", etc.).

    Arguments

    NameTypeRequired
    sectionstringYes

    Returns cnnHeadline[]

    interface cnnHeadline {
      id: string;
      headline: string;
      snippet: string;
      url: string;
      timestamp: string | null;
      section: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cnn/listSectionHeadlines

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cnn.listSectionHeadlines({ section: "Politics" });
  • listTrendingTopicsThe stories CNN's own recommendation engine currently ranks as trending.

    Arguments

    None.

    Returns cnnTrendingItem[]

    interface cnnTrendingItem {
      headline: string;
      url: string;
      contentType: string;
      section: string | null;
      description: string | null;
      thumbnailUrl: string | null;
      lastPublishDate: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cnn/listTrendingTopics

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cnn.listTrendingTopics();
  • listVideosThe videos CNN currently lists on its video hub.

    Arguments

    None.

    Returns cnnVideo[]

    interface cnnVideo {
      id: string;
      headline: string;
      description: string | null;
      duration: string | null;
      url: string;
      thumbnailUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cnn/listVideos

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cnn.listVideos();
  • searchArticlesSearch CNN, takes what a person would say ("breaking news", "inflation", "2024 election") and returns matching articles and videos, newest first…

    Arguments

    NameTypeRequired
    querystringYes
    limitnumber
    Results per call, 1-50.
    No
    offsetnumber
    How many results to skip, for the next page.
    No

    Returns cnnSearchResult[]

    interface cnnSearchResult {
      headline: string;
      snippet: string;
      type: string;
      url: string;
      thumbnail: string | null;
      lastModified: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cnn/searchArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cnn.searchArticles({ query: "election" });
Act 3
  • followTopicAdd a topic to the signed-in viewer's followed topics, so it appears in their personalized My News feed.

    Arguments

    NameTypeRequired
    topicIdstringYes

    Returns cnnFollowedTopic

    interface cnnFollowedTopic {
      topic_id: string;
      name: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cnn/followTopic

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cnn.followTopic("<topicId>");
  • subscribeToNewsletterSubscribe the signed-in viewer's account to a CNN newsletter by id.

    Arguments

    NameTypeRequired
    newsletterIdstringYes

    Returns cnnNewsletterSubscription

    interface cnnNewsletterSubscription {
      newsletter_id: string;
      subscribed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cnn/subscribeToNewsletter

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cnn.subscribeToNewsletter("<newsletterId>");
  • unfollowTopicRemove a topic from the signed-in viewer's followed topics.

    Arguments

    NameTypeRequired
    topicIdstringYes

    Returns cnnUnfollowResult

    interface cnnUnfollowResult {
      topic_id: string;
      unfollowed: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/cnn/unfollowTopic

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.cnn.unfollowTopic("<topicId>");

Use it from code