Integrations
Overview
Captapi plugs straight into your AI tooling. The official @captapi/mcp server exposes all 62 endpoints as typed tools over the Model Context Protocol, so Claude, Cursor, VS Code, and any MCP-compatible agent can pull transcripts, comments, profiles, search results, and more — billed to your account, with cached results free.
Prefer a one-click setup? Open Agent Integrations in your dashboard for install buttons with your key pre-filled. Agents can read the machine-readable manifest at /mcp.json.
A human creates the API key
Sign-up and key creation can't be automated by an agent. Create a capt_live_… key once in API Keys (100 free credits) and hand it to your agent.
The agent adds the config
Point your agent at this page or at /mcp.json, paste the snippet below with your key, and restart the client.
MCP Server
There are two ways to connect — both expose the same 62 tools. Pick Hosted for the fastest setup (no install), or Local if you prefer running the package on your machine. Replace the key with your own from API Keys, then restart the client.
Option A — Hosted (no install, just a URL)
Connect over HTTP to https://api.captapi.com/mcp. Nothing to install — your key is passed as an Authorization header (or x-api-key). Ideal for agents that can't run local processes.
// ~/.cursor/mcp.json (or .cursor/mcp.json per project)
{
"mcpServers": {
"captapi": {
"url": "https://api.captapi.com/mcp",
"headers": { "Authorization": "Bearer capt_live_xxxxxxxxxxxxxxxx" }
}
}
}Option B — Local (npx / stdio)
Run the official @captapi/mcp package via npx. It talks to your client over stdio and reads your key from the CAPTAPI_API_KEY environment variable.
// ~/.cursor/mcp.json (or .cursor/mcp.json per project)
{
"mcpServers": {
"captapi": {
"command": "npx",
"args": ["-y", "@captapi/mcp"],
"env": { "CAPTAPI_API_KEY": "capt_live_xxxxxxxxxxxxxxxx" }
}
}
}Configuration (local mode)
| Env var | Required | Description |
|---|---|---|
| CAPTAPI_API_KEY | yes | Your capt_live_… key. |
| CAPTAPI_BASE_URL | no | Override the API base URL (default https://api.captapi.com). |
Tools & Parameters
Each endpoint is a tool named platform_action. Required parameters are marked *. The agent fills these in for you.
YouTube & Shorts (19)
youtube_transcript | url*stringlanguagestring |
youtube_summarize | url*stringlanguagestring |
youtube_video_details | url*string |
youtube_comments | url*stringlimitinteger |
youtube_channel_details | url*string |
youtube_search | q*stringlimitinteger |
youtube_channel_videos | url*stringlimitinteger |
youtube_playlist_videos | url*stringlimitinteger |
youtube_video_download | url*string |
youtube_shorts_transcript | url*stringlanguagestring |
youtube_shorts_summarize | url*stringlanguagestring |
youtube_shorts_details | url*string |
youtube_shorts_comments | url*stringlimitinteger |
youtube_channel_shorts | url*stringlimitinteger |
youtube_channel_streams | url*stringlimitinteger |
youtube_hashtag_search | q*stringlimitinteger |
youtube_comment_replies | url*stringcomment_id*stringlimitinteger |
youtube_channel_playlists | url*stringlimitinteger |
youtube_community_posts | url*stringlimitinteger |
TikTok (18)
tiktok_transcript | url*string |
tiktok_summarize | url*string |
tiktok_video_details | url*string |
tiktok_comments | url*stringlimitinteger |
tiktok_channel_details | url*string |
tiktok_search | q*stringlimitinteger |
tiktok_video_download | url*string |
tiktok_channel_posts | url*stringlimitinteger |
tiktok_comment_replies | url*stringcomment_id*stringlimitinteger |
tiktok_user_followers | url*stringlimitinteger |
tiktok_user_followings | url*stringlimitinteger |
tiktok_music_posts | url*stringlimitinteger |
tiktok_hashtag_search | q*stringlimitinteger |
tiktok_top_search | q*stringlimitinteger |
tiktok_user_search | q*stringlimitinteger |
tiktok_song_details | url*string |
tiktok_trending_feed | countrystringlimitinteger |
tiktok_popular_hashtags | querystringlimitinteger |
Instagram Reels (16)
instagram_transcript | url*string |
instagram_summarize | url*string |
instagram_details | url*string |
instagram_comments | url*stringlimitinteger |
instagram_channel_details | url*string |
instagram_channel_posts | url*stringlimitinteger |
instagram_channel_reels | url*stringlimitinteger |
instagram_reels_search | q*stringlimitinteger |
instagram_video_download | url*string |
instagram_tagged_posts | url*stringlimitinteger |
instagram_music_posts | url*stringlimitinteger |
instagram_hashtag_search | q*stringlimitinteger |
instagram_profile_search | q*stringlimitinteger |
instagram_story_highlights | url*string |
instagram_highlights_details | url*stringlimitinteger |
instagram_embed | url*string |
Facebook (9)
facebook_details | url*string |
facebook_transcript | url*string |
facebook_summarize | url*string |
facebook_comments | url*stringlimitinteger |
facebook_page_details | url*string |
facebook_profile_posts | url*stringlimitinteger |
facebook_profile_reels | url*stringlimitinteger |
facebook_group_posts | url*stringlimitinteger |
facebook_comment_replies | url*stringcomment_id*stringlimitinteger |
Command-line (CLI)
Prefer the terminal, a shell script, or CI? The official @captapi/cli package exposes all 62 endpoints as commands. Authenticate once with captapi login (or set CAPTAPI_API_KEY), then call any endpoint — each one is a subcommand, parameters are flags, and responses print as JSON to stdout so they pipe cleanly into jq and scripts. It can even wire the MCP server into your agent with captapi agent add.
npm install -g @captapi/cli # or just use: npx @captapi/cli <command>
captapi login # paste your capt_live_… key (saved to ~/.captapi/config.json)
captapi whoami # confirm the active key
captapi balance # remaining credits + recent requestsConnect your agent in 60 seconds
Grab a key, paste the config, and start pulling social data from your AI tool.
Open Agent Integrations