SociaVault MCP Server

Instructions

Implementation Reference

• src/index.ts:379-389 (handler)

  Executes the get_twitter_profile tool: calls Sociavault API /twitter/profile endpoint with the handle, extracts profile using helper, and returns JSON stringified content.

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

• src/index.ts:234-244 (registration)

  Registers the get_twitter_profile tool in the tools list with name, description, and input schema.

  {
    name: "get_twitter_profile",
    description: "Get Twitter/X profile data",
    inputSchema: {
      type: "object",
      properties: {
        handle: { type: "string", description: "Twitter username" },
      },
      required: ["handle"],
    },
  },

• src/index.ts:71-83 (helper)

  Helper function extracts and formats essential Twitter profile fields from the API response data.

  function extractTwitterProfile(data: any) {
    const user = data?.data?.user || data?.user || {};
    return {
      username: user.screen_name || user.username,
      name: user.name,
      description: user.description,
      followers: user.followers_count || 0,
      following: user.friends_count || 0,
      tweets: user.statuses_count || 0,
      verified: user.verified,
      profile_image: user.profile_image_url_https,
    };
  }