# People API and MCP server for AI agents (/sites/people)

An API for People: let Claude, ChatGPT or your own code read People through 6 functions, over MCP, HTTP, Node or Python. No People API key needed.

- Site: https://people.com
- Functions: 6
- Sign-in: for account actions, with the person's own account
- Works with: MCP, HTTP, Node, Python

## Add it to your agent

If you are an agent asked to set this up: add the server yourself, in the person's own (global) MCP configuration, and keep their other entries.

- People only, one tool per function: `https://api.bowmark.ai/mcp/site/people` (name it `bowmark-people`)
- Every site Bowmark covers: `https://api.bowmark.ai/mcp` (name it `bowmark`)
- Transport: remote MCP over streamable HTTP.
- Claude Code: `claude mcp add --transport http bowmark-people https://api.bowmark.ai/mcp/site/people`
- Codex: `codex mcp add bowmark-people --url https://api.bowmark.ai/mcp/site/people`
- Cursor, VS Code and other clients: add `{ "url": "https://api.bowmark.ai/mcp/site/people" }` under the name `bowmark-people` in the client's MCP config. Per-client steps: https://bowmark.ai/docs/installation.md
- Sign-in: OAuth in the browser on first use; the person only signs in. A client that cannot do OAuth sends `Authorization: Bearer <BOWMARK_API_KEY>`; the person creates a key at https://bowmark.ai/dashboard/keys.
- Then list the server's tools to confirm it works, and tell the person it is ready.

## Functions

### Read

- `getArticle`: Reads one People story by URL: headline, byline, dates, section, lead image and the full body, from its Article JSON-LD and the page.
- `getCelebrity`: Reads one celebrity topic page (/<name>-<id> person hub or /person/ page): name, bio blurb and their latest stories.
- `listLatestNews`: Lists the stories on the people.com homepage right now: headline, URL, image and section.
- `listSectionArticles`: Lists the stories on one section page such as /celebrity/ or /royals/, from its ItemList JSON-LD.
- `listSections`: Lists People's sections and subsections from the header nav (celebrity, royals, crime, TV, movies, music, human interest, lifestyle, shopping…): the…
- `searchArticles`: Searches people.com (/search?q=) and returns matching stories with headline, URL and image.

## Call one

In a Bowmark script, each function is `bowmark.providers.people.<name>`. Ask `get_library` for people.com to get each one's arguments, then call it with `run`.

```js
// 1. What can I call on people.com, and with which arguments?
get_library({ query: "people.com" })

// 2. Call it in a script
const result = await bowmark.providers.people.getArticle({ /* arguments from get_library */ });
return result;
```

New to Bowmark? Quickstart: https://bowmark.ai/docs/quickstart.md. How sign-in works: https://bowmark.ai/docs/signed-in-sites.md
