Serveur MCP

Connectez Claude, ChatGPT, Cursor et d'autres agents IA à TwexAPI via le Model Context Protocol. Connectez-vous avec votre compte TwexAPI ou utilisez une clé API.

TwexAPI exploite un serveur Model Context Protocol à l’adresse https://api.twexapi.io/mcp. Les assistants IA et les agents de code peuvent l’utiliser pour rechercher des tweets, lire des profils, des abonnés, des réponses, des threads, des communautés, des listes et des tendances. Chaque appel consomme vos crédits TwexAPI, comme une requête REST.

Cette page concerne le serveur MCP de l’API. Pour qu’un agent recherche plutôt dans la documentation TwexAPI, utilisez le serveur Docs MCP à l’adresse https://docs.twexapi.io/mcp, qui ne demande aucune connexion.

Démarrage rapide

Étapes propres à chaque client :

Authentification

Le serveur accepte deux types d’identifiants :

Créez ou copiez votre clé API dans le tableau de bord TwexAPI. ChatGPT ne peut pas envoyer d’en-têtes personnalisés : il utilise donc toujours la connexion.

Ce que la connexion autorise

• L’application reçoit un jeton qui ne fonctionne que sur https://api.twexapi.io/mcp. Elle ne voit jamais votre mot de passe ni votre clé API, et ne peut ni modifier votre compte ni lire votre tableau de bord.
• Les appels sont facturés sur les crédits de votre compte, exactement comme les appels effectués avec votre clé API.
• L’accès en lecture est toujours accordé. L’accès en écriture (publier des tweets et des réponses via twexapi_write) est une case à cocher sur la page de consentement ; décochez-la pour vous connecter en lecture seule.
• Les jetons d’accès durent une heure et les clients les renouvellent automatiquement. Une autorisation qu’aucune application n’utilise pendant 30 jours expire.
• Chaque fois que vous connectez un client, une nouvelle entrée apparaît sous Authorized apps (applications autorisées) dans le tableau de bord. Sélectionnez Revoke pour couper immédiatement l’accès d’une application. Supprimer un connecteur dans le client ne le révoque pas de notre côté.

Avant d’approuver

• Votre compte doit avoir une clé API active avec des crédits restants. Sans crédits, la page de consentement vous demande d’abord de recharger. La demande reste valide 10 minutes : vous pouvez donc recharger puis sélectionner à nouveau Approve.
• Vérifiez la ligne After you approve, you will return to. Elle doit indiquer l’application que vous utilisez, par exemple claude.ai, chatgpt.com ou une adresse 127.0.0.1 pour les applications de bureau.

Découverte

Les clients MCP trouvent tout ce dont ils ont besoin auprès du serveur lui-même :

Une requête sans identifiants renvoie 401 avec un challenge WWW-Authenticate: Bearer qui indique l’URL des métadonnées de la ressource protégée. C’est ce challenge qui indique au client qu’il doit lancer la connexion. Consultez OAuth pour les clients MCP pour le flux complet.

Outils

Les clients comme Claude demandent une confirmation avant chaque appel à twexapi_write. Les autres actions d’écriture, comme les likes, les abonnements et les messages privés, ne sont disponibles que via l’API REST. Consultez la référence des outils MCP pour les entrées, les sorties et le catalogue complet.

Crédits et erreurs

Indiquez l’en-tête de réponse X-Request-Id et l’heure UTC lorsque vous signalez un problème de connexion.

Paiement à l’appel sans compte

Les clients MCP qui paient avec le Machine Payments Protocol au lieu d’une clé API se connectent à https://api.twexapi.io/mcp/pay. Cet endpoint accepte les requêtes anonymes et répond aux appels d’outils éligibles par un challenge de paiement. L’endpoint principal /mcp exige toujours une connexion ou une clé API.

Claude.ai et Claude Desktop

Claude.ai et Claude Desktop partagent les mêmes connecteurs : vous n’ajoutez TwexAPI qu’une seule fois.

Sur les offres Team et Enterprise, un owner devra peut-être d’abord autoriser les connecteurs personnalisés.

Frameworks d’agents

Les runtimes d’agents et les scripts envoient généralement une clé API. Par exemple, avec l’OpenAI Agents SDK :

from agents.mcp import MCPServerStreamableHttp

