What is ProfessionalHeadshot.io MCP?
A free, remote MCP server that gives your AI assistant reliable answers about professional profile photos: the official photo requirements of LinkedIn, Slack and GitHub, style guidance for headshots by use and industry, and a headshot audit that scores a photo and tells you exactly how to improve it.
Every platform limit is copied from the platform's own help pages and returned with source links and a last-reviewed date. Values a platform doesn't publish are returned as null instead of being guessed.
Tools
| Tool | What it does |
|---|
get_profile_photo_specs | Official profile and cover photo limits (pixel range, file size, formats, content rules) for LinkedIn personal profiles, LinkedIn company Pages, Slack and GitHub. Omit platform to get all |
get_headshot_guide | Framing, background, attire and expression guidance for a given use (LinkedIn, resume/CV, company team page, executive bio, speaker/press kit) and industry |
audit_headshot | Score one photo 0–100 as a professional headshot, with concrete issues and fixes. Takes a public https image URL; 5 free audits per day |
Quick start
No API key needed. Add this to your MCP client:
{
"mcpServers": {
"professionalheadshot": {
"type": "http",
"url": "https://professionalheadshot.io/api/mcp"
}
}
}
Claude Code: claude mcp add --transport http professionalheadshot https://professionalheadshot.io/api/mcp
Example prompts
- "What size should my headshot be for LinkedIn, Slack and GitHub?"
- "We're a tech startup — how should everyone's photo look on our team page?"
- "Is this good enough for my LinkedIn? https://…"
- "What's the LinkedIn company Page cover size and file limit?"
Pairs with free agent skills
Two open-source skills use these tools and also work without them — photo processing runs locally:
- linkedin-profile-refresh — crop your headshot for LinkedIn / Slack / GitHub and write a headline and About from your resume
- team-headshot-consistency — find team-page photos that don't match and export a consistent set
https://github.com/professionalheadshot-io/professionalheadshot-skills
Comments