mcp-server-proxycurl by pavelsukhachev - MCP Server

Proxycurl MCP Server

An MCP (Model Context Protocol) server that integrates with Proxycurl API to enrich person and company profiles from LinkedIn, Twitter/X, and Facebook.

👋 Open for Opportunities!
I'm actively seeking new opportunities and collaborations. If you have interesting projects or job opportunities, feel free to reach out!
📧 Contact:

Features

🔍 Profile Enrichment: Get detailed professional profiles from social media URLs
📧 Contact Discovery: Extract personal emails and phone numbers
💼 Career Insights: Access work history, education, skills, and certifications
💰 Salary Intelligence: Get inferred salary ranges based on role and company
🔗 Social Profiles: Discover GitHub, Twitter, and Facebook profiles
🚀 Smart Caching: Efficient API usage with configurable caching options

Installation

Prerequisites

Proxycurl API Key (sign up for free trial)
Node.js 18+ or Docker

Option 1: Install from Smithery

To install Proxycurl MCP Server for Claude Desktop automatically via Smithery:

npx @smithery/cli install @pashvc/mcp-server-proxycurl --client claude

Option 2: Install for Claude Desktop

Add to your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "proxycurl": {
      "command": "npx",
      "args": ["-y", "@pashvc/mcp-server-proxycurl"],
      "env": {
        "PROXYCURL_API_KEY": "your-api-key-here"
      }
    }
  }
}

Option 3: Install for Cline

Add to your Cline MCP settings:

{
  "mcpServers": {
    "proxycurl": {
      "command": "npx",
      "args": ["-y", "@pashvc/mcp-server-proxycurl"],
      "env": {
        "PROXYCURL_API_KEY": "your-api-key-here"
      }
    }
  }
}

Option 4: Docker Installation

docker run -e PROXYCURL_API_KEY=your-api-key-here ghcr.io/pashvc/mcp-server-proxycurl

Development Setup

Clone the repository:

git clone https://github.com/pashvc/mcp-server-proxycurl.git
cd mcp-server-proxycurl

Install dependencies:

npm install

Create a .env file:

PROXYCURL_API_KEY=your-api-key-here

Build the project:

npm run build

Run the MCP inspector:

npm run inspector

Available Tools

`get_person_profile`

Enriches a person's profile from LinkedIn, Twitter/X, or Facebook.

Parameters:

profile_url (required): The social media profile URL or username
extra: Include extra data (gender, birth date, industry, interests)
github_profile_id: Include GitHub profile ID
facebook_profile_id: Include Facebook profile ID
twitter_profile_id: Include Twitter profile ID
personal_contact_number: Include personal phone numbers
personal_email: Include personal emails
inferred_salary: Include inferred salary range
skills: Include skills data
use_cache: Cache usage strategy (if-present or if-recent)
fallback_to_cache: Fallback behavior on errors (on-error or never)

Example usage:

Get the LinkedIn profile for johnrmarty with email and salary info

Available Prompts

`analyze-profile`

Provides comprehensive analysis of a professional profile including career trajectory, skills, and growth potential.

`compare-candidates`

Compares multiple candidate profiles against specific role requirements.

`enrich-contact`

Enriches a contact with all available information including emails, phone numbers, and social profiles.

`sales-research`

Researches a prospect for sales outreach with personalized insights.

Cost Optimization

Proxycurl charges credits per API call. Optimize costs by:

Use caching: Set use_cache: "if-present" to use cached data when available
Select only needed fields: Each enrichment option costs extra credits
Batch operations: Process multiple profiles efficiently

API Credit Costs

Base profile lookup: 1 credit
Each enrichment option: +1 credit
Personal emails/phones: +1 credit per item returned

Testing

Run tests:

npm test                    # Run all tests
npm run test:integration   # Run integration tests (requires API key)

License

MIT