# resumes.md

> A Markdown-native resume and portfolio platform where developers upload traditional resumes, get them AI-parsed into structured Markdown, connect LinkedIn and Twitter/X, and publish agent-discoverable public profiles.

resumes.md turns static resumes into living, queryable profiles. Users upload a PDF or Word document, and AI extracts structured data into clean Markdown. Public profiles are available as rendered HTML at `/u/{username}` and as raw Markdown at `/u/{username}/resume.md`. An MCP server enables AI agents to search and retrieve profiles programmatically.

## Key Features

- AI-powered resume parsing (PDF, Word, plain text to structured Markdown)
- Public profile pages with rendered resume, headline, bio, and social activity
- Raw Markdown endpoint for each profile (`/u/{username}/resume.md`)
- LinkedIn and Twitter/X OAuth connections with automatic data import
- Embeddable profile widgets for external sites
- MCP server for AI agent discovery (Claude Desktop, Cursor, any MCP client)
- Profile view analytics (human vs AI views)
- Skill-based profile search directory

## Tiers

- **Free**: Upload resume, AI parsing, public profile, raw Markdown endpoint
- **Pro** ($7/mo): LinkedIn connection, analytics, custom embeds
- **Pro+** ($14/mo): Twitter/X connection, profile search directory, advanced analytics

## Public Pages

- [Homepage](https://resumes.md/): Landing page with feature overview and pricing
- [Pricing](https://resumes.md/pricing): Plan comparison and upgrade
- [MCP Documentation](https://resumes.md/docs): MCP server setup guide, available tools, and examples
- [Privacy Policy](https://resumes.md/privacy): Data handling and privacy practices
- [Terms of Service](https://resumes.md/terms): Terms and conditions

## MCP Server

The MCP server allows AI agents to discover and query public profiles. No authentication required.

- Endpoint: `https://resumes.md/api/mcp/mcp`
- Protocol: Streamable HTTP (JSON-RPC 2.0)
- Rate limit: 60 requests/minute per IP
- Only returns profiles where users have opted in to AI discovery

Available tools:

- `list_public_profiles`: Browse public profiles with pagination and sorting (limit, offset, sort)
- `get_profile`: Retrieve the full Markdown resume, metadata, and recent activity for a username
- `search_profiles`: Search by keywords, skills, or recent activity (query, skills, min_activity_days, limit, offset)
- `get_profile_metadata`: Lightweight metadata about a profile without full resume content

## API

- [Parse Resume](https://resumes.md/api/parse-resume): POST - Upload and AI-parse a resume file (auth required, 5 req/hr)
- [Search Profiles](https://resumes.md/api/search): GET - Search public profiles by skills/keywords (Pro+ only, 30 req/min)
- [Profile Analytics](https://resumes.md/api/analytics): GET - View profile analytics (Pro+ only)
- [MCP Endpoint](https://resumes.md/api/mcp/mcp): POST - Model Context Protocol server for AI agents (public, 60 req/min)

## Profile URLs

Public profiles follow the pattern `https://resumes.md/u/{username}`. Append `/resume.md` for raw Markdown content suitable for LLM consumption.

## Optional

- [Sitemap](https://resumes.md/sitemap.xml): XML sitemap with all public profile URLs