MCP JobPilot Africa
Allows AI agents to preview and import real job postings from Greenhouse job boards using board and company identifiers, with optional saving of imported postings and their source metadata.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP JobPilot Africa
π If you find this project impactful, please give it a Star on GitHub! It helps African tech talent gain visibility across the global AI ecosystem.
MCP JobPilot Africa is an AI-powered Model Context Protocol (MCP) server designed to match African early-career talent with tech internships and job opportunities. It equips AI agents with tools for discovery, profile matching, gap analysis, application tracking, and interview coaching.
π― Features
Continental scope: JobPilot Africa supports discovery across all 55 African Union members and five regions, independently of the countries represented in its demo jobs. Country aliases work across French and English. See continental coverage and direction.
Pasted offer analysis: Compare an external job posting with a candidate's skills, review quoted evidence, and save reports locally. See scope and API.
Job Discovery: Search tech opportunities across Africa by keyword, country, remote allowance, and contract duration.
Skill Matching & Gap Analysis: Match candidate profiles against job prerequisites, compute match scores (0β100%), and receive targeted learning recommendations.
Application Tracking & Follow-ups: Track applications through
saved,applied,interview,offer, andrejected; record a next action and date, and see reminders due today or overdue.Application Pack: Prepare four editable FR/EN documents for a job, copy or download each one, or export the reviewed versions as a ZIP. Add a job to tracking explicitly and schedule a follow-up; no application is sent to an employer. See the application pack guide.
Resume Import: Parse pasted resume text or extract text from a PDF, review the result, and choose whether to update a candidate profile. PDF import does not perform OCR. See PDF support and limits.
Interview Preparation: Generate contextual technical and behavioral interview questions tailored to the candidate's profile and the employer's stack.
Preparation Checklist: Generate an actionable, prioritized preparation plan for upcoming interviews.
Related MCP server: Civify MCP Server
π Project Structure
mcp-jobpilot-africa/
βββ data/ # Demo JSON profiles and local SQLite storage
β βββ candidates.json
β βββ jobs.json
βββ docs/ # Architecture & Tool documentation
β βββ architecture.md
β βββ tools.md
βββ src/
β βββ jobpilot/
β βββ database/ # SQLite connection, schema, and demo seed
β βββ models/ # Pydantic v2 schemas (Job, Candidate, Application, MatchResult, ...)
β βββ services/ # Business logic (matching, job search, interview prep)
β βββ tools/ # FastMCP tools
β βββ mcp_app.py # Shared FastMCP server instance
β βββ server.py # Entrypoint & CLI runner (stdio, sse, http)
βββ tests/ # Isolated pytest suite with dynamic SQLite fixturesπ Quick Start
1. Installation
# Clone the repository
git clone https://github.com/Damasoumana1/mcp-jobpilot-africa-.git
cd mcp-jobpilot-africa-
# Create and activate virtual environment
python -m venv .venv
# On Windows:
.venv\Scripts\activate
# On Linux/macOS:
source .venv/bin/activate
# Install in editable mode
pip install -e .2. Run the Server
Standard IO (stdio - Recommended for Claude Desktop / Cursor / Cline):
python -m jobpilot.serverServer-Sent Events (sse):
python -m jobpilot.server --transport sse --host 127.0.0.1 --port 8000Interactive Web Dashboard:
python -m jobpilot.server --web
# Ou directement :
python -m jobpilot.webOuvrez ensuite votre navigateur sur http://localhost:8000 pour explorer les offres, tester le matching en direct, suivre vos candidatures et gΓ©nΓ©rer vos questions d'entretien.
FastMCP Dev Inspector:
fastmcp dev inspector src/jobpilot/server.py:mcpπ Connecting to Claude Desktop / Cursor
Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"jobpilot-africa": {
"command": "python",
"args": [
"-m",
"jobpilot.server"
],
"cwd": "C:/Users/user/Desktop/mcp-jobpilot-africa"
}
}
}Ready-to-copy configurations are available in configs/. Complete setup instructions for Claude Desktop, Cursor, VS Code/Copilot, and remote ChatGPT-compatible clients are documented in docs/mcp-clients.md. The end-to-end LLM test scenario is available in docs/llm-mcp-test.md. The prioritized implementation backlog is available in docs/product-roadmap.md.
Authentication API
The web API provides account registration, login, logout, session inspection, account updates, password changes and account deletion:
POST /api/auth/register
POST /api/auth/login
POST /api/auth/logout
GET /api/auth/me
PATCH /api/auth/me
DELETE /api/auth/me
POST /api/auth/passwordSessions use an HttpOnly, SameSite=Lax cookie. In local development the cookie is served over HTTP; production deployments must use HTTPS and set a secure deployment configuration. Password changes revoke all sessions. Account deletion removes the account's candidate profiles, applications, analyses and sessions. Web account credentials are separate from the Bearer token used by remote HTTP MCP clients; OIDC for MCP is a separate roadmap item.
Remote HTTP MCP
For a local network test:
python -m jobpilot.server --transport http --host 127.0.0.1 --port 8000 --bearer-token "replace-me"The MCP endpoint supports Authorization: Bearer replace-me. Browser origins can be
added with --cors-origin or the MCP_CORS_ORIGINS environment variable. Production
deployments must run behind HTTPS.
π οΈ MCP Tools Overview (19 Tools)
Tool Name | Parameters | Description |
| none | All 55 AU members, country aliases and five regions. |
|
| Preview or import real postings with source metadata. See job sources. |
|
| Search opportunities using country names/codes and five African regions. |
|
| Retrieve complete job details and required skills. |
|
| Explain skill coverage from pasted text and optionally save the report. |
|
| Retrieve the latest saved offer reports. |
|
| Register or update a job opportunity in the database. |
|
| Retrieve full candidate profile including skills. |
|
| Create or update candidate profile and skills. |
|
| Weighted matching score, gap analysis, and mobility compatibility. |
|
| Parse resume text for skills and education, with optional profile update. |
|
| Create a tracked application record. |
|
| Update application progress and notes. |
|
| Set or clear a follow-up reminder; does not send messages. |
|
| List tracked applications for a candidate. |
|
| Generate tailored cover letter, email subject, and LinkedIn pitch. |
|
| Generate targeted technical and behavioral questions. |
|
| Generate a prioritized preparation checklist. |
|
| Preview four editable FR/EN documents; does not save or send an application. |
π§ͺ Running Tests
The test suite runs with fully isolated, temporary SQLite databases:
pytest -vπ» Modern Web UI (Vite + React 19 + Tailwind CSS)
To launch the modern frontend application:
cd frontend
npm install
npm run devOpen http://localhost:5173 in your browser to experience:
Interactive tech job explorer with continent-wide filters and remote badges
Real-time AI weighted matching score with visual breakdown & skill gaps
Application pipeline with status tracking and scheduled follow-up reminders
Editable FR/EN application pack with per-document copy/download and ZIP export
Resume text and PDF import with a review step before profile updates
Interview studio with AI question generation and preparation checklists
Tailored cover letter & LinkedIn pitch generator with 1-click clipboard copy
Floating AI Career Copilot assistant
π€ Contributing & Community
We are building MCP JobPilot Africa as an open-source, community-driven ecosystem to accelerate early-career tech talent across the African continent! Contributions of all forms are celebrated and welcomed:
πΌ Add tech jobs: Use our Submit Job Form to add local and remote opportunities.
π€ Build MCP tools: Extend
src/jobpilot/tools/with new agentic capabilities (resume parsing, skill verification, mock audio interviews).π¨ Enhance the Web UI: Improve React components, Tailwind styling, charts, or accessibility.
π Internationalization (i18n): Help translate JobPilot Africa into French, Arabic, Swahili, Portuguese, and more.
π Report issues: Found a bug or edge case? Open an issue using our Bug Report Form.
π₯ Contributors Hall of Fame
A massive thank you to everyone shaping the future of African tech talent! π
Check out our Contributing Guide and Code of Conduct to make your first commit.
π License
Distributed under the MIT License.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Run your tech job search from your AI agent: matches, job unlocks, applications and follow-ups.
Job platform for AI agents. Track tech jobs from companies that match your stack.
Tailor resumes, score ATS fit, find hiring leads, and send cold outreach, from your agent.
Job search for your AI: save jobs, research companies, keep stories, track applications.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to search and filter youth opportunities such as scholarships, fellowships, internships, conferences, and exchange programs, aggregated from multiple live sources.61MIT

Civify MCP Serverofficial
AlicenseAqualityBmaintenanceEnables AI agents to parse resumes, tailor CVs, score ATS compatibility, redact PII, scrape job postings, and track applications through a career platform.8AGPL 3.0- AlicenseAqualityBmaintenanceEnables AI agents to search verified tech and AI jobs, match resumes to roles with explainable fit scores, retrieve salary statistics, and prepare human-in-the-loop applications via the ENTRA job platform.8MIT
- FlicenseNot gradedqualityAmaintenanceEnables AI agents to search and filter thousands of tech job postings across nine boards and eight countries β including salary-transparent listings and Swiss and Singapore government portals β and to apply directly. It also tracks prior applications locally so already-applied roles are hidden from results.-