Connection check
verified live · 27h ago
influship-mcp
Find and analyze influencers with creator search, lookalikes, profiles, posts, and transcripts.
Tools
28
GitHub stars
1
Installs / wk
—
Licence
MIT
Transport
streamable-http, stdio
Last checked
27h ago
Tools & capabilities
28 toolsRead from the running server on 27h ago.
autocomplete_creators
read-only
q*limitscopeplatform
Autocomplete creator names, usernames, or display names from partial input. Use this for fast lookup when the user types a partial handle or name and you need to resolve it to can… Autocomplete creator names, usernames, or display names from partial input. Use this for fast lookup when the user types a partial handle or name and you need to resolve it to canonical creator IDs (e.g., "find @cris" or "who's that fitness coach called Jane?"). Cheap and fast — prefer over `search_creators` for handle-style queries where the user already knows roughly who they want. Use `get_profile` instead when the user gives an exact platform+username pair. Use `search_creators` for the same fuzzy creator lookup behavior with a less typeahead- specific name. Use `semantic_search_creators` only for discovery by topic, niche, audience, geography, or content style, not for resolving a known creator. Examples: - User: "Who is that fitness coach called Jane?" -> use this tool. - User: "Find @cris..." -> use this tool to resolve the partial handle. - User: "Pull @niickjackson on Instagram" -> use `get_profile`, not this tool. Returns a short list of matching creators with their IDs, platforms, and display names. Use the IDs returned here as input to `get_creator`, `find_lookalike_creators`, or `match_creators` for downstream operations.
find_lookalike_creators
read-only
limitcursorverifiedmax_followersmin_followersseed_profiles
+3
Find creators SIMILAR to one or more seed creators. Use this when the user already knows a creator they like and wants more like them (e.g., "find creators like @therock", "find m… Find creators SIMILAR to one or more seed creators. Use this when the user already knows a creator they like and wants more like them (e.g., "find creators like @therock", "find more creators like these three I just booked"). Seeds are blended via creator-profile + visual-style + fact embeddings to surface similar accounts. Seeds are passed in `seed_creator_ids` (canonical UUIDs) and/or `seed_profiles` (platform + username; resolve handles via `autocomplete_creators` first if needed). Returns a ranked list of similar creators with scores. `limit` caps results (default 25, max 100). Use the flat follower, engagement-rate, and verified fields to constrain results. A `seed_not_found` response means the supplied creator is not available for similarity matching; choose another seed instead of retrying it. Use `semantic_search_creators` instead when you have a topic/niche but no seed. Use `match_creators` when you have specific candidates and want to score their fit against a brief. Examples: - User: "Find creators like @niickjackson on Instagram" -> use this tool with `seed_profiles: [{ platform: "instagram", username: "niickjackson" }]`. - User: "Find news creators with 1M+ followers" -> use `semantic_search_creators`, not this tool.
get_creator
read-only
idincludeplatformusername
Fetch the full record for a single creator by ID or exact platform username. Use this when you already have either: - a canonical creator UUID returned by `search_creators`, `se… Fetch the full record for a single creator by ID or exact platform username. Use this when you already have either: - a canonical creator UUID returned by `search_creators`, `semantic_search_creators`, `autocomplete_creators`, or `find_lookalike_creators`; or - an exact platform+username pair such as platform "instagram" and username "niickjackson". Pass `include: ['profiles']` to also receive the creator's social profile summaries when using a creator UUID. For platform+username inputs, this tool resolves through the profile endpoint and returns the profile record plus the underlying creator record, so you already get the matched profile context. Examples: - User: "Get creator 123e4567-e89b-12d3-a456-426614174000" -> call with id. - User: "Get @niickjackson on Instagram" -> call with platform "instagram" and username "niickjackson", or use `get_profile` if profile metrics are the main need. - User: "Tell me about @niickjackson and include his profiles" -> use platform "instagram" and username "niickjackson"; then use `get_profile`/`get_posts` for platform-specific metrics and content if needed. Use `lookup_profiles` for batch exact profile lookups.
get_instagram_post
read-only
shortcode*
Fetch raw Instagram post-page data by shortcode. Use this when the user needs fresh raw Instagram post metadata that is not guaranteed on regular cached post-list endpoints yet, i… Fetch raw Instagram post-page data by shortcode. Use this when the user needs fresh raw Instagram post metadata that is not guaranteed on regular cached post-list endpoints yet, including coauthors, tagged users, paid partnership metadata, product mentions, music attribution, location, display resources, and video versions.
get_instagram_posts
read-only
shortcodes*
Fetch raw Instagram post-page data for a bounded list of shortcodes through the raw API. Transient upstream recovery is handled automatically within the request deadline. Returns… Fetch raw Instagram post-page data for a bounded list of shortcodes through the raw API. Transient upstream recovery is handled automatically within the request deadline. Returns one item per requested shortcode with per-item success or error details.
get_instagram_post_transcript
read-only
languageshortcode*
Transcribe an Instagram video post by shortcode through the raw API. The response includes raw post metadata on a transcript cache miss. A cache hit omits the post field; use `get… Transcribe an Instagram video post by shortcode through the raw API. The response includes raw post metadata on a transcript cache miss. A cache hit omits the post field; use `get_instagram_post` when you need post metadata with a cached transcript.
get_instagram_post_transcripts
read-only
languageshortcodes*
Transcribe a bounded list of Instagram video posts by shortcode through the raw API. Each successful item includes transcript data. The nested post field is present on cache misse… Transcribe a bounded list of Instagram video posts by shortcode through the raw API. Each successful item includes transcript data. The nested post field is present on cache misses and omitted on cache hits; use `get_instagram_posts` when you also need post metadata for every shortcode.
get_posts
read-only
sortlimitcursorplatformusernamecreator_id
Fetch a creator's posts, sorted and paginated. Use this when the user asks to see what a creator has posted (e.g., "show me Jane's last 20 posts", "what are this creator's top-eng… Fetch a creator's posts, sorted and paginated. Use this when the user asks to see what a creator has posted (e.g., "show me Jane's last 20 posts", "what are this creator's top-engagement reels?", "pull recent posts from creator-id ABC"). Identify the creator by either `creator_id` (UUID) OR (`platform` + `username`). `sort` defaults to "recent" (newest first); use "top_engagement" for the highest- engagement posts, or one of "most_likes" / "most_views" / "most_comments" for a specific metric. `limit` defaults to 12 and is capped at 50. Pass `cursor` from a previous response's `next_cursor` to paginate. Returns post records (caption, media URL, like/comment/view counts, timestamps), plus `has_more` and `next_cursor` for pagination. Examples: - User: "Show @niickjackson's recent Instagram posts" -> use this tool with platform "instagram" and username "niickjackson". - User: "Is @niickjackson a fit for Pixel?" -> use this after `get_profile` when the fit analysis needs recent content evidence, then call `match_creators`.
get_profile
read-only
platform*username*
Fetch a single social profile by (platform, username). Always use this first when the user gives an exact handle on a specific platform (for example "@niickjackson on Instagram")… Fetch a single social profile by (platform, username). Always use this first when the user gives an exact handle on a specific platform (for example "@niickjackson on Instagram") and you need the full profile: bio, follower/engagement metrics, recent activity, growth, and the canonical creator ID. Pass exactly the username they typed without the @ sign — case-insensitive matching is handled server-side. Do not use `search_creators` for an exact platform+username lookup. Examples: - User: "Pull @niickjackson on Instagram" -> use this tool with platform "instagram" and username "niickjackson". - User: "Tell me about instagram.com/niickjackson" -> parse the platform and username, then use this tool. - User: "Is @niickjackson a fit for Pixel?" -> use this tool first, then call `get_posts` and/or `match_creators` if the task needs content or fit analysis. Returns the profile record plus the underlying creator record. If you already have a creator UUID, use `get_creator` instead. For batch lookups by handle, use `lookup_profiles`.
get_sample_creator
read-only
Use this when a user wants to see what Influship can return before linking an account. Fetches one configured sample creator with social profile context. This is a preview tool an… Use this when a user wants to see what Influship can return before linking an account. Fetches one configured sample creator with social profile context. This is a preview tool and should not be used for search, discovery, matching, or comparison requests. After showing the preview, explain only that live creator discovery and comparison require connecting an existing Influship account. Do not discuss plans, pricing, credits, upgrades, or purchasing.
get_tiktok_profile
read-only
username*
Fetch a current, normalized TikTok profile by username. Returns identity, biography, verification, and audience metrics. A leading @ is accepted and usernames are normalized. This… Fetch a current, normalized TikTok profile by username. Returns identity, biography, verification, and audience metrics. A leading @ is accepted and usernames are normalized. This is a metered live-data request.
get_tiktok_video
read-only
url*region
Fetch normalized details and current engagement metrics for a TikTok video URL. Canonical video URLs and TikTok share URLs are accepted. Returned media URLs are temporary; the man… Fetch normalized details and current engagement metrics for a TikTok video URL. Canonical video URLs and TikTok share URLs are accepted. Returned media URLs are temporary; the managed dataset captures eligible video media asynchronously. Content always resolves against the US region. This is a metered live-data request.
get_tiktok_video_transcript
read-only
url*
Fetch or generate a normalized TikTok video transcript. Returns plain text and timestamped segments. Canonical transcripts are reused on later requests because transcript content… Fetch or generate a normalized TikTok video transcript. Returns plain text and timestamped segments. Canonical transcripts are reused on later requests because transcript content does not expire. This is a metered request and may take longer when transcription must be generated.
get_youtube_channel
read-only
channel*video_limitinclude_videos
Fetch a current YouTube channel by handle, channel ID, or URL. Optionally includes recent videos. This is a metered live-data request. Fetch a current YouTube channel by handle, channel ID, or URL. Optionally includes recent videos. This is a metered live-data request.
get_youtube_channel_transcripts
read-only
channel*sort_bylanguagevideo_limitinclude_segments
Fetch transcripts for a selected batch of videos from a YouTube channel. Choose the video count, ordering, language, and whether timestamped segments are included. This is a meter… Fetch transcripts for a selected batch of videos from a YouTube channel. Choose the video count, ordering, language, and whether timestamped segments are included. This is a metered batch request.
get_youtube_typeahead
read-only
q*country_codelanguage_code
Fetch current localized YouTube query suggestions for a partial phrase. Useful for expanding topic seeds before search. This is a metered live-data request. Fetch current localized YouTube query suggestions for a partial phrase. Useful for expanding topic seeds before search. This is a metered live-data request.
get_youtube_video
read-only
video_id*
Fetch fresh metadata and engagement for a YouTube video ID. Returns exact publication data when available, plus views, likes, comments, duration, tags, categories, and channel ide… Fetch fresh metadata and engagement for a YouTube video ID. Returns exact publication data when available, plus views, likes, comments, duration, tags, categories, and channel identity. This is a metered live-data request.
get_youtube_video_transcript
read-only
languagevideo_id*
Fetch a normalized transcript for a YouTube video ID. Returns plain text, timestamped segments, and available caption languages. This is a metered request and may take longer when… Fetch a normalized transcript for a YouTube video ID. Returns plain text, timestamped segments, and available caption languages. This is a metered request and may take longer when captions must be resolved.
list_tiktok_profile_videos
read-only
cursorregionsort_byusername*
Fetch one cursor-paginated page of current TikTok videos for a username. Use the returned cursor to paginate and choose latest or popular ordering. Media URLs are temporary, while… Fetch one cursor-paginated page of current TikTok videos for a username. Use the returned cursor to paginate and choose latest or popular ordering. Media URLs are temporary, while successful responses are eligible for canonical dataset piggybacking. Content always resolves against the US region. This is a metered live-data request.
list_tiktok_video_comments
read-only
url*cursor
Fetch one cursor-paginated page of current comments for a TikTok video URL. Pass the returned cursor to retrieve the next page. This is a metered live-data request. Fetch one cursor-paginated page of current comments for a TikTok video URL. Pass the returned cursor to retrieve the next page. This is a metered live-data request.
lookup_profiles
read-only
profiles*
Batch-fetch up to 100 profiles by (platform, username) pairs. Use this when the user has a list of handles and you need profile data for all of them at once (e.g., "give me follow… Batch-fetch up to 100 profiles by (platform, username) pairs. Use this when the user has a list of handles and you need profile data for all of them at once (e.g., "give me follower counts for these 30 accounts I'm considering" or "which of @a @b @c are real accounts?"). One round-trip beats 30 calls to `get_profile`. Use this for exact batch handle lookup, not semantic discovery. For one exact platform+username pair, use `get_profile`. For partial or fuzzy handle/name input, use `search_creators` or `autocomplete_creators`. Use `semantic_search_creators` only for topical/niche/audience discovery where false-positive semantic matches are acceptable. Examples: - User: "Compare @a, @b, and @c on Instagram" -> use this tool for the exact handle batch. - User: "Give me follower counts for these 30 accounts" -> use this tool. - User: "Find wellness creators in Austin" -> use `semantic_search_creators`, not this tool. The response splits results into `data` (profiles found) and `not_found` (the (platform, username) pairs that weren't recognized). Profiles are returned in no particular order — re-correlate via the platform/username fields if you need to preserve input order.
match_creators
read-only
profilescreator_idsintent_query*intent_context
Score how well specific creators fit a campaign brief or search intent. Use this when the user already has candidate creators in mind and wants to evaluate fit (e.g., "rate these… Score how well specific creators fit a campaign brief or search intent. Use this when the user already has candidate creators in mind and wants to evaluate fit (e.g., "rate these 5 creators for a vegan cookbook launch", "which of these is the best match for my crypto audience?"). For each creator the API returns a match score (0-1), a good/neutral/avoid decision, and structured reasons. Pass candidates in `creator_ids` (canonical UUIDs) and/or `profiles` (platform + username). `intent_query` is the brief the LLM reasons against; `intent_context` is optional extra context (target audience, brand values, prior collabs). Use `semantic_search_creators` when you don't have candidates yet and need topical or niche discovery. Use `search_creators` first when you only need to resolve rough creator names/handles into candidates. Use `find_lookalike_creators` when you want creators similar to known good fits. Examples: - User: "Is @niickjackson a fit for Pixel?" -> use this tool after resolving the exact Instagram profile with `get_profile`; call `get_posts` first if recent content context is needed. - User: "Rate these five creators for a vegan cookbook launch" -> use this tool.
render_creator_comparison
contextcreator_ids*campaign_brief*
Use this when the user has 2–4 canonical creator IDs and a specific campaign brief. It fetches current creator details, scores each creator against the brief, and renders a side-by… Use this when the user has 2–4 canonical creator IDs and a specific campaign brief. It fetches current creator details, scores each creator against the brief, and renders a side-by-side comparison. This may consume Influship account or API usage.
render_creator_profile
creator_id*
Use this when the user wants a visual deep dive on one canonical creator ID. It fetches the current creator record plus up to six recent posts and may consume Influship account or… Use this when the user wants a visual deep dive on one canonical creator ID. It fetches the current creator record plus up to six recent posts and may consume Influship account or API usage.
render_creator_shortlist
brieftitlesearch_idcreator_ids
Use this when discovery or lookup tools have returned results and the user would benefit from scanning 1–8 creator cards. Pass search_id after semantic_search_creators so the exact… Use this when discovery or lookup tools have returned results and the user would benefit from scanning 1–8 creator cards. Pass search_id after semantic_search_creators so the exact ranking, confidence, and evidence are preserved. Pass creator_ids only for name/handle lookup results. Always call an Influship data tool first; do not invent IDs. This fetches stored creator details and may consume Influship account or API usage.
search_creators
read-only
limitquery*scopeplatformverifiedplatforms
+6
Find a creator by name/handle, while preserving legacy semantic creator search. Use this as the default creator lookup tool when the user gives a creator-ish string but not a cano… Find a creator by name/handle, while preserving legacy semantic creator search. Use this as the default creator lookup tool when the user gives a creator-ish string but not a canonical creator UUID: a handle, partial handle, display name, creator name, or profile-ish text. This is cheap, fast, and backed by the creator lookup index. If the user gives an exact handle on a specific platform (for example "@niickjackson on Instagram"), prefer `get_profile` first because it returns the full platform profile. If you need to resolve a rough creator name or partial handle first, use this tool with `query_type: "creator_lookup"`. For backward compatibility, this tool still accepts the old semantic-search fields (`platforms`, follower/engagement filters, `creator_kinds`) and routes legacy calls to the semantic endpoint unless the query clearly contains a handle/profile URL. For new topical/niche discovery calls such as "fitness creators in NYC" or "vegan recipe creators with high engagement", prefer `semantic_search_creators` because its name is explicit and less likely to be confused with exact creator lookup. Examples: - User: "Find @cris" -> use this tool with query "cris" and query_type "creator_lookup". - User: "Who is that fitness coach called Jane?" -> use this tool with query "Jane" and query_type "creator_lookup". - User: "Pull @niickjackson on Instagram" -> use `get_profile` with platform "instagram" and username "niickjackson". - User: "Find news creators with 1M+ followers" -> use `semantic_search_creators`, not this tool. Returns either autocomplete-style creator lookup results or legacy semantic results, depending on routing. Use returned creator IDs with `get_creator`, `find_lookalike_creators`, or `match_creators`; use returned platform usernames with `get_profile` or `get_posts`.
search_youtube
read-only
q*limitcursorsort_bydurationupload_date
+3
Search current YouTube results with discovery filters and cursor pagination. Filter by upload window, popularity, result type, duration, country, and language. Pass next_cursor ba… Search current YouTube results with discovery filters and cursor pagination. Filter by upload window, popularity, result type, duration, country, and language. Pass next_cursor back as cursor for the next page. Each page is one metered request.
semantic_search_creators
read-only
limitquery*verifiedplatformscreator_kindsmax_followers
+3