sih-mcp
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., "@sih-mcp show open SIH 2026 problem statements with the fewest ideas"
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.
SIH-CLI-MCP
Scrapes the Smart India Hackathon 2026 problem statements and exposes them as a CLI (sih) and an MCP server (sih-mcp) so you or an agent can search, filter and sort them.
The site has no API. The table and each statement's details are server-rendered, so they are parsed from the HTML and cached for 6 hours.
Setup
Requires uv.
git clone https://github.com/kry0sc0pic/SIH-CLI-MCP && cd SIH-CLI-MCP
uv sync
uv run sih refreshRun commands with uv run sih ..., or uv tool install . to get a plain sih on your PATH.
Related MCP server: MCP Knowledge Base Server
Concepts
Ranked search. A query is scored with BM25 over title, theme/organization/department and description (title hits weigh most). It handles plurals (
drones), prefixes (agri), typos (satelite) and related words (farmingalso finds agriculture, crop and farmer statements; the synonym list is insrc/sih/ranking.py). Statements matching only some of your words still appear, ranked lower; very weak matches next to strong ones are dropped.Closed statements. Once idea submissions close, the site shows "Idea Submissions Closed" instead of a count. Those statements are hidden by default. With
--closed(CLI) orinclude_closed(MCP) they are included, but always listed after open ones whatever the sort. Their idea count isnull/closed, never0, so--min-ideas/--max-ideasexclude them.Ideas. Shown as
submitted/cap, for example3/500.Dates are ISO
YYYY-MM-DD.--openmeans the deadline has not passed (statements with no parseable deadline are kept).
CLI
sih [COMMAND] [OPTIONS]sih search [QUERY]
Ranked search, filter and sort. Prints a table; --json prints machine-readable output including total and closed_hidden.
Option | Description |
| Free-text query, ranked by relevance. Optional. |
| Organization contains this text (case-insensitive). |
| Category, |
| Theme contains this text, for example |
| Department contains this text. |
| Bounds on ideas already submitted (low means less competition). |
| Only statements whose deadline has not passed. |
| Inclusive deadline range, |
|
|
| Reverse the sort. |
| Page size (default 20). |
| Skip the first N results. |
| Include statements whose submissions are closed (listed last). |
| JSON output. |
sih search "drone surveillance"
sih search --category software --theme agriculture --sort ideas
sih search --open --from 2026-10-20 --to 2026-10-31 --json
sih search "flood" --closed --limit 50sih show PS_NUMBER
Full details for one statement: organization, department, category, theme, ideas, deadline, dataset/YouTube/contact links and the complete description. Accepts SIH26265 or just 26265, and finds closed statements too. --json for JSON.
sih facets
Counts per category, theme and organization. Open statements only unless --closed.
sih refresh
Re-download from sih.gov.in and rewrite the cache. Other commands refresh automatically when the cache is older than 6 hours.
sih install AGENT
Register the MCP server with a coding agent. See Adding to agents.
sih mcp
Run the MCP server over stdio (same as sih-mcp).
MCP server
Tools:
Tool | Arguments |
|
|
|
|
|
|
| None. Forces a re-download. |
Each statement has: ps_number, ps_id, title, organization, department, category, theme, ideas (null when closed), ideas_cap, closed, deadline, description, youtube, dataset_links, contact.
Adding to agents
sih install AGENT # print the command or config snippet
sih install AGENT --apply # actually write itAGENT is one of claude, codex, gemini, cursor, opencode, claude-desktop, hermes, or all.
Option | Description |
| Perform the registration instead of printing it. |
|
|
How each agent is handled:
Agent | What |
| Runs |
| Runs |
| Adds |
| Adds |
| Adds |
| Adds |
| Print-only (its config is YAML): prints a |
JSON configs are merged without touching your other servers, and files that aren't plain JSON (for example with comments) are left alone with an error.
Manual registration, for any MCP client:
claude mcp add sih -- uv run --directory /path/to/SIH-CLI-MCP sih-mcpConfiguration
Environment variable | Default | Purpose |
|
| Page to scrape. |
|
| Where |
Development
uv run pytestTests run against a small synthetic copy of the page and never touch the network or your real cache. They include a test that starts the real sih-mcp server as a subprocess and talks MCP to it over stdio.
License
GPL-3.0-or-later. See LICENSE.
Available Tools
4 toolsget_problem_statementB
Full details for one problem statement by PS number (e.g. 'SIH26265') or numeric id ('26265').
Inputs: ps_number (required).
list_facetsA
Counts of problem statements per organization, category and theme (open ones only unless include_closed).
Inputs: include_closed.
refresh_problem_statementsA
Re-download the problem statements from sih.gov.in (cache otherwise lasts 6 hours).
Inputs: no named parameters.
search_problem_statementsA
Search/filter/sort problem statements.
query: free text, ranked by relevance (title weighs most; handles plurals, typos, prefixes and related words like
farming/agriculture/crop). Statements matching only some terms are included but rank lower.
organization/category/theme/department: case-insensitive substring filters (category is e.g. 'Software' or 'Hardware').
min_ideas/max_ideas: filter by number of ideas already submitted (low = less competition). Statements with closed
submissions have no count (ideas is null, closed is true): they are excluded by these filters and sorted last when sorting by ideas.
open_only: exclude statements whose deadline has passed.
deadline_from/deadline_to: inclusive ISO dates (YYYY-MM-DD) bounding the idea-submission deadline.
sort: relevance (default with a query), ps_number (default otherwise), title, organization, category, theme, ideas, deadline.
include_closed: closed statements (submissions closed, no idea count) are hidden by default; when included they
always come after open ones. closed_hidden in the result says how many were left out.
Descriptions are truncated unless full_description is true.
Inputs: desc, sort, limit, query, +12 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct operation: search for filtered lists, get for a single full record, list_facets for aggregate counts, and refresh for cache invalidation. There is no meaningful overlap that would cause misselection; an agent can route cleanly between browsing, lookup, aggregation, and refresh.
Three tools follow a clear verb_noun pattern (search_problem_statements, get_problem_statement, refresh_problem_statements), while list_facets uses a consistent verb but a vague domain noun. The deviation is minor and still readable, since the description clarifies that facets are problem-statement facets.
Four tools are well-scoped for a read-only problem-statement browsing service. Each tool earns its place: search, detail lookup, facet counts, and cache refresh are all necessary and non-redundant.
The surface covers the full read-only lifecycle for the domain: discovery via rich filtered search, full record retrieval, aggregate facet counts, and cache refresh. No create/update/delete operations are expected because the underlying data comes from sih.gov.in, and no obvious retrieval dead ends remain.
Maintenance
Related MCP Connectors
Make your knowledge agent-ready. One MCP endpoint, 5 connectors, 3 search modes.
Search and manage your team's knowledge from MCP clients.
Read-only AgentiScript concept search, catalog, authenticity, license, and approved asset discovery.
Agent-driven search: build, import, tune, search, and score result quality — all over MCP.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI models to perform IT service management operations on Freshservice, including managing tickets, changes, problems, releases, assets, projects, and more through a set of MCP tools.362MIT
- FlicenseCqualityDmaintenanceEnables semantic search over knowledge-base articles and listing of sample support tickets using MCP tools.4-
- FlicenseNot gradedqualityCmaintenanceEnables agents to search, read, publish, and report reuse of problem-solving solutions via MCP.-
- AlicenseBqualityCmaintenanceEnables MCP clients to search and manage customer support tickets, customer records, and knowledge base articles, with read-only and human-approved write workflows.81MIT