Allows AI clients to access public social media data including profiles, posts, comments, and ad libraries across over 30 platforms.
Also known as CDCStream/captapi-mcp, captapi-mcp, @captapi/mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- 702
- Latest version
- 0.6.0
- Last commit
- Oct 30, 2026
- License
- MIT
What is Captapi MCP?
Captapi allows AI clients to access public social media data including profiles, posts, comments, and ad libraries across over 30 platforms.
Summary generated from the project's README
About Captapi MCP server
Captapi provides a hosted Model Context Protocol server that grants AI clients like Claude, Cursor, and VS Code access to public social media data. It functions through a streamable HTTP transport using JSON-RPC over POST requests. Users connect by providing an API key via an Authorization header or an x-api-key header. This setup allows developers to integrate real-time social information directly into their AI workflows without needing to manage complex scraping infrastructure.
The server exposes 178 specific tools that follow a platform-action naming convention, such as youtube_transcript or tiktok_comments. It covers over 30 platforms including TikTok, Instagram, Reddit, X, and LinkedIn. Beyond simple profile and post retrieval, the tools include capabilities for searching keywords, accessing ad libraries for Meta, TikTok, Google, and LinkedIn, and performing cross-platform analytics. The service is designed for public data only, meaning it cannot access content behind a login or private LinkedIn profiles.
What you can do with it
- 1Analyze social media engagementAsk the AI to compare post performance across different social networks using specific analytics tools.
- 2Research platform advertisingRequest a summary of current advertisements running on Meta or TikTok through the ad library tools.
- 3Extract video content detailsHave the AI client retrieve a transcript from a specific YouTube video to summarize its contents.
Written from the project's README. Every use case is checked against a quote from it.
How to install Captapi MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Captapi MCP in Claude Code
$ claude mcp add --env 'CAPTAPI_API_KEY=<YOUR_CAPTAPI_API_KEY>' captapi-mcp -- npx -y @captapi/mcpInstall Captapi MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"captapi-mcp": {
"command": "npx",
"args": [
"-y",
"@captapi/mcp"
],
"env": {
"CAPTAPI_API_KEY": "<YOUR_CAPTAPI_API_KEY>"
}
}
}
}Install Captapi MCP in VS Code
.vscode/mcp.json
{
"servers": {
"captapi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@captapi/mcp"
],
"env": {
"CAPTAPI_API_KEY": "<YOUR_CAPTAPI_API_KEY>"
}
}
}
}Install Captapi MCP in VS Code CLI
$ code --add-mcp '{"name":"captapi-mcp","type":"stdio","command":"npx","args":["-y","@captapi/mcp"],"env":{"CAPTAPI_API_KEY":"<YOUR_CAPTAPI_API_KEY>"}}'Install Captapi MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"captapi-mcp": {
"command": "npx",
"args": [
"-y",
"@captapi/mcp"
],
"env": {
"CAPTAPI_API_KEY": "<YOUR_CAPTAPI_API_KEY>"
}
}
}
}Install Captapi MCP in Codex
$ codex mcp add captapi-mcp --env 'CAPTAPI_API_KEY=<YOUR_CAPTAPI_API_KEY>' -- npx -y @captapi/mcpInstall Captapi MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.captapi-mcp] command = "npx" args = ["-y", "@captapi/mcp"] [mcp_servers.captapi-mcp.env] CAPTAPI_API_KEY = "<YOUR_CAPTAPI_API_KEY>"
Install Captapi MCP in Gemini CLI
$ gemini mcp add -s user -e 'CAPTAPI_API_KEY=<YOUR_CAPTAPI_API_KEY>' captapi-mcp npx -- -y @captapi/mcpInstall Captapi MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"captapi-mcp": {
"command": "npx",
"args": [
"-y",
"@captapi/mcp"
],
"env": {
"CAPTAPI_API_KEY": "<YOUR_CAPTAPI_API_KEY>"
}
}
}
}Configuration
CAPTAPI_API_KEYRequiredSecretYour capt_live_... API key. Create one at https://captapi.com/dashboard/api-keys (100 free credits).
CAPTAPI_BASE_URLOverride the Captapi API base URL (default https://api.captapi.com).
CAPTAPI_PLATFORMSComma-separated platform ids to load, e.g. instagram,tiktok (default: all platforms).
| Name | Description | |
|---|---|---|
| CAPTAPI_API_KEY | Your capt_live_... API key. Create one at https://captapi.com/dashboard/api-keys (100 free credits). | RequiredSecret |
| CAPTAPI_BASE_URL | Override the Captapi API base URL (default https://api.captapi.com). | |
| CAPTAPI_PLATFORMS | Comma-separated platform ids to load, e.g. instagram,tiktok (default: all platforms). |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablecdcstream/captapi-mcp is public and reachablegithub.com/cdcstream/captapi-mcp ↗Pass
- Package names this repository as its source@captapi/mcp names git+https://github.com/CDCStream/captapi.git as its sourcenpmjs.com/package/@captapi/mcp ↗Finding
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-07github.com/cdcstream/captapi-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @captapi/mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 46 msPass
README
View on GitHubCaptapi MCP server
Captapi's hosted Model Context Protocol server gives Claude, Cursor, VS Code and other MCP clients read access to public social media data through one API key. Each Captapi REST endpoint is exposed as one MCP tool that returns JSON.
This repository holds documentation and the registry manifest only. It contains no server source code.
- Endpoint:
https://api.captapi.com/mcp - Transport: Streamable HTTP (stateless, JSON-RPC over
POST) - Auth:
Authorization: Bearer <key>orx-api-key: <key> - Official MCP Registry:
io.github.CDCStream/captapi - Docs: captapi.com/docs/integrations
What the tools cover
Public data only: nothing behind a login. For LinkedIn, only pages visible without signing in.
As of October 2026 the server lists 178 tools. Tool names follow <platform>_<action>, for example youtube_transcript, tiktok_comments or instagram_profile.
Platforms: TikTok, YouTube, Facebook, Instagram, GitHub, LinkedIn, Reddit, X (Twitter), Spotify, Threads, Rumble, Pinterest, Twitch, Google Maps, Truth Social, Kwai, SoundCloud, Bluesky, Snapchat, Kick, Amazon shop pages, and link-in-bio pages (Linktree, Linkme, Linkbio, Pillar, Komi).
Tool categories:
- Profiles, channels and pages
- Posts, videos and their details
- Comments and comment replies
- Transcripts and AI summaries
- Search (keywords, hashtags, users)
- Ad libraries: Meta (Facebook), TikTok, Google and LinkedIn
- Cross-platform post analytics (
analytics_post,analytics_compare) - Google Maps business search
- Your own Captapi account: balance, daily usage, request history (
account_*)
Run tools/list against the endpoint for the current list with exact input schemas. Listing tools does not need a key.
Get a key
Sign up at captapi.com, then create a key at captapi.com/dashboard/api-keys. New accounts get 100 free credits after email verification; no credit card is needed.
Each tool call uses the credits of the matching endpoint, listed on its page under captapi.com/apis. Calls that fail are not charged.
Keep your key out of shared config files and version control.
Setup
Replace capt_live_xxxxxxxxxxxxxxxx with your key.
Claude Code
claude mcp add --transport http captapi https://api.captapi.com/mcp \
--header "Authorization: Bearer capt_live_xxxxxxxxxxxxxxxx"
Cursor
~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):
{
"mcpServers": {
"captapi": {
"url": "https://api.captapi.com/mcp",
"headers": {
"Authorization": "Bearer capt_live_xxxxxxxxxxxxxxxx"
}
}
}
}
Claude Desktop
Claude Desktop's config file starts local (stdio) servers, so use the @captapi/mcp npm package, which calls the same API. Open Settings → Developer → Edit Config and add:
{
"mcpServers": {
"captapi": {
"command": "npx",
"args": ["-y", "@captapi/mcp"],
"env": {
"CAPTAPI_API_KEY": "capt_live_xxxxxxxxxxxxxxxx"
}
}
}
}
Requires Node.js. Restart Claude Desktop after saving.
Any MCP client (Streamable HTTP)
Point the client at https://api.captapi.com/mcp and send the key in a header. Either form works:
Authorization: Bearer capt_live_xxxxxxxxxxxxxxxx
x-api-key: capt_live_xxxxxxxxxxxxxxxx
Raw check with curl:
curl -s https://api.captapi.com/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Authorization: Bearer capt_live_xxxxxxxxxxxxxxxx" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"account_balance","arguments":{}}}'
The server is stateless: no session ID is needed, and GET on the endpoint returns 405. Without a key, initialize and tools/list work, and tools/call returns an error result asking for a key.
Registry manifest
server.json is a copy of the manifest published to the official MCP Registry as io.github.CDCStream/captapi.
Security
See SECURITY.md.
License
The documentation and configuration in this repository are MIT licensed. See LICENSE. Use of the Captapi API is governed by the Terms of Service and Acceptable Use Policy.
Captapi MCP questions
How do I add Captapi MCP to Claude Code?
Run claude mcp add --env 'CAPTAPI_API_KEY=<YOUR_CAPTAPI_API_KEY>' captapi-mcp -- npx -y @captapi/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Captapi MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does the server provide access to private information?
No, the server only provides access to public data that does not require a login, such as LinkedIn pages visible without signing in.
How much does it cost to try the service?
New accounts receive 100 free credits after verifying their email, and no credit card is required to sign up.
Are failed tool calls charged?
No, you are not charged for tool calls that fail.