Social Media Handle Checker MCP Server
A comprehensive Model Context Protocol (MCP) server that checks username availability across all major social media platforms. Perfect for qualifying brand names for your media business.
Features
- 🎯 Multi-Platform Support: Check usernames across YouTube, TikTok, Threads, X (Twitter), and Instagram
- 📊 Detailed Account Information: Get follower counts, verification status, descriptions, and more
- 🚀 Batch Checking: Check availability across ALL platforms with a single command
- ⚡ Individual Platform Tools: Target specific platforms when needed
- 🔍 Comprehensive Data: Extract profile names, IDs, descriptions, and engagement metrics
- 💼 Brand Research: Perfect for media business name qualification and competitive analysis
Available Tools
1. check_all_platforms - 🎯 RECOMMENDED
Check username availability across all supported platforms at once. This is the most powerful tool for comprehensive brand research.
Parameters:
username(string): The username to check across all platforms (with or without @ prefix)
Platforms checked:
- YouTube
- TikTok
- Threads
- X (Twitter)
Example Response:
Multi-Platform Check Results for "@statechange"
✅ AVAILABLE ON (2/5 platforms):
• Threads
• TikTok
❌ TAKEN ON (3/5 platforms):
• YouTube - State Change (8.09K subscribers)
• X (Twitter) - State Change ✓ Verified
• Instagram - statechange (1.2M followers)
⚠️ Limited availability - this username is taken on most platforms.
2. Individual Platform Tools
check_youtube_handle: Check YouTube channel availabilitycheck_tiktok_handle: Check TikTok username availabilitycheck_threads_handle: Check Threads username availabilitycheck_x_handle: Check X (Twitter) username availabilitycheck_instagram_handle: Check Instagram username availability
Parameters for all individual tools:
username(string): The username to check (with or without @ prefix)
Individual Tool Examples:
statechange- Check if @statechange is available@statechange1- Check if @statechange1 is availablepewdiepie- Check if @pewdiepie is available (spoiler: it's taken!)
Response Format:
- If taken: Returns detailed account information (name, followers, verification, description)
- If available: Confirms the username is available for registration
How It Works
The server makes HTTP requests to social media platform profile pages to determine username availability:
Platform URLs:
- YouTube:
https://www.youtube.com/@{username} - TikTok:
https://www.tiktok.com/@{username} - Threads:
https://www.threads.net/@{username} - X (Twitter):
https://x.com/{username} - Instagram:
https://www.instagram.com/{username}/
Detection Logic:
- If the page returns 404 or shows "not found" messages, the username is available
- If the page returns 200 with valid profile data, the username is taken
- When taken, we extract profile information like display names, follower counts, verification status, and descriptions
Multi-Platform Checking:
- Runs checks in parallel for maximum speed
- Handles errors gracefully (if one platform fails, others continue)
- Provides comprehensive availability summary with visual indicators
Configuration for MCP Clients
Add this server to your MCP client configuration.
This is an MCP server that runs over STDIO. You can use it with any MCP-compatible client.
Option A — npx (recommended, zero install):
{
"mcpServers": {
"social-media-handle-checker": {
"command": "npx",
"args": ["-y", "@raydeck/social-media-handle-checker-mcp"],
"env": {}
}
}
}
Windsurf Assistant UI
Add this MCP server to Windsurf Assistant UI using STDIO:
- Open Settings → MCP Servers → Add Server
- Name:
social-media-handle-checker - Command:
npx - Args:
-y @raydeck/social-media-handle-checker-mcp - Env: leave empty (not required)
Equivalent JSON (for builds that support JSON import):
{
"mcpServers": {
"social-media-handle-checker": {
"command": "npx",
"args": ["-y", "@raydeck/social-media-handle-checker-mcp"],
"env": {}
}
}
}
Install in Cursor
Click to add this MCP server to Cursor.
Quick Start Usage
# Check all platforms at once (recommended)
check_all_platforms("mybrandname")
check_youtube_handle("mybrandname")
check_tiktok_handle("mybrandname")
check_instagram_handle("mybrandname")
Development
# Install dependencies
npm install
# Build the project
npm run build
# Watch mode for development
npm run dev
# Run the server
npm start
Use Cases
Perfect for:
- 🎬 Media Businesses: Check brand name availability across all major platforms
- 📺 Content Creators: Explore username options and find consistent handles
- 🚀 Startups: Validate social media presence before launching
- 🔍 Brand Consultants: Conduct comprehensive competitive research
- 💼 Marketing Agencies: Qualify client brand names across platforms
- 🎨 Influencers: Find available usernames for brand expansion
- 🕰️ Domain Hunters: Check social media availability alongside domain research
Real-World Examples
# Startup looking for consistent branding
check_all_platforms("techstartup2024")
# Result: Available on 4/5 platforms - perfect for consistent branding!
# Content creator checking variations
check_all_platforms("creativestudio")
check_all_platforms("creativestudio1")
check_all_platforms("creativestudiohq")
# Find the best available option across platforms
# Brand consultant competitive research
check_all_platforms("competitor1")
check_all_platforms("competitor2")
# Analyze competitor presence and find opportunities
Limitations
- Web Scraping Dependency: Relies on web scraping, so platform changes could affect functionality
- Rate Limiting: May apply for excessive requests (recommended: max 1 request per second)
- Privacy Settings: Some account information might not be available due to privacy settings
- Platform Updates: Major platform redesigns may require updates to extraction logic
- Temporary Failures: Individual platform checks may fail due to network issues (other platforms continue working)
License
MIT