MCP Server

Connect an AI client to Influship to find Instagram creators, review campaign evidence, and research live Instagram, TikTok, and YouTube content. Every client uses the same server URL:

https://mcp.influship.com

Add it as a remote MCP server or custom connector, then sign in when your client asks. You choose which Influship account the client uses during sign-in, so you never copy an API key into a config file.

Before you start	Details
URL	`https://mcp.influship.com` (Streamable HTTP)
Auth	Sign in with your Influship account. API keys are supported for headless setups
Billing	Chosen at sign-in: pay-as-you-go API credits, or the credits in your Influship app plan
Limits	Your account’s rate limits apply; inspect `tools/list` for each tool’s schema

When your client opens the Influship sign-in page, pick the account its research should be billed to:

Account	Best for	Billing
Influship API (recommended)	Anyone connecting an AI client, with or without an Influship plan	Pay as you go at $0.01 per credit. New API accounts get 500 starter credits
Influship app	Existing Influship app subscribers	Uses the credits included in your monthly plan. Needs an active plan or trial on a workspace you own

New to Influship? Either option lets you create an account during sign-in. New accounts go through the usual setup first (billing details for an API account, workspace setup for the app) and then return to finish connecting. If you are already signed in to the wrong account in this browser, select Use a different account on the connection screen. To disconnect a client, open Connected apps in the developer dashboard for API accounts, or Settings → Connected apps in the Influship app.

Choose a task

Task	Starting point
Find creators from a topic or campaign brief	Instagram creator discovery
Find creators similar to ones you already like	Lookalike discovery
Review a known creator or their recent posts	Stored Instagram profile and content evidence
Compare candidates against a campaign	Campaign-fit scores and supporting evidence
Keep a selection and resume it later	The signed-in creator workspace
Research source-platform content	Live Instagram profiles and posts, TikTok profiles and content, or YouTube channels and content

Stored creator and profile lookups return indexed data. They do not trigger a live profile scrape. Collection and analysis timestamps describe the evidence’s age; see Understanding Creator Data. get_instagram_profile retrieves a live profile by exact username. Set include_posts: true and post_limit: 5 to include up to five recent posts. The result includes public post links and collection time; stored profile lookups remain separate. Each post includes view_count: a measured video view count, or null when unavailable or hidden. Recent reel views are collected when publicly available, even when the individual post does not expose them. A missing count is not zero views. Engagement rate describes the returned post sample with visible counts, with its sample size. It is null when no measurable posts or followers are available; hidden counts are also null. The prompt gallery provides task examples you can copy into your client.

Quickstart

Claude

In Claude, Claude Desktop, or Cowork, open Customize → Connectors:

Select Add custom connector.
Enter Influship as the name and https://mcp.influship.com as the server URL.
Select Connect, sign in to Influship, and choose the account to bill.
Ask for a creator shortlist, inspect a profile, or compare creators against a campaign brief.

Claude shows interactive shortlists, profiles, and comparisons. The anonymous sample profile works before you connect. For example: “Find five Instagram creators whose recent posts discuss sunscreen and sensitive skin. Show the supporting evidence and compare the strongest three for a premium SPF launch.”

Claude Code

claude mcp add --transport http influship https://mcp.influship.com

Then run /mcp in Claude Code, select influship, and sign in. Add --scope user to install across every project, not just the current directory.

Cursor

Add this to .cursor/mcp.json, or to ~/.cursor/mcp.json for every project:

{
  "mcpServers": {
    "influship": {
      "url": "https://mcp.influship.com"
    }
  }
}

Open the MCP section of Cursor’s settings and select Connect next to Influship to sign in.

VS Code

Run MCP: Add Server, choose HTTP, and enter https://mcp.influship.com. Or add it to .vscode/mcp.json:

{
  "servers": {
    "influship": {
      "type": "http",
      "url": "https://mcp.influship.com"
    }
  }
}

VS Code asks you to sign in to Influship the first time a tool runs.

ChatGPT

In an eligible workspace, enable developer mode, create a custom app from Settings → Apps, and use https://mcp.influship.com/chatgpt/mcp as the MCP server URL. Sign in to Influship when prompted.

