Mastheads.™
Integrations

Claude Code MCP: your newsroom as a set of tools

The Claude MCP integration, for Claude Code and for Claude on the web: connect either to your Mastheads newsroom. Claude reads your articles, the sources behind them and the checks they passed, and with a full-access key it can start one and publish it.

Start freeThe API guide
Claude Code
{
  "mcpServers": {
    "mastheads": {
      "type": "http",
      "url": "https://api.mastheads.app/v1/mcp",
      "headers": { "Authorization": "Bearer mh_live_..." }
    }
  }
}

Claude Code, Cursor and VS Code use this shape, with "type": "http". Claude Desktop and claude.ai connect instead by signing in with your Mastheads login - no key is pasted anywhere.

The MCP server is addressed at api.mastheads.app/v1/mcp. It is streamable HTTP and stateless - one POST per message - and the credential is the same API key the pull API takes. There is no second account and no separate password.

The Claude integration works two ways, and they differ: Claude Desktop and claude.ai sign in through OAuth, with a consent screen on your own dashboard. That screen carries one tick box, Let this app spend, and it is off unless you turn it on.

What it can read

Eleven tools, available to any key. A key created with Read only - which is the default - gets these and nothing else, and cannot spend or publish.

  • list_domainsThe publications on your account
  • list_articlesArticles on a domain. No body - that is get_article's job, and returning 100 bodies blew out the context a list exists to save
  • get_articleOne article, in full
  • get_article_sourcesThe sources it was written from, the desk verdicts recorded against it, and the editor of record
  • read_jobsWhat is running now and how far along
  • read_quotaArticles left this period
  • read_settingsHow a domain is configured
  • read_subscriptionThe plan and its limits
  • propose_generateReturns a confirm card and a link into the dashboard. It generates nothing
  • get_research_reportA finished research report
  • get_auditA finished domain audit, and any one of its six views
What a full-access key can do

Five more, listed only to a key created with Full access. The permission is fixed when the key is made: there is no switch to flip afterwards. A full-access key acts as the person who created it, under the same plan allowance and team permissions as the dashboard, and at most 20 paid actions an hour.

  • write_articleStart one article
  • write_articlesStart a batch, up to 100 rows
  • run_researchStart a research report
  • run_auditStart a domain audit
  • publish_articlePut a finished article live on the domain's connected site

On the Growth plan and up, at 120 reads a minute per key. The server is at https://api.mastheads.app/v1/mcp.

Other clients
ChatGPT

ChatGPT as a connector, signed in with your login.

Cursor

Cursor and VS Code, over streamable HTTP.

Codex

One command, and Codex holds the token itself.