# IAM MCP SERVER ... kind of 🤔
[![PyPI][pypi-badge]][pypi-url]
[![MIT licensed][mit-badge]][mit-url]
[![Python Version][python-badge]][python-url]
**The Individual Applicant Mesh (IAM) MCP Server is designed to process and manage applicant resumes, as well as facilitate job searches. It offers specialized tools and prompts for job searching, resume aggregation, generating job-specific resumes, and creating tailored cover letters.**
[pypi-badge]: https://img.shields.io/pypi/v/mcp.svg
[pypi-url]: https://pypi.org/project/iam-mcp-server/
[mit-badge]: https://img.shields.io/pypi/l/mcp.svg
[mit-url]: https://github.com/alejandrogarcia-hub/iam-mcp-server/blob/main/LICENSE
[python-badge]: https://img.shields.io/pypi/pyversions/mcp.svg
[python-url]: https://www.python.org/downloads/
**Note: This server does not fully handle system integrations. Instead, it provides focused functionality specifically for an MCP host—hence the "kind of 🤔".**
> 💡 **Community & Support**
> If you found this project helpful, please consider giving it a star ⭐️. Found a bug or have suggestions? Open an issue—your feedback is welcome!
## 🚀 Quickstart
### 1. Use Claude Desktop as MCP host
The IAM MCP Server is designed to work with Claude Desktop, which provides the necessary MCP host environment. For more details on setting up Claude Desktop with MCP, see the [official MCP quickstart guide](https://modelcontextprotocol.io/quickstart/user).
### 2. Add filesystem MCP server
Add the `filesystem` MCP server to Claude Desktop to enable file system access (see Requirements section below for configuration example).
### 3. Get JSearch API token
Create a free account at [JSearch](https://rapidapi.com/letscrape-6bRBa3QguO5/api/jsearch) to get your API token (200 free requests/month).
⚠️ **Note:** This step is optional. You can let the MCP host or another MCP server handle job searches instead.
### 4. Configure IAM MCP Server
Add the following to your Claude Desktop configuration to run the server directly from PyPI using `uvx`:
```json
{
"mcpServers": {
"iam": {
"command": "uvx",
"args": [
"--from",
"iam-mcp-server@latest",
"mcp-server-iam"
],
"env": {
"LOG_LEVEL": "INFO",
"RAPIDAPI_KEY": "<YOUR_API_KEY>",
"RAPIDAPI_HOST": "jsearch.p.rapidapi.com",
"MCP_TRANSPORT": "stdio"
}
}
}
}
```
------------
> **🚀 Ready to start using IAM MCP Server?**
> Check out the [Features](#-features) section to learn how to use the available tools and prompts.
## 📝 Requirements
1. 🗂️ The MCP host must have read and write access to the local file system where it is running. For example, you can run the `IAM MCP Server` within `Claude Desktop`, alongside the `filesystem` MCP Server, which provides this capability. This file access requirement applies to version `1.0` and is necessary for proper operation.
1.1. Add the `filesystem` MCP server
```json
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"<add directory for filesystem server>"
]
}
}
}
```
2. 🔍 The `search job` MCP tool requires access to [JSearch](https://rapidapi.com/letscrape-6bRBa3QguO5/api/JSearch). You can create an account and get 200 requests per month for free.
## ✨ Features
### Prompts
#### 📊 Analyze Job Market
Directs the LLM step-by-step to perform tasks such as conducting a `job search`, then summarizes and analyzes the resulting job listings. Refer to the full prompt for detailed instructions and context.
#### 📄 Resume Mesh
Easily combine multiple targeted resumes into a single, comprehensive Markdown document.
**What is Resume Mesh?**
If you’ve applied to similar jobs, you’ve likely created several versions of your resume to match different job descriptions. Resume Mesh brings all those versions together into one unified Markdown file. This gives the MCP host a complete view of your experience and makes it easy to generate new, tailored resumes for future applications.
#### 🎯 Job-Specific Resume Generation
Generate customized resumes for individual job postings.
To use this feature, make sure the MCP host already has access to the `resume mesh`. Each tailored resume is generated using both the resume mesh and the specific job description. You need to attach the `resume mesh` to the MCP host conversation in advance, because the resume generation prompt does not instruct the LLM to load the `resume mesh` from the file system.
#### Cover-Letter Generation
Easily generate a customized cover letter tailored to a specific job description, using the corresponding generated resume.
**How to use:**
Before generating a cover letter, ensure the MCP host has access to the relevant generated `resume` for the target job. You must manually attach this `resume` to the MCP host conversation, as the cover letter prompt does not automatically retrieve it from the file system.
#### 💾 Save Job
Directs the LLM step-by-step to `save jobs`.
**How to use:**
Start by searching for jobs using the `search jobs` MCP tool. After obtaining the results, you can then instruct the LLM to save those job listings.
### Tools
#### 🚀 Search Jobs
Performs a job search using the following parameters:
- role: The job title or position to search for
- city: (optional) Target city for the job search
- country: (optional) Target country for the job search
- platform: (optional) Specific job platform to use
- number of jobs: (default 5) Number of job listings to retrieve
- slice job description: (optional) Option to include only a portion of the job description
## 🛠️ Installation & Setup
You can easily install this project as a Python package from PyPI: [iam-mcp-server](https://pypi.org/project/iam-mcp-server/).
### 🖥️ MCP host (Claude Desktop)
1. Locate your `claude_desktop_config.json` file:
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
#### Option 1: Using `uvx` with PyPI package
```json
{
"mcpServers": {
"iam": {
"command": "uvx",
"args": [
"--from",
"iam-mcp-server@latest",
"mcp-server-iam"
],
"env": {
"LOG_LEVEL": "INFO",
"RAPIDAPI_KEY": "<API KEY>",
"RAPIDAPI_HOST": "jsearch.p.rapidapi.com",
"MCP_TRANSPORT": "stdio"
}
}
}
```
#### Option 2: Using source code
```json
{
"mcpServers": {
"iam": {
"command": "<path to>/uv",
"args": [
"--directory",
"<path to>/iam-mcp-server/src/mcp_server_iam",
"run",
"__main__.py"
],
"env": {
"LOG_LEVEL": "INFO",
"RAPIDAPI_KEY": "<API KEY>",
"RAPIDAPI_HOST": "jsearch.p.rapidapi.com",
"MCP_TRANSPORT": "stdio"
}
}
}
}
```
#### Restart your MCP host
- Completely quit and restart your MCP host
- The server will automatically initialize when the host starts
#### Verify the connection
In your MCP host, ask: "What MCP tools are available?" or "List the available MCP servers"
### 🔍 MCP Inspector
In terminal, run `mcp dev src/mcp_server_iam/__main__.py` and accept installing the MCP Inspector.
In the web inspector UI, click `connect` and interact with the MCP server.
⚠️ **Important**, this is for `dev` purposes only.
## ⚙️ Environment Variables
IAM supports configuration through environment variables. Create a `.env` file in the project root or set these variables in your system:
| Variable | Default | Description |
|----------|---------|-------------|
| `APP_NAME` | `iam` | Application name for logging and identification |
| `LOG_LEVEL` | `INFO` | Logging level: `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL` |
| `MCP_TRANSPORT` | `stdio` | Application transport version |
| `RESUME_MESH_FILENAME` | `resume_mesh` | Default filename for resume mesh |
| `RAPIDAPI_KEY` | `""` | RapidAPI key for external API access (optional) |
| `RAPIDAPI_HOST` | `jsearch.p.rapidapi.com` | RapidAPI host endpoint |
## 📂 Repository Structure
```text
iam-mcp-server/
├── src/ # Source code
│ └── mcp_server_iam/ # Main MCP server package
│ ├── __init__.py # Package initialization
│ ├── __main__.py # Entry point for running the server
│ ├── config.py # Configuration management
│ ├── prompt.py # LLM prompts and instructions
│ ├── server.py # MCP server implementation
│ ├── tool.py # MCP tools implementation
│ └── utils.py # Utility functions
├── tests/ # Test suite
│ ├── __init__.py
│ └── test_mcp_tools.py # MCP tools tests
├── .env_example # Environment variables template
├── LICENSE # MIT License
├── makefile # Build and development tasks
├── pyproject.toml # Project configuration and dependencies
├── pytest.ini # Pytest configuration
├── README.md # This file
├── ruff.toml # Ruff linter configuration
└── uv.lock # UV dependency lock file
```
### 🔑 Key Components
- **`src/mcp_server_iam/`**: Core MCP server implementation
- `server.py`: Main MCP server class and protocol handling
- `tool.py`: Implementation of MCP tools (job search, etc.)
- `prompt.py`: LLM prompts for resume generation and job analysis
- `config.py`: Configuration management and environment variables
- `utils.py`: Helper functions and utilities
- **`tests/`**: Comprehensive test suite for MCP tools and functionality
- **Configuration files**: Project setup, linting, and dependency management
## 📝 License
MIT License - see LICENSE file for details
Raw data
{
"_id": null,
"home_page": null,
"name": "iam-mcp-server",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": "Alejandro Garcia <github_dev.chowder574@passmail.net>",
"keywords": "automation, git, jobs, mcp, resume, server",
"author": "Alejandro Garcia",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/f2/62/953f9bae693d8a00136f21485ec6ef9c8f3aba02c6026dc70448122c7c1c/iam_mcp_server-2.1.0.tar.gz",
"platform": null,
"description": "# IAM MCP SERVER ... kind of \ud83e\udd14\n\n[![PyPI][pypi-badge]][pypi-url]\n[![MIT licensed][mit-badge]][mit-url]\n[![Python Version][python-badge]][python-url]\n\n**The Individual Applicant Mesh (IAM) MCP Server is designed to process and manage applicant resumes, as well as facilitate job searches. It offers specialized tools and prompts for job searching, resume aggregation, generating job-specific resumes, and creating tailored cover letters.**\n\n[pypi-badge]: https://img.shields.io/pypi/v/mcp.svg\n[pypi-url]: https://pypi.org/project/iam-mcp-server/\n[mit-badge]: https://img.shields.io/pypi/l/mcp.svg\n[mit-url]: https://github.com/alejandrogarcia-hub/iam-mcp-server/blob/main/LICENSE\n[python-badge]: https://img.shields.io/pypi/pyversions/mcp.svg\n[python-url]: https://www.python.org/downloads/\n\n**Note: This server does not fully handle system integrations. Instead, it provides focused functionality specifically for an MCP host\u2014hence the \"kind of \ud83e\udd14\".**\n\n> \ud83d\udca1 **Community & Support** \n> If you found this project helpful, please consider giving it a star \u2b50\ufe0f. Found a bug or have suggestions? Open an issue\u2014your feedback is welcome!\n\n## \ud83d\ude80 Quickstart\n\n### 1. Use Claude Desktop as MCP host\n\nThe IAM MCP Server is designed to work with Claude Desktop, which provides the necessary MCP host environment. For more details on setting up Claude Desktop with MCP, see the [official MCP quickstart guide](https://modelcontextprotocol.io/quickstart/user).\n\n### 2. Add filesystem MCP server\n\nAdd the `filesystem` MCP server to Claude Desktop to enable file system access (see Requirements section below for configuration example).\n\n### 3. Get JSearch API token\n\nCreate a free account at [JSearch](https://rapidapi.com/letscrape-6bRBa3QguO5/api/jsearch) to get your API token (200 free requests/month).\n\n\u26a0\ufe0f **Note:** This step is optional. You can let the MCP host or another MCP server handle job searches instead.\n\n### 4. Configure IAM MCP Server\n\nAdd the following to your Claude Desktop configuration to run the server directly from PyPI using `uvx`:\n\n```json\n{\n \"mcpServers\": {\n \"iam\": {\n \"command\": \"uvx\",\n \"args\": [\n \"--from\", \n \"iam-mcp-server@latest\",\n \"mcp-server-iam\"\n ],\n \"env\": {\n \"LOG_LEVEL\": \"INFO\",\n \"RAPIDAPI_KEY\": \"<YOUR_API_KEY>\",\n \"RAPIDAPI_HOST\": \"jsearch.p.rapidapi.com\",\n \"MCP_TRANSPORT\": \"stdio\"\n }\n }\n }\n}\n```\n\n------------\n> **\ud83d\ude80 Ready to start using IAM MCP Server?** \n> Check out the [Features](#-features) section to learn how to use the available tools and prompts.\n\n## \ud83d\udcdd Requirements\n\n1. \ud83d\uddc2\ufe0f The MCP host must have read and write access to the local file system where it is running. For example, you can run the `IAM MCP Server` within `Claude Desktop`, alongside the `filesystem` MCP Server, which provides this capability. This file access requirement applies to version `1.0` and is necessary for proper operation.\n\n 1.1. Add the `filesystem` MCP server\n\n ```json\n {\n \"mcpServers\": {\n \"filesystem\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@modelcontextprotocol/server-filesystem\",\n \"<add directory for filesystem server>\"\n ]\n }\n }\n }\n ```\n\n2. \ud83d\udd0d The `search job` MCP tool requires access to [JSearch](https://rapidapi.com/letscrape-6bRBa3QguO5/api/JSearch). You can create an account and get 200 requests per month for free.\n\n## \u2728 Features\n\n### Prompts\n\n#### \ud83d\udcca Analyze Job Market\n\nDirects the LLM step-by-step to perform tasks such as conducting a `job search`, then summarizes and analyzes the resulting job listings. Refer to the full prompt for detailed instructions and context.\n\n#### \ud83d\udcc4 Resume Mesh\n\nEasily combine multiple targeted resumes into a single, comprehensive Markdown document.\n\n**What is Resume Mesh?** \nIf you\u2019ve applied to similar jobs, you\u2019ve likely created several versions of your resume to match different job descriptions. Resume Mesh brings all those versions together into one unified Markdown file. This gives the MCP host a complete view of your experience and makes it easy to generate new, tailored resumes for future applications.\n\n#### \ud83c\udfaf Job-Specific Resume Generation\n\nGenerate customized resumes for individual job postings.\n\nTo use this feature, make sure the MCP host already has access to the `resume mesh`. Each tailored resume is generated using both the resume mesh and the specific job description. You need to attach the `resume mesh` to the MCP host conversation in advance, because the resume generation prompt does not instruct the LLM to load the `resume mesh` from the file system.\n\n#### Cover-Letter Generation\n\nEasily generate a customized cover letter tailored to a specific job description, using the corresponding generated resume.\n\n**How to use:** \nBefore generating a cover letter, ensure the MCP host has access to the relevant generated `resume` for the target job. You must manually attach this `resume` to the MCP host conversation, as the cover letter prompt does not automatically retrieve it from the file system.\n\n#### \ud83d\udcbe Save Job\n\nDirects the LLM step-by-step to `save jobs`.\n\n**How to use:**\n\nStart by searching for jobs using the `search jobs` MCP tool. After obtaining the results, you can then instruct the LLM to save those job listings.\n\n### Tools\n\n#### \ud83d\ude80 Search Jobs\n\nPerforms a job search using the following parameters:\n\n- role: The job title or position to search for\n- city: (optional) Target city for the job search\n- country: (optional) Target country for the job search\n- platform: (optional) Specific job platform to use\n- number of jobs: (default 5) Number of job listings to retrieve\n- slice job description: (optional) Option to include only a portion of the job description\n\n## \ud83d\udee0\ufe0f Installation & Setup\n\nYou can easily install this project as a Python package from PyPI: [iam-mcp-server](https://pypi.org/project/iam-mcp-server/).\n\n### \ud83d\udda5\ufe0f MCP host (Claude Desktop)\n\n1. Locate your `claude_desktop_config.json` file:\n - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n - **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n#### Option 1: Using `uvx` with PyPI package\n\n```json\n{\n \"mcpServers\": {\n \"iam\": {\n \"command\": \"uvx\",\n \"args\": [\n \"--from\", \n \"iam-mcp-server@latest\",\n \"mcp-server-iam\"\n ],\n \"env\": {\n \"LOG_LEVEL\": \"INFO\",\n \"RAPIDAPI_KEY\": \"<API KEY>\",\n \"RAPIDAPI_HOST\": \"jsearch.p.rapidapi.com\",\n \"MCP_TRANSPORT\": \"stdio\"\n }\n }\n}\n```\n\n#### Option 2: Using source code\n\n```json\n{\n \"mcpServers\": {\n \"iam\": {\n \"command\": \"<path to>/uv\",\n \"args\": [\n \"--directory\",\n \"<path to>/iam-mcp-server/src/mcp_server_iam\",\n \"run\",\n \"__main__.py\"\n ],\n \"env\": {\n \"LOG_LEVEL\": \"INFO\",\n \"RAPIDAPI_KEY\": \"<API KEY>\",\n \"RAPIDAPI_HOST\": \"jsearch.p.rapidapi.com\",\n \"MCP_TRANSPORT\": \"stdio\"\n }\n }\n }\n}\n```\n\n#### Restart your MCP host\n\n- Completely quit and restart your MCP host\n- The server will automatically initialize when the host starts\n\n#### Verify the connection\n\nIn your MCP host, ask: \"What MCP tools are available?\" or \"List the available MCP servers\"\n\n### \ud83d\udd0d MCP Inspector\n\nIn terminal, run `mcp dev src/mcp_server_iam/__main__.py` and accept installing the MCP Inspector.\nIn the web inspector UI, click `connect` and interact with the MCP server.\n\n\u26a0\ufe0f **Important**, this is for `dev` purposes only.\n\n## \u2699\ufe0f Environment Variables\n\nIAM supports configuration through environment variables. Create a `.env` file in the project root or set these variables in your system:\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `APP_NAME` | `iam` | Application name for logging and identification |\n| `LOG_LEVEL` | `INFO` | Logging level: `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL` |\n| `MCP_TRANSPORT` | `stdio` | Application transport version |\n| `RESUME_MESH_FILENAME` | `resume_mesh` | Default filename for resume mesh |\n| `RAPIDAPI_KEY` | `\"\"` | RapidAPI key for external API access (optional) |\n| `RAPIDAPI_HOST` | `jsearch.p.rapidapi.com` | RapidAPI host endpoint |\n\n## \ud83d\udcc2 Repository Structure\n\n```text\niam-mcp-server/\n\u251c\u2500\u2500 src/ # Source code\n\u2502 \u2514\u2500\u2500 mcp_server_iam/ # Main MCP server package\n\u2502 \u251c\u2500\u2500 __init__.py # Package initialization\n\u2502 \u251c\u2500\u2500 __main__.py # Entry point for running the server\n\u2502 \u251c\u2500\u2500 config.py # Configuration management\n\u2502 \u251c\u2500\u2500 prompt.py # LLM prompts and instructions\n\u2502 \u251c\u2500\u2500 server.py # MCP server implementation\n\u2502 \u251c\u2500\u2500 tool.py # MCP tools implementation\n\u2502 \u2514\u2500\u2500 utils.py # Utility functions\n\u251c\u2500\u2500 tests/ # Test suite\n\u2502 \u251c\u2500\u2500 __init__.py\n\u2502 \u2514\u2500\u2500 test_mcp_tools.py # MCP tools tests\n\u251c\u2500\u2500 .env_example # Environment variables template\n\u251c\u2500\u2500 LICENSE # MIT License\n\u251c\u2500\u2500 makefile # Build and development tasks\n\u251c\u2500\u2500 pyproject.toml # Project configuration and dependencies\n\u251c\u2500\u2500 pytest.ini # Pytest configuration\n\u251c\u2500\u2500 README.md # This file\n\u251c\u2500\u2500 ruff.toml # Ruff linter configuration\n\u2514\u2500\u2500 uv.lock # UV dependency lock file\n```\n\n### \ud83d\udd11 Key Components\n\n- **`src/mcp_server_iam/`**: Core MCP server implementation\n - `server.py`: Main MCP server class and protocol handling\n - `tool.py`: Implementation of MCP tools (job search, etc.)\n - `prompt.py`: LLM prompts for resume generation and job analysis\n - `config.py`: Configuration management and environment variables\n - `utils.py`: Helper functions and utilities\n\n- **`tests/`**: Comprehensive test suite for MCP tools and functionality\n\n- **Configuration files**: Project setup, linting, and dependency management\n\n## \ud83d\udcdd License\n\nMIT License - see LICENSE file for details\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Individual Application Mesh, MCP Server",
"version": "2.1.0",
"project_urls": {
"Homepage": "https://github.com/alejandrogarcia-hub/iam-mcp-server",
"Issues": "https://github.com/alejandrogarcia-hub/iam-mcp-server/issues",
"Repository": "https://github.com/alejandrogarcia-hub/iam-mcp-server"
},
"split_keywords": [
"automation",
" git",
" jobs",
" mcp",
" resume",
" server"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "59f2482da7ad232f36f16769f916e59499b07adc4ec32826288bf53a65034f06",
"md5": "d225542fd5942932369cb3f5a9ce667d",
"sha256": "5dd16270d46d997363a003db287b02a3cf358193a09db1f748338e6dede6f581"
},
"downloads": -1,
"filename": "iam_mcp_server-2.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d225542fd5942932369cb3f5a9ce667d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 22695,
"upload_time": "2025-07-15T14:20:01",
"upload_time_iso_8601": "2025-07-15T14:20:01.915592Z",
"url": "https://files.pythonhosted.org/packages/59/f2/482da7ad232f36f16769f916e59499b07adc4ec32826288bf53a65034f06/iam_mcp_server-2.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f262953f9bae693d8a00136f21485ec6ef9c8f3aba02c6026dc70448122c7c1c",
"md5": "8eeb33add93d875b79fe984afdf92f44",
"sha256": "e060b66bb2ec49edac634992eed7d8a174e4889542de482180c6f81f2f9419cb"
},
"downloads": -1,
"filename": "iam_mcp_server-2.1.0.tar.gz",
"has_sig": false,
"md5_digest": "8eeb33add93d875b79fe984afdf92f44",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 85819,
"upload_time": "2025-07-15T14:20:03",
"upload_time_iso_8601": "2025-07-15T14:20:03.337798Z",
"url": "https://files.pythonhosted.org/packages/f2/62/953f9bae693d8a00136f21485ec6ef9c8f3aba02c6026dc70448122c7c1c/iam_mcp_server-2.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-15 14:20:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "alejandrogarcia-hub",
"github_project": "iam-mcp-server",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "iam-mcp-server"
}
JSON
