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.
- Site
- cnn.com
- Functions
- 14
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/cnnOne MCP server for CNN 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.
getArticleRead the full text and metadata of one CNN article.Arguments
Name Type Required urlstringYes Returns
cnnArticleinterface 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/getArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cnn.getArticle("<url>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cnn.getArticle("<url>"))curl -X POST https://api.bowmark.ai/v1/sites/cnn/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.cnn.getArticle("<url>");getMarketsDataFinancial and markets data from CNN Money.Arguments
None.
Returns
cnnMarketsDatainterface 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/getMarketsDataCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cnn.getMarketsData();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cnn.getMarketsData())curl -X POST https://api.bowmark.ai/v1/sites/cnn/getMarketsData \ -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.cnn.getMarketsData();getVideoGet metadata for one CNN video.Arguments
Name Type Required urlstringYes Returns
cnnVideoDetailinterface 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/getVideoCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cnn.getVideo("<url>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cnn.getVideo("<url>"))curl -X POST https://api.bowmark.ai/v1/sites/cnn/getVideo \ -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.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/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cnn.listCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cnn.listCategories())curl -X POST https://api.bowmark.ai/v1/sites/cnn/listCategories \ -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.cnn.listCategories();listHeadlinesThe top headlines from CNN's home page.Arguments
Name Type Required 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/listHeadlinesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cnn.listHeadlines();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cnn.listHeadlines())curl -X POST https://api.bowmark.ai/v1/sites/cnn/listHeadlines \ -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.cnn.listHeadlines();listMyNewsThe signed-in viewer's personalized My News feed, built from their followed topics, newest first.Arguments
Name Type Required limitnumberNo Returns
cnnMyNewsResultinterface 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/listMyNewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cnn.listMyNews();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cnn.listMyNews())curl -X POST https://api.bowmark.ai/v1/sites/cnn/listMyNews \ -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.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/listNewslettersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cnn.listNewsletters();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cnn.listNewsletters())curl -X POST https://api.bowmark.ai/v1/sites/cnn/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.cnn.listNewsletters();listSectionHeadlinesThe latest headlines in one CNN section by section NAME ("Politics", "World", "Business", etc.).Arguments
Name Type Required 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/listSectionHeadlinesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cnn.listSectionHeadlines({ section: "Politics" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cnn.listSectionHeadlines({"section": "Politics"}))curl -X POST https://api.bowmark.ai/v1/sites/cnn/listSectionHeadlines \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"section":"Politics"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listTrendingTopicsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cnn.listTrendingTopics();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cnn.listTrendingTopics())curl -X POST https://api.bowmark.ai/v1/sites/cnn/listTrendingTopics \ -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.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/listVideosCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cnn.listVideos();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cnn.listVideos())curl -X POST https://api.bowmark.ai/v1/sites/cnn/listVideos \ -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.cnn.listVideos();searchArticlesSearch CNN, takes what a person would say ("breaking news", "inflation", "2024 election") and returns matching articles and videos, newest first…Arguments
Name Type Required querystringYes limitnumberResults per call, 1-50.No offsetnumberHow 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/searchArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cnn.searchArticles({ query: "election" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cnn.searchArticles({"query": "election"}))curl -X POST https://api.bowmark.ai/v1/sites/cnn/searchArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"election"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.cnn.searchArticles({ query: "election" });
followTopicAdd a topic to the signed-in viewer's followed topics, so it appears in their personalized My News feed.Arguments
Name Type Required topicIdstringYes Returns
cnnFollowedTopicinterface cnnFollowedTopic { topic_id: string; name: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/cnn/followTopicCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cnn.followTopic("<topicId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cnn.followTopic("<topicId>"))curl -X POST https://api.bowmark.ai/v1/sites/cnn/followTopic \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"topicId":"<topicId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.cnn.followTopic("<topicId>");subscribeToNewsletterSubscribe the signed-in viewer's account to a CNN newsletter by id.Arguments
Name Type Required newsletterIdstringYes Returns
cnnNewsletterSubscriptioninterface cnnNewsletterSubscription { newsletter_id: string; subscribed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/cnn/subscribeToNewsletterCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cnn.subscribeToNewsletter("<newsletterId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cnn.subscribeToNewsletter("<newsletterId>"))curl -X POST https://api.bowmark.ai/v1/sites/cnn/subscribeToNewsletter \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"newsletterId":"<newsletterId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.cnn.subscribeToNewsletter("<newsletterId>");unfollowTopicRemove a topic from the signed-in viewer's followed topics.Arguments
Name Type Required topicIdstringYes Returns
cnnUnfollowResultinterface cnnUnfollowResult { topic_id: string; unfollowed: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/cnn/unfollowTopicCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.cnn.unfollowTopic("<topicId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.cnn.unfollowTopic("<topicId>"))curl -X POST https://api.bowmark.ai/v1/sites/cnn/unfollowTopic \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"topicId":"<topicId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.cnn.unfollowTopic("<topicId>");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/cnn/<function> - OpenAPI
/v1/sites/cnn/openapi.json