Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

NewsCatcher MCP

✓ newscatcherapi.com

von NewscatcherVersion 0.2.1i★ 0iLäuft in der CloudOffizielle Website ↗
Name in der Registrycom.newscatcherapi/newscatcher-mcp

So installierst du es

Was es kann

Search news in any language, track coverage over time, and research companies and events.

Originaltext des Herstellers

  • Verbindung Läuft in der Cloud
  • Konto oder Schlüssel Braucht x-api-key
  • Kategorie Suche & KI-Gedächtnis

Zusammen nutzen mit

Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

von google-research★ 35.6421 Skills

Skill · Anleitung

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

von BigBodyCobain★ 11.6081 Skills

Skill · Anleitung

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

von gosom★ 8.2561 Skills

Skill · Anleitung

Warum es hier steht

Dieser Eintrag steht im Tab „Apps, die sich mit KI verbinden“, der ohne Sterne in dieser Reihenfolge sortiert

1. In Claudes Connector-VerzeichnisNein
2. Vom Team getestetNein
3. Für Nutzer in Thailand geeignetNein
4. Nutzung ohne Sterne20/100Beliebtheit 0 · Aktualität 12 · Antwortet noch 8 · Likes von Nutzern +0
5. Eingetragen am2026-11-16

Likes von Nutzern: 0 · Höchstens 5 Punkte (1 pro Person). Nicht käuflich.

Qualität: 4/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte NewsCatcher MCP. Folge https://mcp.popnx.com/i/newscatcherapi-newscatcher-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

4/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (mcp.newscatcherapi.com) · ✓ Befehle geprüft am 17. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 5 Min.

