TickerDB MCP-Server

Name: TickerAPI
Author: tickerdb

MCP-Server (Model Context Protocol) für TickerDB — vorab berechnete Marktintelligenz für KI-Agenten.

Verbindet TickerDB mit jedem MCP-kompatiblen Client: Claude Desktop, Claude Code, Cursor, Windsurf, OpenClaw, LangChain, LlamaIndex, AutoGen, CrewAI und mehr.

Verfügbare Tools

Tool	Beschreibung
`get_summary`	Technische + fundamentale Zusammenfassung für ein einzelnes Ticker-Symbol (unterstützt Datumsbereichs- und Ereignisfilterung)
`get_watchlist`	Live-Daten für Ihre gespeicherten Watchlist-Ticker
`get_watchlist_changes`	Feld-basierte Diffs seit dem letzten Pipeline-Lauf
`add_to_watchlist`	Ticker zu Ihrer Watchlist hinzufügen
`remove_from_watchlist`	Ticker aus Ihrer Watchlist entfernen
`get_account`	Kontodetails, Tarifstufe und Nutzung
`create_webhook`	Webhook für Watchlist-Änderungen registrieren
`list_webhooks`	Registrierte Webhooks auflisten
`delete_webhook`	Einen Webhook entfernen

Verwenden Sie get_summary mit start/end-Parametern für Massen-Ticker-Synchronisierungen über einen Datumsbereich oder mit field/band-Parametern, um Ereignisvorkommen abzufragen.

Band-Stabilitäts-Metadaten

Die Tools für Zusammenfassungen, Watchlists und Watchlist-Änderungen geben Band-Stabilitäts-Metadaten zurück. Jedes Band-Feld (Trendrichtung, Momentum-Zone usw.) enthält ein zugehöriges _meta-Objekt, das beschreibt, wie stabil dieser Zustand ist. Das Stabilitäts-Label ist eines der folgenden: fresh, holding, established oder volatile. Die vollständigen Metadaten enthalten außerdem periods_in_current_state, flips_recent und flips_lookback. Dieser Kontext hilft Agenten dabei, zwischen einem neu eingetretenen Zustand und einem, der über viele Perioden hinweg Bestand hatte, zu unterscheiden, was die Qualität von Handelssignalen und Warnmeldungen verbessert.

Einrichtung

Option 1: Claude.ai (OAuth)

Der Remote-Server unter mcp.tickerdb.com unterstützt OAuth 2.1 für Claude.ai-Connectoren. Es ist keine API-Schlüsselverwaltung erforderlich – melden Sie sich mit Ihrem TickerDB-Konto an und Claude.ai erledigt den Rest.

Option 2: Remote-Server (Bearer-Token)

Verbinden Sie jeden beliebigen MCP-Client mit https://mcp.tickerdb.com/mcp unter Verwendung Ihres API-Schlüssels als Bearer-Token.

Option 3: npm-Paket (Claude Desktop, Cursor, etc.)

Fügen Sie dies zu Ihrer Claude Desktop-Konfiguration (claude_desktop_config.json) hinzu:

{
  "mcpServers": {
    "tickerdb": {
      "command": "npx",
      "args": ["tickerdb-mcp-server"],
      "env": {
        "TICKERDB_KEY": "tapi_your_api_key_here"
      }
    }
  }
}

Erhalten Sie einen API-Schlüssel unter tickerdb.com/dashboard.

Struktur

Dies ist ein Workspace mit drei Paketen:

shared/ — Gemeinsame Tool-Definitionen, API-Client und Server-Factory (intern, nicht veröffentlicht)
remote/ — Cloudflare Worker, bereitgestellt unter mcp.tickerdb.com (Streamable HTTP-Transport + OAuth 2.1)
local/ — Veröffentlichtes npm-Paket tickerdb-mcp-server (stdio-Transport)

Sowohl der Remote-Server als auch das npm-Paket verwenden dieselben Tool-Definitionen aus shared/. Der MCP-Server ist ein schlanker Proxy – die gesamte zugangsbasierte Zugriffskontrolle, Ratenbegrenzung und Feldfilterung wird von der TickerDB HTTP-API übernommen.

Authentifizierung

Der Remote-Server unterstützt zwei Authentifizierungsmethoden:

Bearer-Token — übergeben Sie Ihren tapi_* API-Schlüssel direkt als Authorization: Bearer tapi_...
OAuth 2.1 — wird von Claude.ai-Connectoren verwendet. Der Server implementiert dynamische Client-Registrierung, PKCE, Token-Austausch und Widerruf. Der /authorize-Endpunkt leitet zur Zustimmung auf die TickerDB-Hauptseite weiter.

Entwicklung

# Install dependencies
npm install

# Build the remote worker
npm run build

# Dev server for remote worker
npx wrangler dev

# Build the npm package
cd local && npm install && npm run build

Bereitstellung

Remote-Server:

npx wrangler deploy

npm-Paket:

cd local
npm version patch
npm run build
npm publish

TickerAPI