MCP Server

The official MCP (Model Context Protocol) server for ByCrawl — query 18 social and data platforms directly from AI agents like Claude, Cursor, and Windsurf.

npm · 91 currently available tools · 18 platforms

New to ByCrawl? Start with Getting Started to create an account and get your API key.

Setup

Create your account

Add the connector

Claude Desktop (Recommended)

The easiest way — no install, no API key needed:

Open Claude Desktop → Settings → Connectors
Click Add custom connector
Paste this URL:


https://mcp.bycrawl.com/mcp

Click Connect and authorize with your byCrawl account

That’s it! Claude will now have access to all byCrawl tools.

Claude Code


claude mcp add bycrawl -e BYCRAWL_API_KEY=sk_byc_xxx -- npx -y @bycrawl/mcp

Replace sk_byc_xxx with your API key from the API Keys page.

Cursor / Other

Add to your MCP config file:

Cursor: .cursor/mcp.json in your project root
Other MCP clients: check your client’s documentation for the config file location


{
  "mcpServers": {
    "bycrawl": {
      "command": "npx",
      "args": ["-y", "@bycrawl/mcp"],
      "env": {
        "BYCRAWL_API_KEY": "sk_byc_xxx"
      }
    }
  }
}

Start using it

Ask your AI agent to query social media data. For example:

“Search Threads for posts about AI agents”
“Get the LinkedIn profile for OpenAI”
“Find trending TikTok videos about cooking”
“What are the latest Reddit posts in r/webdev?”

Available Tools

The currently published MCP package exposes 91 tools across 18 platforms and System. The REST-only Instagram post search, Reddit comment, and LinkedIn public-contact contracts are not advertised as MCP tools until the next package release is published.

Platform	Tools	Examples
Threads	9	Search posts, get user profile/replies, post replies, public feed
X / Twitter	5	Search tweets, get user timeline, get post comments
Facebook	8	Get page, search posts, marketplace browse/search/item
Reddit	6	Get subreddit, search posts, get user/post
LinkedIn	11	Get company, company posts/employees, search jobs/users/companies
TikTok	6	Get video, search, comments, subtitles
Instagram	5	Search hashtags, get user/post, comments, user posts
YouTube	5	Get video/channel, search, comments, transcription
104 Job Bank	2	Search jobs and get job details
Google Maps	2	Search places, get place details
Google	3	Search, News, Shopping
Trustpilot	5	Get business/reviews, search businesses/categories, suggestions
PTT	4	Get board/posts, get post detail, search posts
591 Rent	2	Get rental listings, get listing detail
Hacker News	4	Get item/user, stories by type, comments
Luma	6	Get event, place events, search events, categories, calendar
Product Hunt	4	Get leaderboard, search products, get product/reviews
Web	2	Fetch a URL, search the web
System	2	Health check, account info

Environment Variables

Variable	Required	Default	Description
`BYCRAWL_API_KEY`	Yes	—	Your ByCrawl API key
`BYCRAWL_API_URL`	No	`https://api.bycrawl.com`	API base URL (for self-hosting)

Example Workflows

Competitive intelligence

“Use ByCrawl to find what people on Reddit and X are saying about [competitor]. Summarize the sentiment.”

Lead research

“Look up this person’s LinkedIn profile and their recent Threads posts. Draft a personalized outreach message.”

Content research

“Search YouTube and TikTok for trending videos about [topic]. What formats are performing best?”

Job market analysis

“Search 104 Job Bank and LinkedIn for senior frontend roles in Taipei. Compare salary ranges and requirements.”