Integrations

ChatGPT MCP: connect ChatGPT to your own newsroom

The ChatGPT integration is a connector: add Mastheads to ChatGPT and it can read the publications on your account, the articles in them, and the sources each one was written from. You sign in with your Mastheads login - there is no key to paste.

Connector URL
https://api.mastheads.app/v1/mcp

ChatGPT, Claude Desktop and claude.ai connect through OAuth 2.1. You approve it on a consent screen at dash.mastheads.app, and Disconnect there ends it - the same revoke a key gets.

A connected app is an ordinary key held by the app: the same table, the same guards, the same ceilings. Whether it may spend is fixed at the moment you consent, and the tick box is never pre-ticked.

You can connect up to ten apps, counted apart from the three keys you can make by hand. They are listed under Settings then Developer, each with a Disconnect beside it.

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