Skip to main content
Glama
krishnananbu

Naukri MCP Server

by krishnananbu

Naukri MCP Server 🚀

A Python MCP (Model Context Protocol) server that provides job-search tools, designed to connect with Gemini Spark as a custom Connected App.

Architecture

Gemini Spark (gemini.google.com)
       │
       │  MCP protocol over HTTP
       ▼
Your MCP Server (deployed on Render)
       │
       │  (future: scraping / API)
       ▼
   Naukri.com

Related MCP server: jobstack-mcp

Available Tools

Tool

Description

search_jobs

Search for job listings by role, location, and experience level

get_job_details

Get detailed information about a specific job

get_trending_roles

See trending/in-demand roles in a city

get_my_profile_summary

View your Naukri profile summary

Note: Currently uses demo data. Real Naukri integration can be added later.


Quick Start (Local)

1. Create a virtual environment

python -m venv venv

# Windows
venv\Scripts\activate

# macOS/Linux
source venv/bin/activate

2. Install dependencies

pip install -r requirements.txt

3. Run the server

python server.py

The server starts at: http://localhost:8000/mcp

4. Test with the MCP CLI (optional)

# In a separate terminal
mcp client http://localhost:8000/mcp

Then try calling a tool:

> call search_jobs {"query": "Data Analyst", "location": "Chennai"}

Deploy to Render

Option A: One-click deploy (Blueprint)

  1. Push this repo to GitHub

  2. Go to Render DashboardNewBlueprint

  3. Connect your GitHub repo

  4. Render will detect render.yaml and set everything up automatically

  5. Your MCP URL will be: https://naukri-mcp-server.onrender.com/mcp

Option B: Manual setup

  1. Push this repo to GitHub

  2. Go to Render DashboardNewWeb Service

  3. Connect your GitHub repo

  4. Configure:

    • Build Command: pip install -r requirements.txt

    • Start Command: python server.py

    • Plan: Free

  5. Deploy!

⚠️ Free tier services spin down after inactivity. The first request after idle may take ~30 seconds.


Connect to Gemini Spark

Once deployed, connect your MCP server to Gemini:

  1. Open gemini.google.com on a computer

  2. Go to SettingsConnected Apps (or Personal Intelligence)

  3. Look for "Custom apps for Spark" or "Other apps"

  4. Click "Add a custom app"

  5. Enter:

    • Name: Naukri Job Search

    • MCP Server URL: https://naukri-mcp-server.onrender.com/mcp

  6. Save and start chatting!

Example prompts

"Find Data Analyst jobs in Chennai for freshers"

"What are the trending tech roles in Bangalore right now?"

"Show me details for job JOB-123456"

"Review my Naukri profile and suggest improvements"


Project Structure

naukri_mcp/
├── server.py            # Main MCP server with tools
├── requirements.txt     # Python dependencies
├── Procfile             # Start command for Render
├── render.yaml          # Render deployment blueprint
├── .gitignore           # Git ignore rules
└── README.md            # This file

Tech Stack

  • MCP Python SDK — FastMCP with Streamable HTTP transport

  • Render — Free-tier cloud deployment

  • Python 3.12+


Roadmap

  • Demo MCP server with mock data

  • Real Naukri job search (web scraping)

  • Profile sync from Naukri

  • Job application tracking

  • Resume analysis tool

  • Interview prep tool

License

