Skip to main content
Glama
India Schemes MCP Server

India Schemes MCP Server

by waqarbytes

🇮🇳 India Schemes MCP Server (india-schemes-mcp)

🌐 Product layer over this data: Yojana Dost — live at https://yojana-dost.onrender.com/

Tests MCP TypeScript License: MIT

A production-grade Model Context Protocol (MCP) server providing structured tools for Claude Desktop, Cursor, and any MCP client to search, analyze, compare, and verify eligibility for 120+ Indian Central and State Government Welfare Schemes.


🛠️ MCP Tools Exposed

This server exposes 6 production-grade tools with strict Zod schema validation and structured stderr diagnostic logging:

Tool Name

Parameters

Description

search_schemes

query, category?, state?, limit?

Full-text and keyword search across 120+ schemes with relevance scoring and filter support.

get_scheme

scheme_id

Retrieves complete verified details for a specific scheme (ministry, benefits, eligibility, rules, official URL).

check_eligibility

scheme_id, user_profile (age, gender, state, income, caste, land, occupation, disability)

Deterministic eligibility evaluation against official scheme criteria with detailed pass/fail breakdown.

get_deadline

scheme_id

Returns application deadlines, rolling enrollment cycles, renewal schedules, and official timeline rules.

compare_schemes

scheme_ids (array of 2–5 IDs)

Generates side-by-side comparison matrix across benefits, eligibility thresholds, and required documentation.

get_application_steps

scheme_id

Step-by-step citizen application roadmap, portal URLs, offline submission offices, and document checklist.


Related MCP server: PlainGov-MCP

🚀 Quickstart & Installation

Prerequisites

  • Node.js >= 20.0.0

  • npm >= 10.0.0

1. Clone & Build

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

2. Test with MCP Inspector

Inspect and interact with all 6 tools using the official Model Context Protocol Inspector UI:

npm run inspect

💻 Claude Desktop Configuration

To connect this server to Claude Desktop, add the configuration below to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "india-schemes": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/india-schemes-mcp/dist/index.js"
      ],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Restart Claude Desktop, and click the 🔨 icon in chat to verify all 6 tools are loaded.


🧪 Testing

Run the full Vitest suite testing repository lookups, rule evaluation operators, token-bucket rate limiters, and tool schemas:

npm test

🏛️ Architecture & Reliability

  • Standard IO Transport: Connects via @modelcontextprotocol/sdk/server/stdio.js for zero-overhead local IPC.

  • Strict Error Handling: Errors return structured MCP text payloads with error codes rather than unhandled process terminations.

  • In-Memory Cache & Concurrency Protection: Scheme records are safely parsed and cached on demand.

  • Process Lifecycle: Clean SIGINT and SIGTERM listeners guarantee graceful shutdown.


📜 License

MIT License. Copyright (c) 2026 Mohd Waqar.

Available Tools

6 tools
check_eligibilityCheck Scheme EligibilityC

Evaluate whether an applicant qualifies for a government scheme based on their profile (age, income, occupation, state, etc.) using a data-driven rules engine.

Inputs: scheme_id (required), user_profile (required).

compare_schemesCompare SchemesB

Perform side-by-side comparative analysis of up to 5 government welfare schemes across benefits, eligibility rules, and deadlines.

Inputs: scheme_ids (required).

get_application_stepsGet Application StepsB

Retrieve sequential, ordered application instructions and verified official portal links for any government scheme.

Inputs: scheme_id (required).

get_deadlineGet Scheme DeadlineB

Check the application deadline, remaining days, and open/closed enrollment status for an Indian government scheme.

Inputs: scheme_id (required).

get_schemeGet Scheme DetailsB

Fetch complete details of a specific Indian government scheme by its unique ID, including eligibility rules, benefits, deadlines, and application links.

Inputs: scheme_id (required).

search_schemesSearch SchemesB

Search Indian government welfare schemes using keywords with relevance scoring. Supports optional filtering by category and state.

Inputs: query (required), limit, state, category.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 6 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes: search, fetch details, eligibility check, deadline check, comparison, and application steps. However, get_scheme already returns deadlines and application links, so it slightly overlaps with get_deadline and get_application_steps, which could cause occasional misselection.

    Naming Consistency5/5

    All tool names follow a consistent snake_case verb_noun or verb_noun_phrase pattern: get_scheme, search_schemes, check_eligibility, get_deadline, compare_schemes, get_application_steps. The convention is predictable throughout.

    Tool Count5/5

    Six tools are well-scoped for a government scheme information server. Each tool covers a distinct user need: discovery, detail lookup, eligibility, deadline tracking, comparison, and application guidance.

    Completeness5/5

    The tool set covers the full read-only lifecycle for Indian government welfare schemes: search, inspect, evaluate eligibility, check deadlines, compare options, and retrieve application steps. No obvious operation is missing for this domain.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Retrieves and explains government program information from official Canadian sources using a strict retrieval-first approach, with deterministic eligibility checks and full source attribution.
      6
      7 npm
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to answer questions about Finnish social benefits (Kela) by providing tools for searching, checking eligibility, and getting application steps.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables searching live myScheme.gov.in schemes by eligibility, keyword, and detail lookup through MCP tools.
      -