Medialyst MCP

Medialyst is the data layer for your agent. The remote MCP server exposes a small set of public REST-backed research tools:

https://medialyst.ai/api/mcp

Each MCP tool is a thin shim over a public /api/v1/* REST endpoint. Tool results, auth failures, quota errors, and response shapes match the public API.

Authentication

You have two ways to connect, and both grant the same scoped, org-level access:

• OAuth — for chat clients like Claude.ai and ChatGPT. Paste the MCP URL, authorize Medialyst when prompted, pick your organization, and you're in. No API key to paste.
• API key — for clients that send an Authorization header (Claude Code, Cursor, Codex) and for CI. Create a key from Developers, store it in secret storage or an environment variable, and send it as a bearer token:

Authorization: Bearer <YOUR_API_KEY>

Required Scopes

Connect Your Agent

Claude.ai and ChatGPT (OAuth)

Add Medialyst as a custom connector with just the URL — no header, no key:

1. Settings → Connectors → Add custom connector
2. Name: Medialyst
3. Remote MCP server URL: https://medialyst.ai/api/mcp
4. Leave advanced settings empty. Add it, then authorize Medialyst with OAuth when prompted and choose your organization.

ChatGPT custom connectors are currently rolling out for Plus and Pro.

Claude Code

export MEDIALYST_API_KEY="<YOUR_API_KEY>"

claude mcp add --transport http --scope user medialyst https://medialyst.ai/api/mcp \
  --header "Authorization: Bearer $MEDIALYST_API_KEY"

Verify in Claude Code:

/mcp

Claude Desktop

{
  "mcpServers": {
    "medialyst": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://medialyst.ai/api/mcp",
        "--header",
        "Authorization: ${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "medialyst": {
      "url": "https://medialyst.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MEDIALYST_API_KEY}"
      }
    }
  }
}

Then start Cursor from a shell where the key is exported:

export MEDIALYST_API_KEY="<YOUR_API_KEY>"
cursor .

Codex

[mcp_servers.medialyst]
url = "https://medialyst.ai/api/mcp"
bearer_token_env_var = "MEDIALYST_API_KEY"

Then export the key before starting Codex:

export MEDIALYST_API_KEY="<YOUR_API_KEY>"
codex mcp list

Command line (newsjack)

newsjack is the open-source PR CLI built on Medialyst. Connect it with one command:

newsjack login

Approve the browser prompt and the CLI authenticates with OAuth device login — no API key to copy out of the terminal. Install instructions live at newsjack.sh. CI and power users can still set a MEDIALYST_API_KEY instead.

Other Clients

Use the Streamable HTTP endpoint and bearer header directly:

MCP URL: https://medialyst.ai/api/mcp
Transport: Streamable HTTP
Header: Authorization: Bearer <YOUR_API_KEY>

If your client only supports stdio servers, bridge to the remote endpoint with mcp-remote.

Tool Surface

Only these five tools are exposed. Media-list workflow creation, workflow row reads, and share-link creation stay in the public REST API and Medialyst app, but are not part of the MCP tool surface.

Example Workflows

Ask your agent:

Search recent AI agents coverage and find 5 journalists I should pitch on a related angle.

Expected sequence:

1. get_credit_balance
2. query_pr_calendar when the user needs planning moments or pitch timing
3. search_news with a specific recency window
4. enrich_journalists with selected article URLs and fit_context.pitch
5. get_journalist_enrichment_job until the job is complete or failed

Notes

• search_news returns up to 10 results per call. Use page: 2, page: 3, and so on for deeper coverage. Do not use the deprecated num parameter.
• query_pr_calendar is free, costs 0 credits per successful call, and returns source-backed PR moments with pitch timing fields.
• enrich_journalists is async-only and returns a job id immediately. It accepts article_url sources today. fit_context.pitch returns scored journalist research and personalized angle output when available.
• options.wait and options.timeout_ms on enrich_journalists are deprecated compatibility no-ops. Poll get_journalist_enrichment_job instead.
• Public v1 has no send endpoint. Review and sending stay in the Medialyst app.

Troubleshooting

Build a Full Agent

Medialyst is the data layer. If you want the whole PR workflow — finding angles, building a fit-scored journalist list, and drafting pitches — use newsjack.sh, the open-source agent built on Medialyst by the team behind it. It connects with OAuth device login and ships opinionated skills for the full PR loop, so you don't have to assemble the primitives yourself.

Prefer to build your own agent on the raw primitives? See PR Agents on Medialyst.