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

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:

• Open an issue on GitHub
• Check the documentation

Related Projects

• Model Context Protocol
• MCP Python SDK