Skip to content
Back to search

naukri_mcp

Production Model Context Protocol (MCP) server for Naukri.com with multi-tenant session isolation and 63 tools

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/prasadrawas/naukri_mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/prasadrawas/naukri_mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/prasadrawas--naukri-mcp/badge.svg)](/listings/prasadrawas--naukri-mcp)

HTML

<a href="/listings/prasadrawas--naukri-mcp"><img src="/api/listings/prasadrawas--naukri-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 226 lines
  1. # naukri-mcp: Model Context Protocol (MCP) Server for Naukri.com
  2. Production **Model Context Protocol (MCP)** Server providing **64 specialized tools**, resources, and prompts for **Naukri.com**. Designed to be deployed with zero required environment variables and connected seamlessly to modern AI assistants including **Claude Web**, **Google Gemini**, **Claude Desktop**, **Cursor**, and **Antigravity**.
  3. ---
  4. ## 🌟 Key Architecture Highlights
  5. - **Standalone & Portable Repository:** Completely self-contained with zero hardcoded paths and no dependency on local candidate files.
  6. - **Dual Transport Support (Streamable HTTP & SSE):** Supports both the modern **Streamable HTTP** specification (`/mcp` and `/sse` via `POST`) and legacy **HTTP+SSE** (`/sse` via `GET`), with full cross-origin CORS support.
  7. - **Zero-Config Multi-Tenant Deployment:** Deploy on Railway, Render, Fly.io, or any container host with **zero environment variables required**.
  8. - **Personalized URL Query Parameter Connection:** Each user passes their credentials dynamically via URL query parameters (`https://<domain>/mcp?rt=YOUR_NAUK_RT_COOKIE`) or custom HTTP headers (`X-Naukri-RT`, etc.).
  9. - **Smart Session Caching:** Access tokens (`nauk_at`) and session credentials are bound to each client's session and cached in memory. The assistant **never repeatedly asks for tokens** across turns or chats, only prompting if the token is missing or has actually expired on Naukri.
  10. - **64 Comprehensive Tools:** Complete CloudGateway API coverage across profile management, IT skills, 18+ projects, accomplishments, recruiter communications, analytics, and job applications.
  11. ---
  12. ## 🚀 1-Click / Docker Deployment on Railway
  13. Anyone can fork or clone this repository and deploy it immediately without configuring secrets or environment variables during deployment.
  14. ### Quick Railway Deployment:
  15. 1. Fork or push this repository to your GitHub account.
  16. 2. In [Railway](https://railway.app), click **New Project** &rarr; **Deploy from GitHub repo**.
  17. 3. Select `naukri_mcp`. Railway automatically detects the `Dockerfile`.
  18. 4. Deploy! Railway assigns a public HTTPS domain (e.g. `https://naukrimcp-production.up.railway.app`) and dynamically provides the `$PORT` environment variable.
  19. 5. Visit your Railway URL in the browser to view the interactive server landing page and `/health` probe.
  20. ### Run with Docker Locally:
  21. ```bash
  22. docker build -t naukri-mcp .
  23. docker run -p 8000:8000 naukri-mcp
  24. ```
  25. ---
  26. ## 🔌 Connecting to AI Clients
  27. ### 1. Claude AI Web (Custom Connectors)
  28. Claude Web supports remote MCP servers directly via Custom Connectors:
  29. 1. In **Claude AI**, go to **Settings** &rarr; **Connectors** (or open the chat tools menu and click **Add custom connector**).
  30. 2. Fill in the fields:
  31. - **Name:** `Naukri MCP` (or your preferred name)
  32. - **URL:** Use the Streamable HTTP endpoint with your `rt` token:
  33. ```text
  34. https://<YOUR-RAILWAY-APP>.up.railway.app/mcp?rt=YOUR_NAUK_RT_COOKIE
  35. ```
  36. *(Note: `/sse?rt=...` is also supported)*
  37. 3. When prompted with *"Couldn't determine how this server signs in"*, click **Continue anyway**.
  38. 4. Under **Authentication**, select **No sign-in** *(because your token is already authenticated via the URL parameter)*.
  39. 5. Click **Add**. All 63 tools will be registered immediately!
  40. ---
  41. ### 2. Google Gemini & Antigravity
  42. Add `naukri-mcp` to your MCP configuration (e.g. `mcp_config.json` or `settings.json`):
  43. ```json
  44. {
  45. "mcpServers": {
  46. "naukri": {
  47. "url": "https://<YOUR-RAILWAY-APP>.up.railway.app/mcp?rt=YOUR_NAUK_RT_COOKIE"
  48. }
  49. }
  50. }
  51. ```
  52. ---
  53. ### 3. Claude Desktop & Cursor (Remote Mode)
  54. Add to `claude_desktop_config.json` or `.cursor/mcp.json`:
  55. ```json
  56. {
  57. "mcpServers": {
  58. "naukri": {
  59. "url": "https://<YOUR-RAILWAY-APP>.up.railway.app/sse?rt=YOUR_NAUK_RT_COOKIE"
  60. }
  61. }
  62. }
  63. ```
  64. #### URL Query Parameters:
  65. | Parameter | Type | Required | Description |
  66. |---|---|---|---|
  67. | `rt` / `nauk_rt` | string | **Yes** | Your `nauk_rt` refresh cookie from naukri.com. |
  68. | `resume` | string | *Optional* | Public HTTP/HTTPS URL to your candidate `master_resume.json`. |
  69. | `pdf` | string | *Optional* | Public HTTP/HTTPS URL to download your tailored resume PDF for 1-click uploads. |
  70. #### Custom HTTP Headers (Alternative):
  71. If your MCP client supports custom headers:
  72. - `X-Naukri-RT`: `YOUR_NAUK_RT_COOKIE`
  73. - `X-Master-Resume`: `https://example.com/master_resume.json`
  74. - `X-Resume-Pdf`: `https://example.com/resume.pdf`
  75. ---
  76. ### How to Get Your `nauk_rt` Cookie in 30 Seconds
  77. 1. Log in to [naukri.com](https://www.naukri.com) in your browser.
  78. 2. Open Developer Tools (`F12` or `Cmd+Option+I` on macOS).
  79. 3. Navigate to **Application** (Chrome/Edge) or **Storage** (Firefox) &rarr; **Cookies** &rarr; `https://www.naukri.com`.
  80. 4. Copy the value of the **`nauk_rt`** cookie.
  81. > [!NOTE]
  82. > `nauk_rt` is a long-lived refresh token. The server automatically exchanges it for fresh short-lived access tokens (`nauk_at`) and keeps them renewed in memory.
  83. ---
  84. ### 4. Local stdio Mode (Single Developer / CLI)
  85. For local development without Docker:
  86. ```bash
  87. git clone https://github.com/prasadrawas/naukri_mcp.git
  88. cd naukri_mcp
  89. python3 -m venv .venv
  90. source .venv/bin/activate
  91. pip install -e .
  92. ```
  93. Add to `claude_desktop_config.json`:
  94. ```json
  95. {
  96. "mcpServers": {
  97. "naukri": {
  98. "command": "python",
  99. "args": ["-m", "naukri_mcp"],
  100. "env": {
  101. "NAUK_RT": "your_nauk_rt_cookie_value"
  102. }
  103. }
  104. }
  105. }
  106. ```
  107. ---
  108. ## 🛠️ Available MCP Tools (64 Total)
  109. ### Profile & Positioning Tools
  110. - `get_profile`: Query live sections (`headline`, `summary`, `skills`, `notice`, `career`, `itskills`, `projects`, `educations`, `employments`, `languages`, `personal`, or `all`).
  111. - `update_headline`: Update resume headline (e.g. `Senior Full Stack Engineer | Python, React`).
  112. - `update_summary`: Update candidate summary (auto-trimmed to max 1000 characters).
  113. - `update_key_skills`: Update key skills CSV tags.
  114. - `update_notice_period`: Update notice period (0 for Serving Notice, 15, 30, 60, 90 days).
  115. - `update_location`: Update current candidate city using standardized city IDs.
  116. - `update_career_profile`: Update desired industry, functional area, role, job types, and shifts.
  117. - `update_job_search_status`: Update active job search status (`actively_looking`, `open_to_offers`, `not_looking`).
  118. - `touch_profile_pulse`: Touch timestamp without altering profile content to keep "Profile Updated: Today" badge active.
  119. - `sync_full_profile`: Synchronize entire candidate profile and 18+ projects from master resume facts in one pass.
  120. ### Experience, Skills & Education
  121. - `update_work_experience`: Mutate work history entries (designation, employer, CTC, dates, responsibilities).
  122. - `update_it_skills`: Update technical IT skills matrix with versions, last used year, and experience.
  123. - `add_it_skill`: Add an individual IT skill entry.
  124. - `update_projects`: Sync complete client and personal project portfolios.
  125. - `add_project`: Add an individual client/personal project.
  126. - `update_educations`: Sync university and higher education degrees.
  127. - `update_schools`: Update 10th and 12th schooling records.
  128. - `update_languages`: Update spoken languages and proficiencies (`read`, `write`, `speak`).
  129. - `add_language`: Add a single language entry.
  130. ### Accomplishments & Additions
  131. - `update_certifications`: Sync professional certifications (AWS, GCP, CKA, etc.).
  132. - `update_online_profiles`: Add or update online links (GitHub, LinkedIn, Portfolio).
  133. - `update_work_samples`: Add or update live application and code samples.
  134. - `update_publications`: Add or update research papers and tech articles.
  135. - `update_presentations`: Add or update conference slide decks.
  136. - `update_patents`: Add or update patent filings.
  137. - `update_accomplishments`: Multi-section synchronizer for all accomplishment categories.
  138. ### Resumes & Photos
  139. - `download_resume`: Download and read candidate's active PDF resume from Naukri, extracting plain text content and metadata directly into chat.
  140. - `upload_resume`: Upload PDF resume from local path, download URL, or base64.
  141. - `delete_resume`: Remove uploaded resume from profile.
  142. - `upload_photo`: Upload candidate profile photo (JPEG/PNG).
  143. - `delete_photo`: Remove candidate profile photo.
  144. ### Job Search & Applications
  145. - `search_jobs`: Query job openings with keywords, city, and experience filters.
  146. - `get_job_details`: Inspect full Job Description (JD), employer facts, and screening questionnaire.
  147. - `apply_to_job`: Submit application directly (1-click) or with AI-resolved answers array.
  148. ### Recruiter Analytics & Communications
  149. - `get_profile_analytics`: Inspect 30-day recruiter search appearances, profile views, and completeness.
  150. - `get_recruiter_inbox`: Fetch recruiter messages, interview calls, and unread inquiries.
  151. - `get_notification_summary`: Check application updates, recruiter views, and shortlist alerts.
  152. - `get_salary_components`: Inspect breakup of base vs variable CTC.
  153. - `get_blocked_companies` / `block_company`: Prevent current employers or specific recruiters from viewing profile.
  154. ### Deletion Tools (Audited & Safe)
  155. - `delete_project`, `delete_employment`, `delete_it_skill`, `delete_education`, `delete_school`, `delete_online_profile`, `delete_work_sample`, `delete_publication`, `delete_presentation`, `delete_patent`, `delete_certification`, `delete_language`, `delete_profile_item`.
  156. ---
  157. ## 📚 MCP Resources
  158. - `naukri://candidate/master-resume`: Authenticated source of truth for candidate facts, skills, and projects.
  159. - `naukri://rules/platform-guidelines`: Naukri API schemas, accomplishment quotas (max 5), and date constraints.
  160. - `naukri://profile/current`: Real-time candidate profile state across all sections.
  161. - `naukri://analytics/dashboard`: Search appearance counts, profile views, and recruiter trend graphs.
  162. - `naukri://inbox/recruiter-mails`: Recruiter messages, interview invitations, and status summary.
  163. - `naukri://taxonomy/versions`: Standardized entity taxonomies for certifications, cities, and languages.
  164. ---
  165. ## 🧪 Running Automated Tests
  166. ```bash
  167. # Run unit tests
  168. python -m unittest discover -s tests -p 'test_*.py'
  169. # Run strict type checking with pyrefly
  170. pyrefly check --preset strict .
  171. ```
  172. ---
  173. ## 📄 License
  174. MIT License.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.