MCP araç referansı

Uç nokta keşfi, kimlik doğrulamalı API çağrıları, iş akışı devri ve güvenli agent yürütmesi için Twexapi MCP araçları.

Twexapi API MCP sunucusu 2 araç sunar: explore ve twexapi_request. x-api-key veya OAuth 2.1 Bearer kimlik doğrulamasıyla https://api.twexapi.io/mcp adresine bağlanın.

Agent’lar twexapi_request çağırmadan önce API kataloğunu incelemek için explore kullanmalıdır. Bu, uç nokta seçimini açık tutar, agent’ın istek şemalarını korumasına yardımcı olur ve MCP üzerinden kullanılamayan yollara yanlışlıkla çağrı yapılmasını önler.

Araçlar

explore

API uç nokta kataloğunda arama yapın. Salt okunur, X/Twitter ağ çağrısı yok ve uç nokta kredisi tüketilmez. Çağrı yine de API anahtarı veya OAuth Bearer token ile MCP kimlik doğrulaması gerektirir.

Mevcut uç noktaları keşfetmek, parametreleri kontrol etmek, kategorileri karşılaştırmak ve çağrı yürütmeden doğru API yolunu bulmak için explore kullanın.

Girdi

Katalog şekli

interface EndpointInfo {
  name: string;
  method: string;
  path: string;
  category: string;
  description: string;
  read_only: boolean;
  parameters_schema?: Record<string, unknown>;
  example?: {
    method: string;
    path: string;
    query?: Record<string, unknown>;
    body?: unknown;
  };
}

Örnekler

Trend uç noktalarını bulun:

{
  "category": "trending"
}

Anahtar kelimeyle arayın:

{
  "query": "advanced search tweets"
}

Yazma yeteneği olan uç noktaları dahil edin:

{
  "query": "create tweet",
  "include_writes": true
}

twexapi_request

Twexapi hesabınıza karşı API çağrıları yürütün. Kimlik doğrulama MCP isteğinden otomatik enjekte edilir; agent yalnızca uç nokta yöntemi, göreli yol ve isteğe bağlı sorgu/gövde verisini iletir.

Girdi

Yanıt sözleşmesi

twexapi_request MCP yürütme meta verilerini ve altta yatan REST yanıtını döndürür:

{
  "status_code": 200,
  "endpoint": "list_global_trending_countries",
  "method": "GET",
  "path": "/twitter/global-trending/countries",
  "result": {
    "code": 200,
    "msg": "success",
    "data": []
  }
}

result içinden ID’ler, imleçler, görev ID’leri, kredi alanları ve yazma işlemi ID’leri gibi kalıcı alanları koruyun. Bir sayfada has_more ve next_cursor varsa imleci explore tarafından döndürülen belgelenmiş takip uç noktasına veya sorgu parametresine iletin.

İş akışı örnekleri

Bu örnekler agent’ın üretmesi gereken şekli gösterir. Gerçek kullanımda agent’ın güncel şemayı doğrulayabilmesi için önce explore çalıştırın.

Devir satırlarıyla tweet arama

{
  "method": "POST",
  "path": "/twitter/advanced_search/page",
  "body": {
    "searchTerms": ["from:openai AI agents"],
    "maxItems": 20,
    "sortBy": "Latest"
  }
}

Agent’dan kompakt bir devir nesnesi döndürmesini isteyin:

{
  "source": "twexapi_mcp",
  "job": "tweet_search",
  "route_used": "/twitter/advanced_search/page",
  "query": "from:openai AI agents",
  "rows": [
    {
      "tweet_id": "1803006263529541838",
      "text": "...",
      "author_username": "openai",
      "created_at": "..."
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Trend tweet’leri getirme

{
  "method": "GET",
  "path": "/twitter/global-trending/tweets",
  "query": {
    "country": "united-states",
    "topic": "technology",
    "content": "AI",
    "count": 20
  }
}

Varsa country, topic, content, tweet ID’leri, yazar kullanıcı adları, etkileşim alanları, has_more ve next_cursor değerlerini saklayın.

Takipçileri CRM’e aktarma

{
  "method": "GET",
  "path": "/twitter/followers/openai/50"
}

user_id, username, name, description, followers_count, kaynak hesabı ve sayfalama/görev alanlarını saklayın. Uç nokta görev ID döndürürse saklayın ve belgelenmiş durum/sonraki uç noktayı yoklayın.

X makalesini Markdown olarak okuma

{
  "method": "GET",
  "path": "/x/article/1803006263529541838/markdown"
}

Makale ID’si, başlık, yazar, Markdown gövdesi, çıkarılan bağlantılar ve kaynak URL’yi saklayın.

Tweet veya yanıt gönderme

{
  "method": "POST",
  "path": "/twitter/tweets/create",
  "body": {
    "tweet_content": "Hello from Twexapi MCP",
    "reply_tweet_id": null,
    "media_url": null
  }
}

tweet_id, write_action_id, status, charged_credits, yanıt hedefi, medya URL’leri ve kullanıcı onay kaydını saklayın.

Agent devir desenleri

MCP JSON döndürür. Agent kuyrukları, CRM’ler, elektronik tablolar, veri ambarları ve no-code iş akışları için orijinal iş, kullanılan rota, saklanacak normalize satırlar veya ID’ler ile sonraki imleç veya yoklanacak görevi içeren küçük kalıcı bir nesne döndürün.

Tweet aramadan JSON’a

POST /twitter/advanced_search/page çağırın. Tweet ID’leri, metin, yazar meta verisi, oluşturulma zamanı, bağlantılar, has_more, next_cursor ve orijinal sorguyu saklayın.

Yanıtları kazıma

Sınırlı sayfa için GET /twitter/tweets/{tweet_id}/replies/{count} veya imleç tabanlı sayfalama için GET /twitter/tweets/{tweet_id}/replies/page çağırın. Yanıt ID’leri, yazar kullanıcı adları, metin, metrikler, has_more ve next_cursor saklayın.

Takipçileri dışa aktarma

explore tarafından döndürülen sayfa/görev uç noktaları veya GET /twitter/followers/{screen_name}/{count} çağırın. Kullanıcı ID’leri, kullanıcı adları, adlar, biyolar, takipçi sayıları, kaynak hesap, görev ID ve sonraki imleci saklayın.

Yazma işlemlerini izleme

Yazma uç noktaları için uç nokta yolunu, gövde hash’ini veya onay metnini, dönen tweet ID veya yazma işlemi ID’sini, durumu, ücretlendirilen kredileri ve medya referanslarını saklayın.

DM gönderme

DM uç noktasını yalnızca kullanıcı onayından sonra çağırın. Mesaj ID, alıcı kullanıcı ID, hesap, medya referansları ve teslim durumunu saklayın. Tam DM gövdelerini paylaşılan MCP çıktılarından çıkarın.

Uç nokta kategorileri

Hata yönetimi

MCP kimlik doğrulaması başarısız olursa araç çalışmaz. İstemci JSON-RPC hatası alır:

{
  "jsonrpc": "2.0",
  "error": {
    "code": 401,
    "message": "Missing MCP API token"
  }
}

twexapi_request çalışır ve altta yatan Twexapi API 2xx dışı yanıt döndürürse MCP meta verilerini ve Twexapi hatasını koruyun:

{
  "status_code": 403,
  "endpoint": "get_global_trending_tweets",
  "method": "GET",
  "path": "/twitter/global-trending/tweets",
  "result": {
    "detail": "Credits exhausted or action not allowed."
  }
}

REST ve MCP kurtarma desenleri için Error Handling ve Rate Limits sayfalarına bakın.