MIT

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • CareerProof MCP gives AI agents direct access to a professional-grade career and workforce intelligence platform. Two namespaces: atlas_* for HR/TA teams (candidate evaluation, batch shortlisting, competency scoring, interview generation, JD analysis, custom eval frameworks, research reports) and ceevee_* for professionals (CV optimization, career positioning, salary intelligence, market reports). Backed by RAG knowledge from 50+ premium research sources (McKinsey, BCG, HBR, Gartner, WEF)

  • GetJobzi MCP server for job search, application tracking, and career forecasting.

  • 7 recruiting tools over one MCP endpoint: ATS boards, LinkedIn jobs, profiles, companies, Naukri.

  • # **RChilli MCP Hub** RChilli MCP Hub is a production-grade MCP server that exposes RChilli's full HR data intelligence platform as 17 AI-callable tools across 4 categories. Built on 15+ years of HR data intelligence, it is trusted by ATS vendors, HR technology platforms, staffing agencies, and enterprise recruiting teams worldwide. Every tool is read-only and returns a consistent, structured JSON response — no raw exceptions, no inconsistent formats. <br> --- <br> # **Tools — 17 Total** userkey and subuserid are injected automatically from your Bearer token — you never need to pass them manually. <br> --- <br> # **🔍 Resume & Job Description Parsing — 3 tools** <br> > ### **`extract_resume_data`** > > Extracts and converts resumes, CVs, and candidate documents into structured, searchable profiles with contact details, skills, experience, education, certifications, and taxonomy-enriched data for ATS, HCM, and AI recruiting workflows. When used on a careers page or application form, the same extraction call auto-fills every application field in under 10 seconds — documented to increase candidate conversion by up to 194%. Supports 40+ languages with English-normalized output for global intake, and runs in batch mode to process legacy databases or migration backlogs overnight at scale. Also supports resume reprocessing — re-running previously extracted resumes through the latest extraction logic and taxonomy version to bring older records up to current data quality, without requiring a new document from the candidate. Distinct from bulk import (first-time extraction of a new batch) and from talent data refresh (re-enrichment from a newer submitted resume). <br> > ### **`extract_resume_data_from_url`** > > Accepts a direct URL to a PDF, DOCX, or RTF file and returns the same normalized JSON profile as the Resume Data Extraction tool. Ideal for pipeline automation where resumes are stored in cloud storage, S3, or email attachments. Also supports the same auto-fill, multilingual, and batch-processing capabilities as the core extraction tool for URL-based intake sources. <br> > ### **`extract_job_data`** > > Extracts and converts job descriptions into structured hiring data including job title, required skills, preferred skills, responsibilities, experience, education, and taxonomy-normalized role requirements for recruitment automation and candidate matching. <br> --- <br> # **🧠 Skills & Job Taxonomy — 4 tools** <br> > ### **`lookup_skill`** > > Returns authoritative detail for a known skill including description, all aliases, related skills, proficiency levels, and O*NET/ESCO mappings. Use when you need the complete record rather than a ranked search. <br> > ### **`lookup_job_profile`** > > Returns authoritative detail for a known job profile including canonical title, SOC/O*NET code, job family, typical required and preferred skills, salary bands, and work context. <br> > ### **`autocomplete_skill`** > > Accepts a partial skill string (min 2 chars) and returns up to 10 ranked autocomplete suggestions with canonical names and categories. Prevents free-text entry errors and keeps skill data clean at point of entry. <br> > ### **`autocomplete_job_profile`** > > Accepts a partial job title string and returns ranked autocomplete suggestions with canonical titles and job families. Ensures job titles map to taxonomy profiles from the moment a recruiter starts typing. <br> --- <br> # **🛡️ Redaction, Documents & Utilities — 7 tools** <br> > ### **`redact_resume`** > > Redacts personally identifiable information from candidate profiles to support anonymized review, bias-aware screening, compliance workflows, and audit logs. Configurable redaction scope. Idempotent. <br> > ### **`reformat_resume_with_template`** > > RChilli's Resume Reformatting tool accepts any structured candidate profile and applies one of six branded templates (TM001–TM006) to produce a consistently formatted output document in PDF, DOCX, RTF, or HTML — ensuring every candidate is presented in a standardized, professional layout regardless of how their original resume was structured. Designed for staffing firms, recruitment agencies, and enterprise HR teams who need to control candidate presentation at scale, it eliminates manual reformatting effort and enforces brand consistency across all submissions. <br> > ### **`convert_document_format`** > > Accepts a document as base64 or URL and converts between PDF, DOCX, RTF, HTML, and plain text. Preserves formatting fidelity. Useful as a pre-processing step before data extraction on non-standard file types. <br> > ### **`tag_entities`** > > RChilli's Named Entity Recognition tool takes already-extracted HR text and annotates it by wrapping each recognized entity in a structured XML-style label inline — returning output such as `<job_title>Senior Data Engineer</job_title>`, `<skill>Python</skill>`, `<city>Austin</city>`, `<degree>Bachelor of Science</degree>`, and `<organization>Google</organization>` — covering 10+ HR-specific entity types including person name, state, country, date, and year. Unlike data extraction tools that produce separate field lists, tag_entities preserves the full original text structure with entities labeled in place, making the output immediately consumable by ATS field-mapping pipelines, candidate profile builders, and content annotation workflows without any offset calculation or post-processing. <br> > ### **`extract_contacts`** > > Identifies and structures names, emails, phone numbers, LinkedIn URLs, and addresses with field-level confidence scores from candidate records, emails, or documents. Safe for GDPR/CCPA workflows. <br> > ### **`geolocate`** > > Converts partial or informal location text into structured city, state, country, ISO codes, latitude, and longitude. Enables radius-based candidate and job search and supports workforce planning analytics. <br> > ### **`classify_job_zone`** > > RChilli's Job Zone Classification tool reads the job profile from a resume or job description and returns its O/*NET Job Zone — one of five standardized levels ranging from Zone 1 (little or no preparation required) through Zone 2 (some preparation), Zone 3 (medium preparation), Zone 4 (considerable preparation), to Zone 5 (extensive preparation required) — based on the education, experience, and training criteria defined by O/*NET. The returned Job Zone level enables downstream workflows such as candidate-to-role fit filtering, compensation benchmarking, over/under-qualification flagging, and job architecture standardization without any manual O/*NET lookup. <br> --- <br> # **🎯 Search & Matching — 3 tools** <br> > ### **`score_resume_against_jd`** > > Accepts one resume and one Job Description (no index required) and returns an overall match score, dimension scores, skill gap list, and natural-language explanation. Bias-controlled and audit-ready. <br> > ### **`find_matches_in_index`** > > Accepts a resume or Job Description as input and returns the top-N most similar documents from the indexed corpus ranked by semantic similarity. No index setup required for the input document. <br> > ### **`search_indexed_documents`** > > Accepts a query string and returns ranked document references from the tenant's pre-populated index. Supports Boolean and semantic search modes. Requires documents to be indexed before use.

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Enables searching over 1 million enriched job listings from 20,000+ companies directly from MCP-compatible AI tools. Provides tools for job search, company profiles, and AI-powered similar job recommendations with real-time data updates.
    4
    72
    2
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables searching and retrieving job postings from multiple job boards (USAJOBS, Adzuna, Jooble, The Muse, Reed, and ATS) through the JobStack API, exposing search_jobs and get_job as MCP tools.
    -
  • A
    license
    B
    quality
    B
    maintenance
    Enables automation of your own Naukri.com account for job search, job details, applications, saved jobs, profile viewing, and recruiter messaging through MCP-compatible clients.
    17
    MIT