The Wall Street Journal MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on The Wall Street Journal: 25 typed functions through one MCP server. No The Wall Street Journal API key needed.

Functions
25
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just The Wall Street Journal

An MCP server for The Wall Street Journal 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/wsj
Every site

One MCP server for The Wall Street Journal and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both 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.

Read 21
  • getArticleGets one article's own headline, byline, dek, section, publish date and body.

    Arguments

    NameTypeRequired
    urlstring
    A url from listArticles or listSections.
    Yes

    Returns WsjArticle

    interface WsjArticle {
      headline: string;
      byline: string | null; // e.g. "Marcus Walker and Serhiy Bosak"
      dek: string | null;
      section: string | null;
      publishedAt: string | null; // ISO
      body: string[]; // the free preview when paywalled, the full article otherwise
      paywalled: boolean;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/getArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.getArticle({ url: "<url>" });
  • getArticleFullTextGets the full text of a subscriber-only article using the CALLER's own WSJ subscription.

    Arguments

    NameTypeRequired
    urlstring
    A www.wsj.com article url; needs the caller's own WSJ subscription.
    Yes

    Returns WsjArticle

    interface WsjArticle {
      headline: string;
      byline: string | null; // e.g. "Marcus Walker and Serhiy Bosak"
      dek: string | null;
      section: string | null;
      publishedAt: string | null; // ISO
      body: string[]; // the free preview when paywalled, the full article otherwise
      paywalled: boolean;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/getArticleFullText

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.getArticleFullText({ url: "<url>" });
  • getAuthorGets a WSJ journalist's own byline page (/news/author/<slug>).

    Arguments

    NameTypeRequired
    seoNamestring
    A byline slug, e.g. "marcus-walker", or the author page url.
    Yes

    Returns WsjAuthor

    interface WsjAuthor {
      id: string | null;
      name: string;
      seoName: string; // e.g. "marcus-walker", pass to listArticlesByAuthor
      title: string | null; // e.g. "South Europe Bureau Chief"
      bio: string | null; // plain text
      organization: string | null;
      email: string | null;
      twitter: string | null; // handle, no "@"
      imageUrl: string | null;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/getAuthor

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.getAuthor({ seoName: "marcus-walker" });
  • getNewsletterGets one WSJ newsletter's own catalog entry by seoName or id.

    Arguments

    NameTypeRequired
    seoNamestring
    From listNewsletters, e.g. "whats-news", or its numeric id.
    Yes

    Returns WsjNewsletter

    interface WsjNewsletter {
      id: string; // e.g. "401"
      seoName: string; // e.g. "whats-news", pass to getNewsletter
      name: string; // e.g. "What’s News"
      description: string | null;
      cadence: string | null; // the site's own words, e.g. "Daily", "Tuesdays, Thursdays"
      subscribersOnly: boolean; // true when only a paying WSJ subscriber can sign up
      edition: string; // e.g. "us_gc" (US), "ko" (Korea)
      latestIssueUrl: string | null; // the site's own preview of a recent issue
      imageUrl: string | null;
      authorIds: string[]; // WSJ author ids of the newsletter's writers
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/getNewsletter

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.getNewsletter({ seoName: "<seoName>" });
  • getPodcastGets one podcast's own catalog record by seoName.

    Arguments

    NameTypeRequired
    seoNamestring
    From listPodcasts, e.g. "whats-news".
    Yes

    Returns WsjPodcastDetail

    interface WsjPodcastSubscribeLink {
      name: string; // e.g. "Apple Podcasts", "Spotify", "RSS"
      url: string;
    }
    
    interface WsjPodcast {
      name: string; // e.g. "What's News"
      seoName: string; // e.g. "whats-news", pass to listEpisodes/getPodcast
      description: string | null;
      category: string | null; // e.g. "News & Politics"
      author: string | null;
      url: string;
      subscribe: WsjPodcastSubscribeLink[];
    }
    
    interface WsjPodcastDetail extends WsjPodcast {
      feedUrl: string | null; // the show's own RSS feed, null for the few sponsored shows that publish none
      imageUrl: string | null;
      episodeCount: number | null;
      lastEpisodeAt: string | null; // ISO
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/getPodcast

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.getPodcast({ seoName: "whats-news" });
  • getQuoteGets one US-listed symbol's current quote.

    Arguments

    NameTypeRequired
    symbolstring
    A stock ticker, e.g. "AAPL".
    Yes

    Returns WsjQuote

    interface WsjQuote {
      symbol: string; // e.g. "AAPL"
      name: string; // e.g. "Apple Inc."
      exchange: string | null; // e.g. "U.S.: Nasdaq"
      price: number;
      change: number; // net change, same sign as the site's own display
      changePercent: number; // e.g. 0.93 for "+0.93%"
      open: number;
      high: number;
      low: number;
      volume: number | null;
      asOf: string | null; // ISO, off CompositeTrading.Last.Time
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/getQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.getQuote({ symbol: "AAPL" });
  • getWatchlistGets the caller's own WSJ stock watchlist through their signed-in WSJ session.

    Arguments

    None.

    Returns WsjMarketIndex[]

    interface WsjMarketIndex {
      name: string; // e.g. "Dow Jones Industrial Average"
      symbol: string; // e.g. "DJIA"
      price: number;
      change: number; // net change, same sign as the site's own display
      changePercent: number; // e.g. 0.59 for "+0.59%"
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/getWatchlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.getWatchlist();
  • listArticlesLists a section front's own article grid, newest first, with headline, byline, teaser and url.

    Arguments

    NameTypeRequired
    sectionstring
    A path from listSections, e.g. "/world" or "world".
    Yes

    Returns WsjArticleSummary[]

    interface WsjArticleSummary {
      headline: string;
      byline: string | null; // e.g. "Erin Mulvaney, Cara Lombardo"
      teaser: string | null;
      url: string; // pass to getArticle
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/listArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.listArticles({ section: "/news/markets" });
  • listArticlesByAuthorLists a journalist's own articles off their byline page, newest first, 50 a page via page.

    Arguments

    NameTypeRequired
    seoNamestringYes
    pagenumber
    1-based, 50 articles a page; default 1.
    No

    Returns WsjAuthorArticle[]

    interface WsjAuthorArticle {
      headline: string;
      summary: string | null;
      section: string | null; // the flashline, e.g. "World"
      authors: string[];
      publishedAt: string | null; // ISO
      isOpinion: boolean;
      imageUrl: string | null;
      url: string; // pass to getArticle
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/listArticlesByAuthor

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.listArticlesByAuthor({ seoName: "<seoName>" });
  • listCommoditiesLists the commodity futures on WSJ's Commodities and Futures page.

    Arguments

    None.

    Returns WsjMarketInstrument[]

    interface WsjMarketInstrument {
      name: string; // the table's label, e.g. "Crude Oil Futures", "Euro (EUR/USD)"
      fullName: string | null; // e.g. "Crude Oil WTI (NYM $/bbl) Front Month"
      symbol: string; // WSJ's ticker, e.g. "CL.1", "EURUSD"
      kind: string; // "Future" | "Currency" | "CryptoCurrency"
      price: number;
      change: number;
      changePercent: number;
      dailyHigh: number | null;
      dailyLow: number | null;
      timestamp: string | null;
      url: string | null; // the instrument's own WSJ quote page
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/listCommodities

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.listCommodities();
  • listCurrenciesLists exchange rates off WSJ's Currencies page.

    Arguments

    None.

    Returns WsjMarketInstrument[]

    interface WsjMarketInstrument {
      name: string; // the table's label, e.g. "Crude Oil Futures", "Euro (EUR/USD)"
      fullName: string | null; // e.g. "Crude Oil WTI (NYM $/bbl) Front Month"
      symbol: string; // WSJ's ticker, e.g. "CL.1", "EURUSD"
      kind: string; // "Future" | "Currency" | "CryptoCurrency"
      price: number;
      change: number;
      changePercent: number;
      dailyHigh: number | null;
      dailyLow: number | null;
      timestamp: string | null;
      url: string | null; // the instrument's own WSJ quote page
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/listCurrencies

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.listCurrencies();
  • listEpisodesLists a podcast's own episodes, newest first, off the show's RSS feed on Dow Jones' podcast host.

    Arguments

    NameTypeRequired
    seoNamestring
    From listPodcasts, e.g. "whats-news".
    Yes
    limitnumber
    Default 50.
    No

    Returns WsjEpisode[]

    interface WsjEpisode {
      id: string | null; // the feed's own guid
      title: string;
      description: string | null; // HTML, as the feed ships it
      publishedAt: string | null; // ISO
      duration: string | null; // e.g. "00:12:43"
      audioUrl: string | null;
      episodeNumber: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/listEpisodes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.listEpisodes({ seoName: "whats-news", limit: 5 });
  • listMarketIndicesLists the major indices WSJ's own Markets front ships inline.

    Arguments

    None.

    Returns WsjMarketIndex[]

    interface WsjMarketIndex {
      name: string; // e.g. "Dow Jones Industrial Average"
      symbol: string; // e.g. "DJIA"
      price: number;
      change: number; // net change, same sign as the site's own display
      changePercent: number; // e.g. 0.59 for "+0.59%"
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/listMarketIndices

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.listMarketIndices();
  • listNewslettersLists WSJ's own email newsletters off its newsletter catalog.

    Arguments

    None.

    Returns WsjNewsletter[]

    interface WsjNewsletter {
      id: string; // e.g. "401"
      seoName: string; // e.g. "whats-news", pass to getNewsletter
      name: string; // e.g. "What’s News"
      description: string | null;
      cadence: string | null; // the site's own words, e.g. "Daily", "Tuesdays, Thursdays"
      subscribersOnly: boolean; // true when only a paying WSJ subscriber can sign up
      edition: string; // e.g. "us_gc" (US), "ko" (Korea)
      latestIssueUrl: string | null; // the site's own preview of a recent issue
      imageUrl: string | null;
      authorIds: string[]; // WSJ author ids of the newsletter's writers
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/listNewsletters

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.listNewsletters();
  • listPodcastsLists WSJ's own podcasts (What's News, The Journal, Minute Briefing, etc.) off the site's podcast catalog, with description, category and subscribe…

    Arguments

    None.

    Returns WsjPodcast[]

    interface WsjPodcastSubscribeLink {
      name: string; // e.g. "Apple Podcasts", "Spotify", "RSS"
      url: string;
    }
    
    interface WsjPodcast {
      name: string; // e.g. "What's News"
      seoName: string; // e.g. "whats-news", pass to listEpisodes/getPodcast
      description: string | null;
      category: string | null; // e.g. "News & Politics"
      author: string | null;
      url: string;
      subscribe: WsjPodcastSubscribeLink[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/listPodcasts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.listPodcasts();
  • listQuotesGets quotes for several US-listed symbols in one call.

    Arguments

    NameTypeRequired
    symbolsstring[]
    Stock tickers, e.g. ["AAPL", "MSFT", "NVDA"].
    Yes

    Returns WsjQuotesResult

    interface WsjQuote {
      symbol: string; // e.g. "AAPL"
      name: string; // e.g. "Apple Inc."
      exchange: string | null; // e.g. "U.S.: Nasdaq"
      price: number;
      change: number; // net change, same sign as the site's own display
      changePercent: number; // e.g. 0.93 for "+0.93%"
      open: number;
      high: number;
      low: number;
      volume: number | null;
      asOf: string | null; // ISO, off CompositeTrading.Last.Time
    }
    
    interface WsjQuotesResult {
      quotes: WsjQuote[];
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/listQuotes

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.listQuotes({ symbols: ["AAPL", "MSFT"] });
  • listSavedArticlesLists the articles the caller has saved to their own My WSJ account, through the CALLER's signed-in WSJ session.

    Arguments

    None.

    Returns WsjArticleSummary[]

    interface WsjArticleSummary {
      headline: string;
      byline: string | null; // e.g. "Erin Mulvaney, Cara Lombardo"
      teaser: string | null;
      url: string; // pass to getArticle
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/listSavedArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.listSavedArticles();
  • listSectionsLists WSJ's own news sections and verticals (World, Business, Markets, Tech, Opinion, Life & Arts, Personal Finance, etc.) off the site's own…

    Arguments

    None.

    Returns WsjSection[]

    interface WsjSection {
      name: string; // e.g. "World", "Personal Finance"
      path: string; // e.g. "/world", pass to listArticles
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/listSections

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.listSections();
  • listTreasuryYieldsLists U.S. Treasury yields by maturity, 1-month bill to 30-year bond, off WSJ's Bonds and Rates page.

    Arguments

    None.

    Returns WsjTreasuryYield[]

    interface WsjTreasuryYield {
      maturity: string; // "30-Year Bond", "10-Year Note", "3-Month Bill", …
      symbol: string; // e.g. "TMUBMUSD10Y"
      yieldPercent: number; // e.g. 5.04
      yieldChange: number; // percentage points
      price: number | null; // trade price, e.g. 96.1
      priceChange: string | null; // in 32nds as WSJ shows it, e.g. "-2/32"
      couponRate: number | null;
      timestamp: string | null;
      url: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/listTreasuryYields

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.listTreasuryYields();
  • listTrendingLists WSJ's own Most Popular articles right now.

    Arguments

    None.

    Returns WsjTrendingArticle[]

    interface WsjTrendingArticle {
      rank: number; // 1-based, within its list
      list: "news" | "opinion"; // "Most Popular News" or "Most Popular Opinion"
      headline: string;
      section: string | null; // the flashline, e.g. "Tech", "Review & Outlook"
      id: string | null;
      isBreaking: boolean;
      imageUrl: string | null;
      url: string; // pass to getArticle
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/listTrending

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.listTrending();
  • searchArticlesSearches WSJ's own site search for a keyword and returns matching articles with headline, byline, a publish timestamp and url.

    Arguments

    NameTypeRequired
    querystringYes

    Returns WsjSearchResult[]

    interface WsjSearchResult {
      headline: string;
      byline: string | null; // e.g. "Patrick George"
      teaser: string | null;
      publishedAt: string | null; // the site's own timestamp string, relative or absolute
      url: string; // pass to getArticle
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/searchArticles

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.searchArticles({ query: "markets" });
Act 4
  • addToWatchlistAdds a stock to the caller's own WSJ watchlist through their signed-in WSJ session, by pressing the symbol quote page's own watchlist control.

    Arguments

    NameTypeRequired
    symbolstring
    A stock ticker, e.g. "AAPL".
    Yes

    Returns WsjWatchlistWriteResult

    interface WsjWatchlistWriteResult {
      symbol: string;
      watching: boolean; // whether the symbol is on the caller's watchlist after the call
      changed: boolean; // false when it was already in that state
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/addToWatchlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.addToWatchlist({ symbol: "<symbol>" });
  • removeFromWatchlistRemoves a stock from the caller's own WSJ watchlist through their signed-in WSJ session, by pressing the symbol quote page's own watchlist control.

    Arguments

    NameTypeRequired
    symbolstring
    A stock ticker, e.g. "AAPL".
    Yes

    Returns WsjWatchlistWriteResult

    interface WsjWatchlistWriteResult {
      symbol: string;
      watching: boolean; // whether the symbol is on the caller's watchlist after the call
      changed: boolean; // false when it was already in that state
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/removeFromWatchlist

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.removeFromWatchlist({ symbol: "<symbol>" });
  • saveArticleSaves an article to the caller's own My WSJ saved list, through their signed-in WSJ session, by pressing the article page's own save control.

    Arguments

    NameTypeRequired
    urlstring
    A www.wsj.com article url, e.g. from listArticles or listSavedArticles.
    Yes

    Returns WsjSaveResult

    interface WsjSaveResult {
      url: string;
      saved: boolean; // the article's state on the caller's saved list after the call
      changed: boolean; // false when it was already in that state
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/saveArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.saveArticle({ url: "<url>" });
  • unsaveArticleRemoves an article from the caller's own My WSJ saved list, through their signed-in WSJ session, by pressing the article page's own save control.

    Arguments

    NameTypeRequired
    urlstring
    A www.wsj.com article url, e.g. from listArticles or listSavedArticles.
    Yes

    Returns WsjSaveResult

    interface WsjSaveResult {
      url: string;
      saved: boolean; // the article's state on the caller's saved list after the call
      changed: boolean; // false when it was already in that state
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/wsj/unsaveArticle

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.wsj.unsaveArticle({ url: "<url>" });

Use it from code