mcp-india-tenders

MCP India Tenders Server

   

An MCP (Model Context Protocol) server for searching and analyzing Indian government tenders from multiple portals including CPPP (Central Public Procurement Portal), eProc Rajasthan, and Defence Ministry tenders.

Overview

This server provides AI assistants (Claude, Cursor, etc.) with real-time access to Indian government tender data in OCDS (Open Contracting Data Standard) format. It enables automated tender discovery, analysis, and monitoring for businesses bidding on government contracts.

Features

• Multi-Portal Support: CPPP, eProc Rajasthan, Defence portals
• OCDS-Compliant: Structured data following Open Contracting standard
• Advanced Search: Filter by keyword, state, value, closing date
• Tender Analytics: Budget, funding, bidder analysis
• Caching: Optimized performance with intelligent caching
• AI-Friendly: Natural language queries through MCP interface
• Docker Ready: Easy deployment with Docker/Docker Compose

Quick Start

Installation

git clone https://github.com/switchr24/mcp-india-tenders.git
cd mcp-india-tenders
npm install
npm run build

Running the Server

Development: ``bash npm run dev ``

Production: ``bash npm start ``

With Docker

docker build -t mcp-india-tenders .
docker run -p 3000:3000 mcp-india-tenders

MCP Tools

search_tenders

Search for tenders across all portals with filters

Parameters:

• keyword (required): Tender search term (e.g., "road sweeper", "waste compactor")
• state (optional): State filter (e.g., "RAJASTHAN", "MAHARASHTRA")
• minValue (optional): Minimum tender value in INR
• closingWithinDays (optional): Tenders closing in N days (default: 60)
• limit (optional): Max results (default: 20, max: 100)

Example: ``json { "keyword": "road sweeper Rajasthan", "minValue": 1000000, "closingWithinDays": 30, "limit": 10 } ``

get_tender_details

Fetch detailed OCDS-compliant tender information

Parameters:

• tenderId (required): Tender ID or OCID
• format (optional): 'full' or 'summary'

search_by_location

Search tenders by city/district and state

Parameters:

• location (required): City name (e.g., "Jaipur")
• state (required): State code (e.g., "RJ")
• limit (optional): Max results

search_by_organisation

Find tenders by procuring ministry/department

Parameters:

• organisation (required): Ministry/Department name
• limit (optional): Max results

Configuration

Claude Desktop Integration

Edit ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "india-tenders": {
      "command": "node",
      "args": ["/path/to/mcp-india-tenders/build/index.js"]
    }
  }
}

VS Code Cline Integration

Add to Cline MCP settings:

{
  "mcpServers": {
    "india-tenders": {
      "command": "node",
      "args": ["/path/to/mcp-india-tenders/build/index.js"]
    }
  }
}

Usage Examples

Example 1: Find Rajasthan Tenders

User: "Show me all waste equipment tenders in Rajasthan above 5 lakhs closing in 30 days"

MCP Call: search_tenders(
  keyword="waste equipment",
  state="RAJASTHAN",
  minValue=5000000,
  closingWithinDays=30
)

Example 2: Analyze Specific Tender

User: "Get full details and analysis for tender CPPP-12345"

MCP Call: get_tender_details(
  tenderId="CPPP-12345",
  format="full"
)

Example 3: Location-based Search

User: "Find all government tenders in Jaipur"

MCP Call: search_by_location(
  location="Jaipur",
  state="RJ",
  limit=20
)

Supported Portals

| Portal | URL | Coverage | Status | |--------|-----|----------|--------| | CPPP | eprocure.gov.in | All Central Ministries | ✅ Supported | | eProc Rajasthan | eproc.rajasthan.gov.in | Rajasthan State | ✅ Supported | | Defence | defproc.gov.in | Ministry of Defence | ✅ Supported | | GeM | gem.gov.in | Goods & Services | ⚠️ Planning | | State Portals | Various | Individual States | 🔄 Expanding |

Project Structure

mcp-india-tenders/
├── src/
│   ├── index.ts                 # MCP server entry
│   ├── api/
│   │   ├── eprocure-client.ts   # CPPP API client
│   │   ├── rajasthan-client.ts  # Rajasthan eProc client
│   │   └── defence-client.ts    # Defence portal client
│   ├── handlers/
│   │   ├── tools.ts             # MCP tool definitions
│   │   └── resources.ts         # MCP resources
│   ├── models/
│   │   ├── tender.ts            # OCDS schemas
│   │   └── portal.ts            # Portal config
│   └── utils/
│       ├── logger.ts            # Logging
│       └── cache.ts             # Caching layer
├── build/                       # Compiled JavaScript
├── package.json
├── tsconfig.json
├── Dockerfile
└── docker-compose.yml

Development

Building

npm run build

Testing

npm run test

Using MCP Inspector

npm run inspector

Roadmap

• [ ] Add more state portals (Gujarat, Maharashtra, Karnataka)
• [ ] Integration with n8n for automation
• [ ] Tender analytics dashboard
• [ ] Email alerts for matching tenders
• [ ] Bid success prediction model
• [ ] Document OCR for tender analysis
• [ ] API Gateway for REST access

Performance Optimization

• Caching: 5-minute cache for searches, 1-hour for details
• Rate Limiting: Respectful scraping with delays
• Pagination: Efficient data retrieval
• Compression: Gzip response compression

Error Handling

The server gracefully handles:

• Portal downtime
• Network timeouts
• CAPTCHA blocking
• Malformed data
• Rate limiting

Legal & Terms

• Uses publicly available government tender data
• Respects portal terms of service
• No authentication credentials stored
• Respectful scraping practices

Contributing

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

Support

• Issues: Report bugs on GitHub Issues
• Discussions: Ask questions in GitHub Discussions
• Email: support@ensol.com

License

MIT License - see LICENSE file

Author

Created by Ensol Multiclean Equipment for government tender automation

---

Last Updated: December 31, 2025 Version: 1.0.0