Skip to main content
Glama
Sign In
deenesjakoruzh
x-mcp

x-mcp

by RobertDWhite
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

x-mcp

MCP-Server vor der X (Twitter) API v2. Image: ghcr.io/robertdwhite/x-mcp. Manifeste in whitehouse-rke2 (apps/ai/x-mcp/).

Lesevorgänge sind kostenlos. Schreibvorgänge sind zweistufig — draft_post gibt eine Vorschau sowie ein einmaliges confirm_token zurück, und es wird nichts veröffentlicht, bis publish_post mit genau diesem Token aufgerufen wird. Ein Agent kann nicht mit einem einzigen Aufruf posten, daher existiert immer zuerst eine für Menschen sichtbare Vorschau. Das ist wichtig, wenn die Ausgabe öffentlich und dauerhaft ist.

Es gibt bewusst kein Lösch-Tool. Das Löschen ist destruktiv und unumkehrbar; entfernen Sie Beiträge in der X-App.

Tools

Tool

Art

Hinweise

whoami

read

Für welches Konto die Anmeldedaten stehen

get_tweet

read

Einen Beitrag per ID

get_user_posts

read

Letzte Beiträge eines Handles

get_mentions

read

Erwähnungen des authentifizierten Kontos

get_home_timeline

read

Home-Timeline in umgekehrter chronologischer Reihenfolge

search_recent

read

Suche der letzten 7 Tage (planabhängig)

draft_post

stage

Validiert + zeigt Vorschau. Veröffentlicht nichts.

list_drafts

read

Anstehende Entwürfe und ihre verbleibende TTL

publish_post

write

Veröffentlicht einen Entwurf. Öffentlich und dauerhaft.

Entwürfe liegen im Arbeitsspeicher: Ein Neustart löscht sie, sodass ein veraltetes confirm_token den Prozess, der die Vorschau angezeigt hat, nie überlebt.

Related MCP server: x-mcp

Endpunkte

  • POST /mcp — streamable-HTTP MCP, geschützt durch Authorization: Bearer $MCP_TOKEN

  • GET /healthz — offen, für Liveness/Readiness

Jeder andere Pfad gibt 404, nicht 401 zurück — einschließlich der /.well-known/oauth-*-Probe-Aufrufe, die MCP-Clients beim Start ausführen. Ein 401 dort veranlasst Clients, einen interaktiven OAuth-Flow zu versuchen, was Headless-Clients bis zu einem Verbindungs-Timeout hängen lässt.

Konfiguration

Env

Erforderlich

Zweck

MCP_TOKEN

empfohlen

Bearer für /mcp. Nicht gesetzt = unauthentifiziert.

X_API_KEY

ja

Consumer-Key

X_API_SECRET

ja

Consumer-Secret

X_ACCESS_TOKEN

ja

Access-Token (Benutzerkontext)

X_ACCESS_TOKEN_SECRET

ja

Access-Token-Secret

X_MAX_CHARS

nein

Längenlimit, Standard 280. Für Premium erhöhen.

X_DRAFT_TTL

nein

Lebensdauer von Entwürfen in Sekunden, Standard 600

X_TIMEOUT

nein

HTTP-Timeout, Standard 30

Die Authentifizierung gegenüber X erfolgt über den OAuth-1.0a-Benutzerkontext und wird pro Anfrage signiert. App-only-Bearer-Tokens können nicht posten, da beim Veröffentlichen als das Konto gehandelt wird. Die vier Werte erhalten Sie aus einer X-App mit der Berechtigung Read and Write: Consumer-Keys sowie ein für Ihr eigenes Konto generiertes Access-Token-/Secret-Paar.

Wenn die Anmeldedaten fehlen, gibt jedes Tool eine klare „not configured“-Fehlermeldung zurück statt eines Stack-Traces — so kann der Dienst bereitgestellt werden, bevor die Anmeldedaten existieren.

Hinweis zu X-API-Plänen

Der Schreibzugriff hängt von den kostenpflichtigen API-Stufen von X ab, und die kostenlose Stufe ist stark gedeckelt. Ein 429 von diesem Server macht den Rate-Limit-Reset sichtbar, wenn X ihn bereitstellt. Prüfen Sie Ihren Plan auf developer.x.com, wenn Schreibvorgänge sofort fehlschlagen.

Lokale Ausführung

pip install -r requirements.txt
MCP_TOKEN=dev X_API_KEY=... X_API_SECRET=... \
  X_ACCESS_TOKEN=... X_ACCESS_TOKEN_SECRET=... python server.py

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Resources

Related MCP Connectors

Related MCP Servers

  • TwitGhost

    arvinmoj
    A
    license
    B
    quality
    D
    maintenance
    Enables interacting with Twitter/X through natural language, including searching tweets, posting, sending DMs, and managing timelines via any MCP client.
    8
    MIT

  • x-mcp

    namank42
    F
    license
    A
    quality
    D
    maintenance
    Enables interaction with the X (Twitter) API through MCP tools for managing users, posts, bookmarks, likes, and lists. Supports markdown or JSON output and uses OAuth 2.0 PKCE authentication.
    22
    -

  • x-mcp-server

    lluisfont
    F
    license
    B
    quality
    B
    maintenance
    MCP server for the official X API, enabling agents to read and publish posts, look up users, and search posts with safe read-only default and explicit write mode.
    8
    3 npm
    -

  • x-mcp-ai

    IvanBBaev
    A
    license
    A
    quality
    A
    maintenance
    Enables MCP clients to interact with the X (Twitter) API v2 through 41 typed tools for reading, searching, engaging, publishing, and managing content, with policy-based access control and session credit budgets to prevent overspending.
    41
    74 npm
    1
    MIT