🧭 Pathwise — Smart Career Navigation (Python MCP)

Pathwise is an intelligent career automation platform refactored to Python + FastMCP. It provides a suite of MCP tools for profile management, job search, cover letter generation, and application tracking.

🚀 Key Features

• Profile Management — Store and manage your professional profile with skills, experience, and education
• AI CV Parsing — Extract structured data from PDF CVs (regex or AI-powered)
• Cover Letter Generation — Generate tailored cover letters using RouteMCP AI
• Job Search — Scrape Chilean job boards (ChileTrabajos, CompuTrabajo)
• Application Tracking — Track your job applications with status updates and statistics
• Persona Generation — AI-optimized professional profiles for different target roles

🛠️ Tech Stack

• Runtime: Python 3.11+
• Framework: FastMCP (MCP protocol via stdio)
• Database: SQLite (WAL mode)
• AI: RouteMCP (Groq Llama 3.3 70B via Gemini/Groq/Cerebras)
• PDF: PyMuPDF + PyPDF2
• Scraping: httpx + BeautifulSoup4

📦 MCP Tools (17 total)

Profile

• profile_load — Load your professional profile
• profile_list — List all saved profiles
• profile_save — Create a new profile
• profile_delete — Delete a profile
• profile_generate_personas — Generate 3 AI-optimized personas

Job Search

• job_search — Search jobs on Chilean boards
• job_search_from_profile — Search using your profile as query

Applications

• application_list — List applications (filter by status)
• application_get — Get application details
• application_create — Track a new application
• application_update — Update application details
• application_update_status — Quick status change
• application_delete — Delete an application
• application_stats — Application statistics

Cover Letters

• cover_letter_generate — Generate tailored cover letter
• cover_letter_suggest_improvements — Get improvement suggestions

CV

• cv_parse_pdf — Extract structured data from PDF CV

🚥 Getting Started

# Install dependencies
uv sync

# Run the MCP server
python server.py

# Or via uv
uv run python server.py

🏛️ Project Structure

Pathwise/
├── server.py              # FastMCP entry point
├── config.py              # Environment configuration
├── pyproject.toml         # Python project config
├── profile.json           # User profile data
├── database/
│   ├── __init__.py        # SQLite connection + schema seed
│   └── repos/
│       ├── profiles.py    # Profile CRUD
│       └── applications.py # Application CRUD
├── services/
│   ├── ai_provider.py     # RouteMCP AI integration
│   ├── cv_service.py      # PDF parsing
│   ├── job_service.py     # Job search + matching
│   └── scrapers/
│       ├── chiletrabajos.py
│       └── computrabajo.py
├── tools/                 # MCP tool definitions
│   ├── profile_tools.py
│   ├── job_tools.py
│   ├── application_tools.py
│   ├── cover_letter_tools.py
│   └── cv_tools.py
├── web-dashboard/         # Frontend (Vanilla JS)
├── extension/             # Chrome Extension (MV3)
└── docs/                  # Documentation

---

Developed by MedalCode — Pathwise is your terminal for professional infiltration.