Du brauchst einen Schlüssel von NewsCatcher MCP (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Bei NewsCatcher MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von NewsCatcher MCP öffnen ↗

  2. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameNewsCatcher MCP
    Remote MCP server URL · Adressehttps://mcp.newscatcherapi.com/mcp

    Unter Request headers diesen Namen und Wert hinzufügen

    Header-Namex-api-key
    Wert<Schlüssel hier einfügen>

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  4. Im Chat einschalten

    +ConnectorsNewsCatcher MCP

  5. Ausprobieren

    Nutze NewsCatcher MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es NewsCatcher MCP nutzt, oder ein Werkzeug von NewsCatcher MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann NewsCatcher MCP noch nicht verbinden

NewsCatcher MCP braucht zum Verbinden deinen eigenen Schlüssel, aber die OpenAI-Hilfe beschreibt nur die Anmeldung per OAuth; eine Schlüssel-Option konnten wir nicht bestätigen

Das kannst du stattdessen tun

A · Eine App nutzen, die NewsCatcher MCP verbinden kann

  • Du brauchst einen Schlüssel von NewsCatcher MCP (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu
  • Du brauchst einen Schlüssel von NewsCatcher MCP (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von NewsCatcher MCP (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von NewsCatcher MCP (auf der Seite des Anbieters erstellen)

B · Andere in Suche & KI-Gedächtnis, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code · etwa 5 Min.

Du brauchst einen Schlüssel von NewsCatcher MCP (auf der Seite des Anbieters erstellen)

  1. Bei NewsCatcher MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von NewsCatcher MCP öffnen ↗

  2. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  3. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user newscatcher https://mcp.newscatcherapi.com/mcp --header 'x-api-key: your-value'

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. /mcp in Claude Code eingeben

    NewsCatcher MCP sollte in der Liste als verbunden erscheinen

  5. Ausprobieren

    Nutze NewsCatcher MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es NewsCatcher MCP nutzt, oder ein Werkzeug von NewsCatcher MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 5 Min.

Du brauchst einen Schlüssel von NewsCatcher MCP (auf der Seite des Anbieters erstellen)

  1. Bei NewsCatcher MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von NewsCatcher MCP öffnen ↗

  2. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von NewsCatcher MCP ist x-api-key leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in Cursor im Agent-Modus öffnen

  5. Ausprobieren

    Nutze NewsCatcher MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es NewsCatcher MCP nutzt, oder ein Werkzeug von NewsCatcher MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 5 Min.

Du brauchst einen Schlüssel von NewsCatcher MCP (auf der Seite des Anbieters erstellen)

  1. Bei NewsCatcher MCP registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Seite von NewsCatcher MCP öffnen ↗

  2. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von NewsCatcher MCP ist x-api-key leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in VS Code im Agent-Modus öffnen

  5. Ausprobieren

    Nutze NewsCatcher MCP und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es NewsCatcher MCP nutzt, oder ein Werkzeug von NewsCatcher MCP in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://mcp.newscatcherapi.com/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die NewsCatcher MCP nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user newscatcher https://mcp.newscatcherapi.com/mcp --header 'x-api-key: your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "newscatcher": {
      "url": "https://mcp.newscatcherapi.com/mcp",
      "headers": {
        "x-api-key": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "newscatcher": {
      "type": "http",
      "url": "https://mcp.newscatcherapi.com/mcp",
      "headers": {
        "x-api-key": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • x-api-key geheim HTTP header
    Optionaler NewsCatcher-API-Schlüssel von platform.newscatcherapi.com. Weglassen, um sich mit Ihrem NewsCatcher-Konto anzumelden.
    Englisches Original anzeigenOptional NewsCatcher API key from platform.newscatcherapi.com. Leave it out to sign in with your NewsCatcher account.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Bestätigte Domain
✓ newscatcherapi.com
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
0.2.1
In der Registry veröffentlichti
17. Nov. 2026
Code zuletzt geänderti
20. Nov. 2026
Zuletzt geprüft
17. Nov. 2026
Entwickler
Newscatcher
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Der Server verlangt eine Anmeldung, bevor er seine Tools auflistet.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026

  • ! Vorsicht

    Entwickler passt zum Repo

    Der Herausgeber (newscatcherapi.com) ist nicht der Repo-Inhaber (Newscatcher); vielleicht hat jemand anderes ihn eingetragen

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: heute

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 192 ms (HTTP 401)

  • ✓ Bestanden

    Anmeldung mit OAuth

    Gibt OAuth-Anmeldung an, damit deine KI-App dich zum Einloggen weiterleiten kann

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/newscatcherapi-newscatcher-mcp.svg)](https://mcp.popnx.com/en/servers/newscatcherapi-newscatcher-mcp)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Suche & KI-Gedächtnisi

  • Mehr Sterne als 0 % der anderen 6508 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 90 % der anderen 6508 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 57 % der anderen 6508 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist NewsCatcher MCP sicher?

Er hat 4 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: x-api-key

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt heute geändert, und die neueste Version (0.2.1) kam vor 3 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

von every-appWeit verbreitet★ 28.384Aktualisiert vor 6 Tagen

Läuft in der Cloud✓ everyapp.com

Exa

Official Exa MCP for web search, content fetching, and multi-step research.

von exa-labsWeit verbreitet★ 5245Aktualisiert heute

Läuft in der Cloud✓ vom Dienst · exa.aiVom PopNx-Team ausprobiert

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

von MicrosoftDocsWeit verbreitet★ 2002Aktualisiert vor 12 Monaten

Läuft in der Cloud✓ vom Dienst · microsoft.comVom PopNx-Team ausprobiert

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

von proxysoulWachsend★ 1629Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ empryo.com

COTAL actions (cotal.ai)

cotal.ai actions: product overview, site search, build log, feedback, Cloud waitlist, updates, calls

von Cotal-AIWachsend★ 403Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · cotal.ai
Im Vergleich mit ähnlichen
Dieser
NewsCatcher MCP
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Läuft woLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinJaJaJaNeinNein
Basisprüfungen4/55/52/44/44/44/4
LizenzMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

NewsCatcher MCP

MCP server for the NewsCatcher News API (search, exact counts, stories) and the research agent (verified event datasets, company news, company lists, monitors). Hosted on Vercel as stateless Streamable HTTP; every user brings their own NewsCatcher Platform API key.

Tool names, descriptions, defaults and output wording were tuned against model evals: change them deliberately.

Connect

Sign in with your NewsCatcher account (deployments with sign-in on): add https:// /mcp as a connector in Claude, ChatGPT or Cursor and press Connect. You sign in to the NewsCatcher platform, approve the app, and the server uses your workspace's Default API Key. No key to copy.

Or bring an API key. Get one at platform.newscatcherapi.com.

Claude Code

claude mcp add --transport http newscatcher https://<deployment>/mcp --header "x-api-key: YOUR_KEY"

Cursor / any MCP client (mcp.json)

{

"mcpServers": { "newscatcher": { "type": "http", "url": "https:// /mcp", "headers": { "x-api-key": "YOUR_KEY" } } } }

Authorization: Bearer YOUR_KEY works as well. Clients that cannot send headers (claude.ai custom connectors) need ?apiKey=YOUR_KEY on the URL, which is off unless the deployment sets NEWSCATCHER_ALLOW_KEY_IN_URL=1 (keys in URLs end up in access logs). Signing in avoids both.

Options on the URL

  • ?tools=news (or news,research) exposes only those toolsets, to save context. Default: all.
  • ?client=cursor tags usage in the upstream User-Agent.
Claude Code plugin (tools + 53 skills)
/plugin marketplace add Newscatcher/newscatcher-mcp

/plugin install newscatcher@newscatcher

Claude Code asks for the NewsCatcher API key once and keeps it in the OS keychain; the plugin connects to https://mcp.newscatcherapi.com/mcp with it. The skills (plugin/skills/) cover briefings, adverse media, company monitoring, sales triggers, deal, funding and layoff trackers, share of voice, PR coverage, earnings, cyber incidents and more; each one tells the model which tools to call and how to present the result. They were tuned against an end-to-end eval (37 of the 39 critical-skill test prompts at 4+ of 5 with Claude Haiku 5.5).

Tools

ToolsetToolWhat it doesCost
newssearch_newsRanked, story-grouped search over the last 30 days, any language1 / 5 / 10 credits (effort)
newslist_articlesEvery article matching a boolean query, 12 months, exact total; tally by outlet/author/country/language5 per call
newscount_articlesDaily/weekly/monthly counts for 1–5 queries, share of voice5 per bucket × query (max 60)
newsget_storyAll coverage of one story: newsrooms, earliest articles1
newsget_accountPlan, balance, limitsfree
researchstart_researchResearch agent run: events dataset or company news; dry_run estimates cost freeper run
researchget_researchWait for a run and show its table; list runsfree
researchcancel_researchStop a run (not charged)free
listssave_company_list / get_company_list / edit_company_listReusable company listsfree
monitorscreate_monitor / get_monitor / get_monitor_updates / update_monitorScheduled updates, only what is newper run / per company

Also: two guide resources (newscatcher://guides/query-syntax, newscatcher://guides/research-agent) and three prompts (news_briefing, company_watch, event_dataset).

Not in the hosted server: the local-file features of the original (export_research, save_as, csv_path). The instructions tell models so; some skills mention them for local setups.

get_research also takes exclude_rows (leave out rows after checking; counts cover the kept rows) and sort (newest, oldest, importance).

Example

A raw MCP call (after initialize), e.g. with curl:

curl -X POST https://<deployment>/mcp \

-H "x-api-key: YOUR_KEY" -H "content-type: application/json" \ -H "accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_news","arguments":{"query":"Nvidia guidance","window":"2d","effort":"low"}}}'

Configuration

VariableDefaultPurpose
NEWSCATCHER_MAX_CALL_SECONDS240Longest one tool call works (waiting for a run, paging, counting) before answering with what it has. Keep below Vercel maxDuration (300 in vercel.json).
NEWSCATCHER_ALLOW_KEY_IN_URLoff1 accepts ?apiKey= on the MCP URL.
NEWSCATCHER_TOOLSETSallDefault toolsets when the URL has no ?tools=.
NEWSCATCHER_NEWS_API_URLapi.newscatcherapi.comNews API host only (no https://, no path).
NEWSCATCHER_NEWS_API_PORT– (443)News API port.
NEWSCATCHER_NEWS_API_ENDPOINTnews-apiNews API base path.
NEWSCATCHER_AGENT_API_URLapi.newscatcherapi.comAgent API host only.
NEWSCATCHER_AGENT_API_PORT– (443)Agent API port.
NEWSCATCHER_AGENT_API_ENDPOINTagentAgent API base path.
NEWSCATCHER_TIMEOUT_MS90000Timeout per upstream request.
NEWSCATCHER_INTEGRATION–Default User-Agent tag.
LOG_LEVELINFOJSON logs (Stackdriver shape).
POSTHOG_PROJECT_API_KEY–Enables PostHog MCP analytics (write-only phc_… key).
POSTHOG_ENABLEDtruefalse turns PostHog off completely, even with the key (e.g. on dev).
POSTHOG_APP / POSTHOG_ENVIRONMENTnewscatcher-mcp / Vercel's VERCEL_TARGET_ENV, else localSent as app and environment on every event, so one PostHog project can hold several apps and environments.
POSTHOG_HOST / POSTHOG_PORTus.i.posthog.com / 443PostHog ingestion host (region) and port.
POSTHOG_IDENTITY_SALT–Secret for pseudonymous caller ids (HMAC of the key). Without it callers stay anonymous.
NEWSCATCHER_API_KEY–Local stdio only. Never used for HTTP requests. Do not set it on Vercel.

URLs are split into host / port / endpoint; the scheme is always https and defaults point at the PROD APIs. The only secrets are the two optional PostHog values.

Sign-in with a platform account (OAuth 2.1; all of these or none, otherwise the server logs why and runs with API keys only):

VariableDefaultWhat
NEWSCATCHER_OAUTHoff1 turns sign-in on.
NEWSCATCHER_PUBLIC_URL–This deployment's own origin, e.g. https://mcp.example.com (no path; a trailing / or /mcp is dropped). Goes verbatim into the discovery documents, so set it per Vercel environment: preview and production each name themselves.
NEWSCATCHER_SUPABASE_URL–Host of the auth project users sign in to the platform with ( .supabase.co). No default on purpose.
NEWSCATCHER_PLATFORM_API_URL / _PORT / _ENDPOINTplatform-api.newscatcherapi.comPlatform API that turns a signed-in user into their workspace key.

The auth project needs its OAuth 2.1 server and dynamic client registration enabled, with the authorization (consent) path pointing at the platform app. How it works: src/oauth.py.

Deploy (Vercel)

Vercel's Python runtime serves the module-level app in server.py; vercel.json gives the function 300 s. Push to the connected branch, or vercel deploy. Check https:// /health → {"ok": true, "version": …}.

Set the variables in Vercel → Project → Settings → Environment Variables, per environment:

Vercel environmentAPI it talks toWhat to set
ProductionPRODnothing for the APIs (defaults), PostHog values if wanted
Preview (branches / PRs)DEVNEWSCATCHER_NEWS_API_URL/PORT/ENDPOINT and NEWSCATCHER_AGENT_API_URL/PORT/ENDPOINT → DEV hosts

Never set NEWSCATCHER_API_KEY on Vercel: users bring their own keys.

Run locally

python -m venv .venv && .venv/Scripts/activate   # or source .venv/bin/activate

pip install -r requirements-test.txt

python server.py # stdio, key from NEWSCATCHER_API_KEY python server.py --http # HTTP on http://127.0.0.1:8000/mcp, key per request docker compose up --build # same, in Docker, on http://localhost:8000/mcp

Test

pytest -q                                         # unit + HTTP tests, upstream mocked, no key needed

NEWSCATCHER_API_KEY=… python scripts/smoke_test.py # live, read-only, ~6 credits

Layout

server.py                      Entrypoint: module-level `mcp` and `app` (Vercel), stdio / --http locally

src/ server.py build_server / create_app, instructions, toolset + input-error middleware auth.py Key per request, 401 middleware, ?tools= / ?client= oauth.py Sign-in: discovery, client registration, platform token → workspace key client.py HTTP client: retries, pacing, no retry of paid writes, error hints config.py, log.py Settings; structured JSON logging formatting.py, lenient.py Compact text output; lenient list/object input analytics.py Optional PostHog guides.py Guide resources and prompts tools/ news, research, lists, monitors (+ common registration, shared params) tests/ Tools, rendering, HTTP/auth, sign-in, analytics, skill lint

License

MIT