ChatGPT uses its own address because its interactive views need ChatGPT-specific settings. Every other client uses https://mcp.influship.com.

Other clients

Any client that supports remote MCP servers with OAuth can use https://mcp.influship.com. Stdio-only clients can connect through mcp-remote, which opens the Influship sign-in page in your browser:

npx -y mcp-remote https://mcp.influship.com

Headless and CI setups

Where no one can complete a browser sign-in, send an API key from the dashboard instead, using the same URL:

claude mcp add --transport http influship https://mcp.influship.com --header "X-API-Key: YOUR_INFLUSHIP_API_KEY"

Keep the key in an environment variable or secret store. Every tool works with an API key; calls are billed to that API account.

Set up with AI

Copy this prompt into your coding agent.

Connect this development environment to the Influship MCP server.

Open in Cursor

How it works

Your client connects to https://mcp.influship.com and lists the available tools, each with a description and parameter schema
The first time a tool needs your account, the client opens the Influship sign-in page, where you choose the account to bill
The client picks the right tool, such as semantic_search_creators, and calls it with its arguments
The result includes structured creator or source-platform evidence; some tools also return suggested_followups

Clients can list tools without signing in. get_sample_creator provides an unauthenticated preview.

Tools

Tool	What it does
`get_sample_creator`	Preview one sample creator without signing in
`search_creators`	Look up a creator by name, handle, or profile URL
`semantic_search_creators`	Discover creators from a topic, niche, or campaign brief
`find_lookalike_creators`	Find creators similar to one or more seed creators
`match_creators`	Score explicit creators against a campaign brief
`get_creator`	Stored creator evidence for one Instagram username
`get_posts`	Stored recent public posts for one Instagram username
`get_instagram_profile`	Live Instagram profile, optionally with recent posts
`get_instagram_post`, `get_instagram_posts`	Live Instagram post data
`get_instagram_post_transcript`, `get_instagram_post_transcripts`	Instagram video transcripts
TikTok tools	Profiles, profile videos, videos, search, hashtags, sounds, comments, captions, and transcripts
YouTube tools	Channels, videos, search, search suggestions, and transcripts
`render_creator_shortlist`, `render_creator_profile`, `render_creator_comparison`	Interactive shortlists, profiles, and comparisons in clients that display them
`open_creator_workspace`, `open_saved_shortlist`, `save_creator_shortlist`, `search_shortlist_mentions`, `delete_creator_shortlist`	Saved shortlists for your signed-in account
`get_linked_account`, `get_workspace_updates`	Signed-in account and workspace display state

Use your client’s tool list for the exact schemas.

Creator workspace

The signed-in workspace in Claude and ChatGPT lets you describe a campaign brief, inspect Instagram creator evidence, select up to eight creators, and compare two to four against the brief. Save a named shortlist with notes to your account, then resume it from the saved library. Selected creators remain available when you refine a search. Resume a saved shortlist to retrieve the latest stored creator evidence using your account’s credits. Your shortlist keeps selected profiles, the brief, and notes together. Collection dates and evidence labels help you review profile data, content evidence, and AI analysis. Each account can hold 100 saved shortlists. Updating a shortlist requires its current version; if another save changes it, reopen it before updating. Saved work is private to your account. In desktop hosts that support composer mentions, search your saved shortlist names to reference them in a conversation.

Authentication and billing

Signed-in clients send an OAuth bearer token; calls use the account you chose at sign-in, with its billing and rate limits
Headless clients can send X-API-Key; calls use that API account’s metering and rate limits
get_sample_creator is an unauthenticated preview and does not expose arbitrary creator data

If you don’t have an Influship account yet, choose Influship API at sign-in to create one.

Pricing

MCP tool calls billed to an API account use the same credit prices as the underlying REST endpoints, with no MCP surcharge. Calls billed to an Influship app plan use that plan’s credits. The creator workspace can combine several underlying calls.

