Government Scheme MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Government Scheme MCP Server Search for schemes for farmers in Punjab with income below 5 lakh"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpFrom 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-mcpEnvironment 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 identifiername: Scheme namedescription: Detailed descriptiondepartment: Government departmentcategory: 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 timelinesterms_and_conditions: Terms and conditions text for the schemescheme_raw_text: Raw, unstructured text of scheme detailsofficial_website: Official scheme website URLapplication_link: Direct application form/link URLurl: Official scheme URL (legacy field)contact: Contact informationDemographics:
min_age,max_age,gendersEconomic:
income_min,income_max,employment_statusSocial:
social_categories,marital_statuses,religions,disabilitiesGeographic:
states,districts,urban_ruralRequirements:
required_documents,caste_required,domicile_requiredStatus:
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 updateAll 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/descriptionage: User age for eligibility filteringincome: User income levelgender: 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 affiliationstate: State/UT namedistrict: District nameurbanRural: Area type (urban, rural)profession: Professional categorycasteRequired: Filter by caste certificate requirementdomicileRequired: Filter by domicile certificate requirementcategory: Scheme category filterbenefitType: Benefit type filteractive: Active schemes onlylimit: 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
pytestCode 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 endpointPOST /api/schemes: Create new schemeGET /api/schemes/{id}: Retrieve scheme by IDPATCH /api/schemes/{id}: Update scheme by ID (partial update)DELETE /api/schemes/{id}: Delete scheme by IDPOST /api/schemes/search: Search schemes with filters
License
MIT License - see LICENSE file for details.
Contributing
Fork the repository
Create a feature branch
Make your changes
Add tests if applicable
Run the test suite
Submit a pull request
Support
For issues and questions:
Open an issue on GitHub
Check the documentation
Related Projects
Available Tools
6 toolscreate_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
Scored across 6 tools
Each tool has a distinct purpose: CRUD operations (create, delete, read, update), search with filtering, and health check. No overlap or ambiguity.
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.
Six tools is appropriate for a scheme management server: full CRUD plus search and health check. Not too many, not too few.
Covers all essential operations: create, read, update, delete, and search with eligibility criteria. Health check ensures connectivity. No obvious gaps for the domain.
Maintenance
Related MCP Connectors
Deterministic eligibility checker for grants, jobs and scholarships in Africa.
Search US grants + federal contracts (Grants.gov + SAM.gov) from any LLM.
Find US federal grants your organization is actually eligible to apply for. Free, no API key.
Search open grants, tenders and fellowships from official sources, with facts and official links.
Related MCP Servers
AlicenseNot gradedqualityDmaintenanceProvides agricultural intelligence tools for pest/disease lookup, government scheme discovery, and SME knowledge retrieval via semantic search.MIT- FlicenseNot gradedqualityDmaintenanceEnables searching live myScheme.gov.in schemes by eligibility, keyword, and detail lookup through MCP tools.-
- AlicenseAqualityCmaintenanceEnables 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.8MIT
- AlicenseAqualityCmaintenanceEnables 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.6MIT