Skip to main content
Glama
Government Scheme MCP Server

Government Scheme MCP Server

Government Scheme MCP Server

A Model Context Protocol (MCP) server for accessing and managing Indian Government Schemes database. This server provides tools for searching, creating, and managing government benefit schemes with comprehensive eligibility filtering.

Features

  • Health Check: Verify server connectivity and API status

  • Scheme Search: Advanced filtering by demographics, geography, income, and eligibility criteria

  • Scheme Management: Create and retrieve government scheme records

  • Comprehensive Filtering: Support for age, gender, income, employment status, social categories, disabilities, and more

Related MCP server: myscheme

Installation

From PyPI (when published)

pip install gov-scheme-mcp

From Source

git clone https://github.com/magicstack-llp/gov-scheme-mcp-py
cd gov-scheme-mcp
pip install -e .

Usage

As an MCP Server

The server can be used with any MCP-compatible client:

gov-scheme-mcp

Environment Variables

  • GOV_API_URL: Base URL for the government schemes API (default: http://localhost:3000)

Available Tools

health()

Check server health and API connectivity.

Returns: JSON with connection status and API endpoint information.

create_scheme(...)

Create a new government scheme record with comprehensive metadata.

Parameters:

  • code: Unique scheme identifier

  • name: Scheme name

  • description: Detailed description

  • department: Government department

  • category: Program domain (education, health, agriculture, etc.)

  • benefit_type: Type of benefit (cash, subsidy, scholarship, loan, insurance, pension, grant, in-kind)

  • benifit_details: Detailed description of benefit structure, payouts, and timelines

  • terms_and_conditions: Terms and conditions text for the scheme

  • scheme_raw_text: Raw, unstructured text of scheme details

  • official_website: Official scheme website URL

  • application_link: Direct application form/link URL

  • url: Official scheme URL (legacy field)

  • contact: Contact information

  • Demographics: min_age, max_age, genders

  • Economic: income_min, income_max, employment_status

  • Social: social_categories, marital_statuses, religions, disabilities

  • Geographic: states, districts, urban_rural

  • Requirements: required_documents, caste_required, domicile_required

  • Status: is_active

read_scheme(id)

Fetch a single scheme by numeric ID.

Parameters:

  • id: Numeric scheme ID

update_scheme(id, ...)

Update an existing scheme by ID. Only provided fields will be changed.

Parameters:

  • id: Numeric scheme ID to update

  • All other fields are the same as create_scheme(...) and are optional

delete_scheme(id)

Delete a scheme by ID.

Parameters:

  • id: Numeric scheme ID to delete

search_schemes(...)

Search schemes with advanced filtering capabilities.

Parameters:

  • q: Text search in name/description

  • age: User age for eligibility filtering

  • income: User income level

  • gender: Gender filter (male, female, other)

  • employmentStatus: Employment status (unemployed, farmer, student, salaried, entrepreneur)

  • disabilities: Disability categories (visual, hearing, mobility, intellectual, multiple, other)

  • socialCategories: Social categories (SC, ST, OBC, EWS, GENERAL)

  • maritalStatus: Marital status (single, married, divorced, widowed)

  • religion: Religious affiliation

  • state: State/UT name

  • district: District name

  • urbanRural: Area type (urban, rural)

  • profession: Professional category

  • casteRequired: Filter by caste certificate requirement

  • domicileRequired: Filter by domicile certificate requirement

  • category: Scheme category filter

  • benefitType: Benefit type filter

  • active: Active schemes only

  • limit: Maximum results (default: 100)

  • offset: Result offset (default: 0)

Configuration for MCP Clients

Claude Desktop

Add to your claude_desktop_config.json:

{
	"mcpServers": {
		"gov-scheme-mcp": {
			"command": "gov-scheme-mcp",
			"env": {
				"GOV_API_URL": "https://your-api-server.com"
			}
		}
	}
}

Other MCP Clients

Configure the server command as gov-scheme-mcp with the appropriate environment variables.

Development

Setup

git clone https://github.com/magicstack-llp/gov-scheme-mcp-py
cd gov-scheme-mcp
pip install -e ".[dev]"

Testing

pytest

Code Formatting

black src/
isort src/

Type Checking

mypy src/

API Requirements

This MCP server requires a compatible government schemes API with the following endpoints:

  • GET /: Health check endpoint

  • POST /api/schemes: Create new scheme

  • GET /api/schemes/{id}: Retrieve scheme by ID

  • PATCH /api/schemes/{id}: Update scheme by ID (partial update)

  • DELETE /api/schemes/{id}: Delete scheme by ID

  • POST /api/schemes/search: Search schemes with filters

License

MIT License - see LICENSE file for details.

Contributing

  1. Fork the repository

  2. Create a feature branch

  3. Make your changes

  4. Add tests if applicable

  5. Run the test suite

  6. Submit a pull request

Support

For issues and questions:

Available Tools

6 tools
create_schemeA

Create a new government scheme record. Pass only valid fields; unknown fields are ignored. Returns the created row as JSON.

Args:
    code: Unique code for the scheme
    name: Name of the scheme
    description: Description of the scheme
    department: Department offering the scheme
    category: Program domain (education, health, agriculture, housing, women, child, senior, disability, minority, entrepreneurship, employment, skill, welfare)
    benefit_type: Type of benefit (cash, subsidy, scholarship, loan, insurance, pension, grant, in-kind)
    benifit_details: Detailed description of the benefit structure, payouts, timelines
    terms_and_conditions: Terms and conditions text for the scheme
    scheme_raw_text: Raw, unstructured text of scheme details scraped or provided
    official_website: Official scheme website URL
    application_link: Direct application form/link URL
    url: Official URL for the scheme
    contact: Contact information
    min_age: Minimum age requirement
    max_age: Maximum age requirement
    genders: List of allowed genders (male, female, other)
    income_min: Minimum income requirement
    income_max: Maximum income requirement
    employment_status: List of employment statuses (unemployed, farmer, student, salaried, entrepreneur)
    disabilities: List of applicable disabilities (visual, hearing, mobility, intellectual, multiple, other)
    social_categories: List of social categories (SC, ST, OBC, EWS, GENERAL)
    marital_statuses: List of marital statuses (single, married, divorced, widowed)
    religions: List of applicable religions
    states: List of applicable states/UTs
    districts: List of applicable districts
    urban_rural: List of area types (urban, rural)
    professions: List of applicable professions
    required_documents: List of required documents
    caste_required: Whether caste certificate is required
    domicile_required: Whether domicile certificate is required
    is_active: Whether the scheme is active

Inputs: code, name, description, department, +27 more. Returns: result

delete_schemeB

Delete a scheme by ID.

Args:
    id: The numeric ID of the scheme to delete

Inputs: id (required). Returns: result

healthA

Check server health and API connectivity. Returns JSON with ok/api/error.

Inputs: no named parameters. Returns: result

read_schemeA

Fetch a single scheme by numeric ID.

Args:
    id: The numeric ID of the scheme to fetch

Inputs: id (required). Returns: result

search_schemesA

Search schemes by user profile/filters. Supports various criteria for eligibility matching.

Args:
    q: Text to match in name/description
    age: Age of the user
    income: Income of the user
    gender: Gender (male, female, other)
    employmentStatus: Employment status (unemployed, farmer, student, salaried, entrepreneur)
    disabilities: Disabilities (visual, hearing, mobility, intellectual, multiple, other)
    socialCategories: Social categories (SC, ST, OBC, EWS, GENERAL)
    maritalStatus: Marital status (single, married, divorced, widowed)
    religion: Religion
    state: State/UT name
    district: District name
    urbanRural: Area type (urban, rural)
    profession: Profession
    casteRequired: Whether caste certificate is required
    domicileRequired: Whether domicile certificate is required
    category: Program category
    benefitType: Type of benefit (cash, subsidy, scholarship, loan, insurance, pension, grant, in-kind)
    active: Whether to only include active schemes
    limit: Maximum number of results (default: 100)
    offset: Number of results to skip (default: 0)

Inputs: q, age, income, gender, +16 more. Returns: result

update_schemeA

Update a government scheme record by ID. Pass only fields to change.

Args:
    id: The numeric ID of the scheme to update
    Other params: Same as in `create_scheme`; only provided values will be updated

Inputs: id (required), code, name, description, +28 more. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a distinct purpose: CRUD operations (create, delete, read, update), search with filtering, and health check. No overlap or ambiguity.

    Naming Consistency4/5

    Tools follow a verb_noun pattern (e.g., create_scheme, delete_scheme), with 'health' as a simple noun. Minor inconsistency: 'search_schemes' uses plural but is still clear.

    Tool Count5/5

    Six tools is appropriate for a scheme management server: full CRUD plus search and health check. Not too many, not too few.

    Completeness5/5

    Covers all essential operations: create, read, update, delete, and search with eligibility criteria. Health check ensures connectivity. No obvious gaps for the domain.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables searching live myScheme.gov.in schemes by eligibility, keyword, and detail lookup through MCP tools.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables users to find Korean government benefits they are eligible for by matching age, gender, income, life stage, and household status against the official Gov24 catalog of 10,000+ programs, and provides eligibility details, missing-info questions, and upcoming deadlines.
      8
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables Claude Desktop and other MCP clients to search, retrieve, compare, and check eligibility for 120+ Indian central and state government welfare schemes, including deadlines and application steps. It provides structured tools for scheme details, eligibility breakdowns, comparisons, and application roadmaps.
      6
      MIT