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.

Functions

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>"}}'
    Sign in to run
    Responsereturns PeopleArticle
    interface 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"}}'
    Sign in to run
    Responsereturns PeopleCelebrity
    interface 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 '{}'
    Sign in to run
    Responsereturns PeopleStoryList
    interface 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"}}'
    Sign in to run
    Responsereturns PeopleStoryList
    interface 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 '{}'
    Sign in to run
    Responsereturns PeopleSectionList
    interface 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"}}'
    Sign in to run
    Responsereturns PeopleStoryList
    interface PeopleStory {
      url: string;
      headline: string;
      imageUrl: string | null;
    }
    
    interface PeopleStoryList {
      articles: PeopleStory[];
    }