The Independent MCP server for AI agents
Let Claude, ChatGPT or your own agent read The Independent: 11 typed functions through one MCP server. No The Independent API key needed.
- Functions
- 11
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for The Independent 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/independentOne MCP server for The Independent 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.
browseSectionLists the latest articles on one section front, e.g. /news/uk, /climate-change or /travel/hotels: headline, URL, author and image.Arguments
Name Type Required pathstringYes limitnumberNo Returns
BrowseSectionResultinterface IndependentStory { title: string; url: string; summary: string | null; published: string | null; articleId: string | null; imageUrl: string | null; } interface BrowseSectionResult { path: string; stories: IndependentStory[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/independent/browseSectionCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.independent.browseSection({ path: "/news/uk" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.independent.browseSection({"path": "/news/uk"}))curl -X POST https://api.bowmark.ai/v1/sites/independent/browseSection \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"path":"/news/uk"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.independent.browseSection({ path: "/news/uk" });getArticleGets one article: headline, standfirst, byline, dates, section, body text and images.Arguments
Name Type Required urlstringYes Returns
IndependentArticleinterface IndependentArticle { url: string; articleId: string | null; title: string; description: string | null; published: string | null; modified: string | null; section: string | null; author: { name: string; url: string | null } | null; imageUrl: string | null; freeToRead: boolean | null; paragraphs: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/independent/getArticleCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.independent.getArticle({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.independent.getArticle({"url": "<url>"}))curl -X POST https://api.bowmark.ai/v1/sites/independent/getArticle \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"url":"<url>"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.independent.getArticle({ url: "<url>" });getAuthorArticlesGets one writer's profile and their latest articles from /author/<slug>.Arguments
Name Type Required slugstringYes limitnumberNo Returns
GetAuthorArticlesResultinterface IndependentCard { title: string; url: string; articleId: string | null; section: { label: string; path: string } | null; imageUrl: string | null; } interface GetAuthorArticlesResult { slug: string; author: string | null; total: number; articles: IndependentCard[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/independent/getAuthorArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.independent.getAuthorArticles({ slug: "john-rentoul", limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.independent.getAuthorArticles({"slug": "john-rentoul", "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/independent/getAuthorArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"slug":"john-rentoul","limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.independent.getAuthorArticles({ slug: "john-rentoul", limit: 5 });getHomepageHeadlinesLists the top stories on The Independent's front page for one edition (UK, US or Asia).Arguments
Name Type Required edition"uk" | "us" | "asia"No limitnumberNo Returns
GetHomepageHeadlinesResultinterface IndependentStory { title: string; url: string; summary: string | null; published: string | null; articleId: string | null; imageUrl: string | null; } interface GetHomepageHeadlinesResult { edition: string; stories: IndependentStory[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/independent/getHomepageHeadlinesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.independent.getHomepageHeadlines({ edition: "uk" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.independent.getHomepageHeadlines({"edition": "uk"}))curl -X POST https://api.bowmark.ai/v1/sites/independent/getHomepageHeadlines \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"edition":"uk"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.independent.getHomepageHeadlines({ edition: "uk" });getMostPopularLists the most-read Independent articles right now, overall or for one area (articles, videos, Bulletin).Arguments
Name Type Required area"articles" | "videos" | "bulletin"No limitnumberNo Returns
GetMostPopularResultinterface PopularRow { rank: number; articleId: string; title: string; url: string; imageUrl: string | null; section: { title: string; path: string } | null; } interface GetMostPopularResult { area: string; articles: PopularRow[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/independent/getMostPopularCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.independent.getMostPopular({ area: "articles", limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.independent.getMostPopular({"area": "articles", "limit": 3}))curl -X POST https://api.bowmark.ai/v1/sites/independent/getMostPopular \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"area":"articles","limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.independent.getMostPopular({ area: "articles", limit: 3 });getTopicArticlesLists the latest articles on one topic page (/topic/<slug>).Arguments
Name Type Required slugstringYes limitnumberNo Returns
GetTopicArticlesResultinterface IndependentCard { title: string; url: string; articleId: string | null; section: { label: string; path: string } | null; imageUrl: string | null; } interface GetTopicArticlesResult { slug: string; topic: string | null; total: number; articles: IndependentCard[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/independent/getTopicArticlesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.independent.getTopicArticles({ slug: "climate-change", limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.independent.getTopicArticles({"slug": "climate-change", "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/independent/getTopicArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"slug":"climate-change","limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.independent.getTopicArticles({ slug: "climate-change", limit: 5 });listArticlesByDateLists every article The Independent published on one date, back to 1995.Arguments
Name Type Required datestringYes limitnumberNo Returns
ListArticlesByDateResultinterface ListArticlesByDateResult { date: string; total: number; articles: { url: string; articleId: string | null; lastmod: string | null }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/independent/listArticlesByDateCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.independent.listArticlesByDate({ date: "2024-01-15", limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.independent.listArticlesByDate({"date": "2024-01-15", "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/independent/listArticlesByDate \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"date":"2024-01-15","limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.independent.listArticlesByDate({ date: "2024-01-15", limit: 5 });listAuthorsFinds Independent writers by name; the door for getAuthorArticles.Arguments
Name Type Required letterstringNo querystringNo limitnumberNo Returns
ListAuthorsResultinterface ListAuthorsResult { letter: string; total: number; authors: { slug: string; url: string }[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/independent/listAuthorsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.independent.listAuthors({ letter: "j", limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.independent.listAuthors({"letter": "j", "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/independent/listAuthors \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"letter":"j","limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.independent.listAuthors({ letter: "j", limit: 5 });listLatestNewsLists the newest stories from an Independent RSS feed: the whole site (/rss) or one section (/<section>/rss).Arguments
Name Type Required sectionstringNo limitnumberNo Returns
ListLatestNewsResultinterface IndependentStory { title: string; url: string; summary: string | null; published: string | null; articleId: string | null; imageUrl: string | null; } interface ListLatestNewsResult { feed: string; stories: IndependentStory[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/independent/listLatestNewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.independent.listLatestNews();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.independent.listLatestNews())curl -X POST https://api.bowmark.ai/v1/sites/independent/listLatestNews \ -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.independent.listLatestNews();listSectionsLists The Independent's sections and subsections (News, Sport, Voices, Culture, Lifestyle, IndyBest, Travel, Money …) with their paths.Arguments
None.
Returns
ListSectionsResultinterface IndependentSection { label: string; path: string; parent: string | null; } interface ListSectionsResult { sections: IndependentSection[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/independent/listSectionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.independent.listSections();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.independent.listSections())curl -X POST https://api.bowmark.ai/v1/sites/independent/listSections \ -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.independent.listSections();listTopicsLists or finds Independent topic pages (e.g. climate-change, brexit) by name or first letter.Arguments
Name Type Required letterstringNo querystringNo limitnumberNo Returns
ListTopicsResultinterface ListTopicsResult { letter: string; total: number; topics: { slug: string; url: string }[]; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/independent/listTopicsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.independent.listTopics({ letter: "b", limit: 5 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.independent.listTopics({"letter": "b", "limit": 5}))curl -X POST https://api.bowmark.ai/v1/sites/independent/listTopics \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"letter":"b","limit":5}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.independent.listTopics({ letter: "b", limit: 5 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/independent/<function> - OpenAPI
/v1/sites/independent/openapi.json