SociaVault MCP Server

Instructions

Implementation Reference

• src/index.ts:445-464 (handler)

  Executes the get_twitter_tweets tool by calling the Sociavault API endpoint /twitter/user-tweets with the handle, extracts tweets using helper, and returns JSON stringified response.

  if (name === "get_twitter_tweets") {
    const { handle } = args as { handle: string };
    const response = await axios.get(`${BASE_URL}/twitter/user-tweets`, {
      headers: { "X-API-Key": API_KEY },
      params: { handle },
    });
    const extracted = extractTwitterTweets(response.data, 10);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(
            { handle, tweets: extracted, total_returned: extracted.length },
            null,
            2
          ),
        },
      ],
    };
  }

• src/index.ts:278-288 (registration)

  Registers the get_twitter_tweets tool in the tools list with name, description, and input schema requiring 'handle'.

  {
    name: "get_twitter_tweets",
    description: "Get tweets from a Twitter/X user",
    inputSchema: {
      type: "object",
      properties: {
        handle: { type: "string", description: "Twitter username" },
      },
      required: ["handle"],
    },
  },

• src/index.ts:122-136 (helper)

  Helper function to extract and format up to 10 tweets from the API response data.

  function extractTwitterTweets(data: any, limit = 10) {
    const tweets = data?.data?.tweets || data?.tweets || data?.data || [];
    const tweetsArray = Array.isArray(tweets) ? tweets : tweets.timeline || [];
    return tweetsArray.slice(0, limit).map((tweet: any) => {
      return {
        id: tweet.id_str || tweet.id,
        text: tweet.full_text || tweet.text,
        created_at: tweet.created_at,
        retweets: tweet.retweet_count || 0,
        likes: tweet.favorite_count || tweet.like_count || 0,
        replies: tweet.reply_count || 0,
        is_retweet: tweet.retweeted || false,
      };
    });
  }