People API and MCP server for AI agents
Let Claude, ChatGPT or your own agent read People. No People 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/people.md and add Bowmark's People MCP server to my agent.Run this in a terminal, then sign in when the browser opens.
claude mcp add --transport http bowmark-people https://api.bowmark.ai/mcp/site/peoplePress the button, or add this to ~/.cursor/mcp.json.
{
"mcpServers": {
"bowmark-people": {
"url": "https://api.bowmark.ai/mcp/site/people"
}
}
}Press the button, or run this in a terminal.
code --add-mcp '{"name":"bowmark-people","type":"http","url":"https://api.bowmark.ai/mcp/site/people"}'Run this in a terminal.
codex mcp add bowmark-people --url https://api.bowmark.ai/mcp/site/peopleIn Claude, open Plugins → Add → Add custom connector, paste this URL, and pick Sign in now.
https://api.bowmark.ai/mcp/site/peopleIn ChatGPT, open Plugins, press +, choose Add custom MCP server and paste this URL.
https://api.bowmark.ai/mcp/site/peopleAny MCP client that takes a remote (streamable HTTP) server: give it this URL.
https://api.bowmark.ai/mcp/site/peopleFunctions
Open a function to see its parameters and run it with your own API key.
getArticleReads one People story by URL: headline, byline, dates, section, lead image and the full body, from its Article JSON-LD and the page.POST /v1/sites/people/getArticle
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/people/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.people.getArticle({ url: "<url>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.people.getArticle({"url": "<url>"}))Responsereturns PeopleArticleinterface PeopleArticle { url: string; headline: string; description: string | null; publishedDate: string | null; modifiedDate: string | null; authors: string[]; section: string | null; imageUrl: string | null; paragraphs: string[]; }getCelebrityReads one celebrity topic page (/<name>-<id> person hub or /person/ page): name, bio blurb and their latest stories.POST /v1/sites/people/getCelebrity
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/people/getCelebrity \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"slug":"taylor-swift"}}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.people.getCelebrity({ slug: "taylor-swift" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.people.getCelebrity({"slug": "taylor-swift"}))Responsereturns PeopleCelebrityinterface PeopleStory { url: string; headline: string; imageUrl: string | null; } interface PeopleCelebrity { url: string; name: string; summary: string | null; overview: string | null; facts: { label: string; value: string }[]; socialLinks: string[]; articles: PeopleStory[]; }listLatestNewsLists the stories on the people.com homepage right now: headline, URL, image and section.POST /v1/sites/people/listLatestNews
Parameters
No parameters.
curl -X POST https://api.bowmark.ai/v1/sites/people/listLatestNews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.people.listLatestNews();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.people.listLatestNews())Responsereturns PeopleStoryListinterface PeopleStory { url: string; headline: string; imageUrl: string | null; } interface PeopleStoryList { articles: PeopleStory[]; }listSectionArticlesLists the stories on one section page such as /celebrity/ or /royals/, from its ItemList JSON-LD.POST /v1/sites/people/listSectionArticles
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/people/listSectionArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"section":"celebrity"}}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.people.listSectionArticles({ section: "celebrity" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.people.listSectionArticles({"section": "celebrity"}))Responsereturns PeopleStoryListinterface PeopleStory { url: string; headline: string; imageUrl: string | null; } interface PeopleStoryList { articles: PeopleStory[]; }listSectionsLists People's sections and subsections from the header nav (celebrity, royals, crime, TV, movies, music, human interest, lifestyle, shopping…): the…POST /v1/sites/people/listSections
Parameters
No parameters.
curl -X POST https://api.bowmark.ai/v1/sites/people/listSections \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.people.listSections();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.people.listSections())Responsereturns PeopleSectionListinterface PeopleSection { name: string; url: string; slug: string; } interface PeopleSectionList { sections: PeopleSection[]; }searchArticlesSearches people.com (/search?q=) and returns matching stories with headline, URL and image.POST /v1/sites/people/searchArticles
Parameters
curl -X POST https://api.bowmark.ai/v1/sites/people/searchArticles \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"taylor swift"}}'import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.people.searchArticles({ query: "taylor swift" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.people.searchArticles({"query": "taylor swift"}))Responsereturns PeopleStoryListinterface PeopleStory { url: string; headline: string; imageUrl: string | null; } interface PeopleStoryList { articles: PeopleStory[]; }