async with MCPServerStreamableHttp(
    params={
        "url": "https://api.twexapi.io/mcp",
        "headers": {"x-api-key": "YOUR_API_KEY"},
    },
) as twexapi:
    # use TwexAPI as a tool provider
    pass

Chargez la clé depuis une variable d’environnement ou un gestionnaire de secrets plutôt que de l’écrire en dur dans le code.

MCP ou API REST

Serveur MCP

Idéal pour les assistants IA, les agents dans l’IDE et les workflows en langage naturel. L’agent trouve les endpoints avec explore et les appelle avec twexapi_request ou twexapi_write.

API REST

Idéale pour les services backend, les tâches planifiées et les intégrations directes. Appelez https://api.twexapi.io/* avec Authorization: Bearer YOUR_API_KEY. Utilisez la référence de l’API lorsque vous avez besoin de tous les endpoints, d’une pagination fine ou de code SDK.

Utilisez MCP lorsque vous voulez qu’un agent travaille avec les données X/Twitter en langage naturel. Utilisez REST lorsque vous construisez un backend de production ou stockez de grands volumes de résultats.

Exemples de prompts

Une fois connecté, vous pouvez demander à votre agent IA par exemple :

Recherche et consultation

• Recherche les posts X récents sur AI agents des dernières 24 heures. Renvoie les 20 meilleurs tweets avec l’ID du tweet, l’auteur, la date de création, les likes, les reposts et un résumé d’une ligne.
• Trouve les tweets récents de @elonmusk qui mentionnent Grok ou AI. Regroupe les résultats par sujet et inclus les liens directs vers X.
• Lis ce tweet : https://x.com/elonmusk/status/2104354931595423762. Résume le post, puis récupère les réponses les plus pertinentes avec leurs IDs.
• Récupère les tweets similaires au tweet d’ID 2104354931595423762 et explique pourquoi chaque résultat est lié.

Profils et abonnements

• Lis la bio du profil @openai et renvoie le nom d’utilisateur, le nom affiché, l’ID utilisateur, la localisation, le nombre d’abonnés et l’URL du profil.
• Recherche des utilisateurs X sur AI infrastructure. Renvoie 25 comptes avec le nom d’utilisateur, la bio, le nombre d’abonnés et la raison de la correspondance.
• Récupère les derniers abonnés de @elonmusk, puis identifie les comptes qui mentionnent l’IA, les startups ou la crypto dans leur bio.
• Récupère une page d’abonnés de @sama paginée par curseur, renvoie les 20 premiers utilisateurs et conserve le next_cursor pour la prochaine exécution.

Tendances

• Affiche tous les pays de tendances mondiales disponibles, puis récupère les principaux sujets tendance pour united-states.
• Récupère les tweets tendance pour united-states avec le sujet technology et le tag de contenu AI. Renvoie les IDs des tweets, les auteurs et les métriques d’engagement.
• Compare les sujets tendance de united-states, japan et united-kingdom et résume les différences par région.

Réponses, citations et threads

• Récupère les réponses à https://x.com/elonmusk/status/2104354931595423762, trie-les par pertinence et renvoie l’ID de la réponse, l’auteur, le texte et le nombre de likes.
• Liste 50 utilisateurs qui ont retweeté le tweet d’ID 2104354931595423762. Renvoie l’ID utilisateur, le nom d’utilisateur, le nom affiché et le nombre d’abonnés si disponible.
• Récupère les tweets qui citent le tweet d’ID 2104354931595423762, puis classe-les en favorables, critiques ou neutres.
• Extrais le thread complet du tweet d’ID 2104354931595423762 et transforme-le en plan Markdown.

Articles, communautés et listes

• Récupère l’article X 2104354931595423762 en Markdown et transforme-le en synthèse de 5 points pour la direction.
• Recherche des communautés X sur AI builders. Renvoie l’ID de la communauté, le nom, le nombre de membres et la description.
• Recherche des listes sur AI founders. Renvoie les 10 meilleures listes avec l’ID, le nom, la description et le nombre de membres.

Guides des frameworks

Créez des agents avec les outils MCP de TwexAPI dans votre framework préféré :

Skill pour agents IA

La skill TwexAPI donne aux agents de code une connaissance approfondie de l’API TwexAPI sans nécessiter de connexion MCP. Installez-la pour que votre agent écrive des intégrations d’API, configure des connexions MCP et applique les bonnes pratiques TwexAPI.

npx skills add twexapi-dev/x-api-scraper-cli