AP News API and MCP server for AI agents
Let Claude, ChatGPT or your own agent read AP News. No AP News 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/apnews.md and add Bowmark's AP News MCP server to my agent.Run this in a terminal, then sign in when the browser opens.
claude mcp add --transport http bowmark-apnews https://api.bowmark.ai/mcp/site/apnewsPress the button, or add this to ~/.cursor/mcp.json.
{
"mcpServers": {
"bowmark-apnews": {
"url": "https://api.bowmark.ai/mcp/site/apnews"
}
}
}Press the button, or run this in a terminal.
code --add-mcp '{"name":"bowmark-apnews","type":"http","url":"https://api.bowmark.ai/mcp/site/apnews"}'Run this in a terminal.
codex mcp add bowmark-apnews --url https://api.bowmark.ai/mcp/site/apnewsIn Claude, open Plugins → Add → Add custom connector, paste this URL, and pick Sign in now.
https://api.bowmark.ai/mcp/site/apnewsIn ChatGPT, open Plugins, press +, choose Add custom MCP server and paste this URL.
https://api.bowmark.ai/mcp/site/apnewsAny MCP client that takes a remote (streamable HTTP) server: give it this URL.
https://api.bowmark.ai/mcp/site/apnewsFunctions
Open a function to see its parameters and run it with your own API key.
getArticleReads one AP article by URL: headline, byline, dates, section, keywords, lead image and the full body, from its NewsArticle JSON-LD.POST /v1/sites/apnews/getArticle
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/apnews/getArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apnews.getArticle({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apnews.getArticle({"url": "<url>"}))Responsereturns ApArticleinterface ApArticle { url: string; headline: string; description: string | null; authors: { name: string; url: string | null }[]; datePublished: string | null; dateModified: string | null; image: string | null; keywords: string[]; paragraphs: string[]; }listLatestNewsLists the latest headlines on the apnews.com homepage: title, url, section and timestamp of each story.POST /v1/sites/apnews/listLatestNews
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/apnews/listLatestNews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"limit":5}}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apnews.listLatestNews({ limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apnews.listLatestNews({"limit": 5}))Responsereturns ApLatestNewsinterface ApStory { title: string; url: string; updated: string | null } interface ApLatestNews { stories: ApStory[] }listSectionArticlesLists the stories on one section page (e.g. /politics, /sports) or subsection.POST /v1/sites/apnews/listSectionArticles
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/apnews/listSectionArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"section":"<section>"}}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apnews.listSectionArticles({ section: "<section>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apnews.listSectionArticles({"section": "<section>"}))Responsereturns ApSectionStoriesinterface ApStory { title: string; url: string; updated: string | null } interface ApSectionStories { section: string; stories: ApStory[] }listSectionsLists the site's top-level sections (U.S. News, World, Politics, Sports, Business, Technology, Health, …) with their URLs.POST /v1/sites/apnews/listSections
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/apnews/listSections \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apnews.listSections({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apnews.listSections({}))Responsereturns { sections: ApSection[] }interface ApSection { name: string; slug: string; url: string }listTopicArticlesLists the stories on one /hub/<topic> page (e.g. hub/iran, hub/weather), the site's topic hubs.POST /v1/sites/apnews/listTopicArticles
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/apnews/listTopicArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"topic":"weather","limit":5}}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apnews.listTopicArticles({ topic: "weather", limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apnews.listTopicArticles({"topic": "weather", "limit": 5}))Responsereturns ApTopicStoriesinterface ApStory { title: string; url: string; updated: string | null } interface ApTopicStories { topic: string; stories: ApStory[] }searchArticlesSearches AP News for a query (/search?q=) and returns matching articles, videos and galleries, newest first, with paging and an optional type/date…POST /v1/sites/apnews/searchArticles
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/apnews/searchArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"climate","sort":"newest"}}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.apnews.searchArticles({ query: "climate", sort: "newest" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.apnews.searchArticles({"query": "climate", "sort": "newest"}))Responsereturns ApSearchPageinterface ApSearchHit { title: string; url: string; type: "article" | "video" | "photo-gallery" | "live" | "other"; description: string | null; byline: string | null; published: string | null; } interface ApSearchPage { query: string; page: number; totalPages: number | null; totalResults: number | null; hits: ApSearchHit[]; }