Integrations

Cursor MCP server: write against your own articles

Point Cursor at your Mastheads newsroom and the articles, their sources and their recorded checks are available to whatever you are building - without exporting anything or copying text between windows.

Cursor and VS Code
{
  "mcpServers": {
    "mastheads": {
      "type": "http",
      "url": "https://api.mastheads.app/v1/mcp",
      "headers": { "Authorization": "Bearer mh_live_..." }
    }
  }
}

Create the key under Settings then Developer. A key made with Read only stays read only for its whole life - there is no switch, so a key that can spend is a key you decided to make that way.

This is the same server every other client talks to, so nothing about your newsroom is client-specific. What changes between clients is only how they authenticate.

The provenance tool is the one worth knowing about: get_article_sources returns the pages an article was written from, the verdicts the desks recorded against it, and the editor of record.

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