Tool	Cost
`get_sample_creator`	No user charge
`search_creators`	0.05 credits for indexed creator lookup, or the search price when routed to semantic search
`semantic_search_creators`	25 credits + 2 per result returned
`find_lookalike_creators`	1.5 per creator returned
`match_creators`	1 per creator scored
`get_creator`	0.1 per call
`get_posts`	0.05 per post returned
`get_instagram_post`	0.18 per post
`get_instagram_posts`	0.18 per successful post
`get_instagram_post_transcript`	5 per transcript
`get_instagram_post_transcripts`	5 per successful transcript
`get_instagram_profile`	0.18 per profile
Other TikTok tools	0.18 per request or source page
`get_tiktok_video_transcript`	2.5 per transcript
`get_tiktok_videos`	0.18 per successful entry; 1–20 URLs
`get_tiktok_video_transcripts`	2.5 per successful auto entry or 0.18 per captions entry; 1–10 URLs
`get_youtube_channel`	0.18 per channel
`get_youtube_video_transcript`	0.18 per transcript
`get_youtube_channel_transcripts`	0.18 per transcript returned
`search_youtube`	0.18 per fetched page
`get_youtube_video`	0.18 per video
`get_youtube_typeahead`	0.18 per request
`render_creator_*`	Sum of the REST calls the selected composite tool makes

One credit is $0.01. See the REST pricing reference for the full breakdown.

Rate limits

The credential’s account limits apply, matching direct REST usage. There’s also a per-IP cap of 600 requests per minute. If you hit it, the server returns 429 with a retry-after header. If you’re connecting many agents from the same IP (a corporate proxy, for example), reach out and we’ll tune the IP cap.

Error codes

When a tool call fails, the error message is surfaced as readable text in the MCP client.

Error	Meaning
`400`	Missing or invalid parameter
`401`	Missing or invalid API key or account authorization
`402`	Payment required
`403`	Credential valid but lacks permission for this tool
`404`	Creator, profile, or post not found
`429`	Rate limit exceeded — check `retry_after_seconds` in the response
`5xx`	Server or temporary upstream error; live data 503s may include `retry_after_seconds`

Anonymous agents (no account)

For one-off agents without an Influship account, use the direct HTTP API with x402 or MPP. These payment protocols apply to supported REST endpoints rather than MCP tool calls.

Implementation tips

Use tool descriptions for selection. Each tool describes its purpose and parameters so your client can choose the appropriate operation.
Pass real IDs. Tools that take a creator_id expect a UUID from a previous tool’s response. Resolving by platform + username is supported on lookalike, match, and posts — useful when the user types a handle.
Bound multi-step workflows. Cursor pagination and composite render tools can make additional billed calls. Set a page or result ceiling before handing control to an autonomous agent.

Next steps

Prompt Gallery

Copy a discovery brief or research task into your AI client

Open the dashboard

Manage connected apps, usage, and API keys

API Reference

Full endpoint specs and response schemas — the tools mirror these

Pay with x402

Anonymous per-request payment for one-off agents

Pay with MPP

Stripe cards or Tempo USDC for agent-native payments

Start building

Find and evaluate creators

Research and save

Apps and workflows

Live platform data

Connect your tools

Operate your integration

Choose a task

Quickstart

Claude

Claude Code

Cursor

VS Code

ChatGPT

Other clients

Headless and CI setups

Set up with AI

How it works

Tools

Creator workspace

Authentication and billing

Pricing

Rate limits

Error codes

Anonymous agents (no account)

Implementation tips

Next steps

Prompt Gallery

Open the dashboard

API Reference

Pay with x402

Pay with MPP

​Choose an account at sign-in

​Choose a task

​Quickstart

​Claude

​Claude Code

​Cursor

​VS Code

​ChatGPT

​Other clients

​Headless and CI setups

​Set up with AI

​How it works

​Tools

​Creator workspace

​Authentication and billing

​Pricing

​Rate limits

​Error codes

​Anonymous agents (no account)

​Implementation tips

​Next steps

Prompt Gallery

Open the dashboard

API Reference

Pay with x402

Pay with MPP

Choose an account at sign-in

Choose a task

Quickstart

Claude

Claude Code

Cursor

VS Code

ChatGPT

Other clients

Headless and CI setups

Set up with AI

How it works

Tools

Creator workspace

Authentication and billing

Pricing

Rate limits

Error codes

Anonymous agents (no account)

Implementation tips

Next steps