> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MoSPI MCP

> India's official statistics from the Ministry of Statistics and Programme Implementation, queryable via natural language.

![MoSPI MCP logo](https://mintcdn.com/composio-preview/9YPuzjEU4UlMnwGq/images/toolkits/mospi_mcp.svg?fit=max\&auto=format\&n=9YPuzjEU4UlMnwGq\&q=85\&s=f392ca07d6fb8f4760eaf138df93f5c8)

* **Category:** analytics
* **Auth:** NO\_AUTH
* **Composio-managed OAuth available?** N/A
* **Tools:** 4
* **Triggers:** 0
* **Slug:** `MOSPI_MCP`
* **Version:** 20261018\_00

## Tools

> [accordion] Get data
>
> **Slug:** `MOSPI_MCP_GET_DATA`
>
> Fetches statistical data from a MoSPI dataset.
>
> This is the final step of the workflow. It requires filter values from get\_metadata ΓÇö filter codes are arbitrary (e.g., indicator\_code=3 means "Unemployment Rate" in PLFS but something different in other datasets).
>
> All filter parameters including limit and page go inside the filters dict, not as top-level arguments.
>
> Step 4 of: list\_datasets ΓåÆ get\_indicators ΓåÆ get\_metadata ΓåÆ get\_data
>
> #### Input Parameters
>
> **dataset** `string` *required*
>
> Dataset name (PLFS, CPI, IIP, ISP, ASI, NAS, WPI, ENERGY,      AISHE, ASUSE, GENDER, NFHS, ENVSTATS, RBI, NSS77,      NSS78, NSS76, NSS75E, NSS79, CPIALRL, HCES, TUS, EC, UDISE, MNRE, NSS80, NSS73).      CPI auto-routes to Group or Item endpoint based on      whether filters contain item\_code.      IIP uses a single endpoint; pass frequency="Annually" or      frequency="Monthly" in filters.
>
> **filters** `object` *required*
>
> Key-value pairs from get\_metadata filter\_values.      PLFS requires frequency\_code (1=Annual, 2=Quarterly, 3=Monthly).      NAS requires base\_year ("2022-23" or "2011-12").      MNRE: indicator\_code (1-5) is mapped to type\_of\_renewable\_energy\_code.      Pass limit (e.g., "50") to retrieve more than 10 records.

> [accordion] Get indicators
>
> **Slug:** `MOSPI_MCP_GET_INDICATORS`
>
> Returns the full list of available indicators for a given dataset.
>
> Datasets often have broader coverage than expected ΓÇö for example, ASI covers 57 indicators (capital structure, wages, employment, GVA, fuel consumption), and GENDER covers 147 indicators across health, education, labor, and crime.
>
> For PLFS and ASUSE, indicators are grouped by frequency\_code:
>
> * PLFS frequency\_code=1 (Annual): all 8 indicators including wages
> * PLFS frequency\_code=2 (Quarterly): indicators 1-3 only
> * PLFS frequency\_code=3 (Monthly): indicators 1-3 only frequency\_code selects the indicator set, not time granularity.
>
> Step 2 of: list\_datasets ΓåÆ get\_indicators ΓåÆ get\_metadata ΓåÆ get\_data
>
> #### Input Parameters
>
> **level** `string`
>
> **Format** `string`
>
> **series** `string`
>
> **dataset** `string` *required*
>
> Dataset name ΓÇö one of: PLFS, CPI, IIP, ISP, ASI, NAS, WPI,      ENERGY, AISHE, ASUSE, GENDER, NFHS, ENVSTATS, RBI,      NSS77, NSS78, NSS76, NSS75E, NSS79, CPIALRL, HCES, TUS, EC, UDISE, MNRE, NSS80, NSS73.      For CPI, IIP, ISP, WPI: returns available base years and frequencies.
>
> **base\_year** `string`
>
> **frequency** `string`
>
> **user\_query** `string`
>
> The user's original question. Captured for telemetry analytics; not echoed back in the response.
>
> **frequency\_code** `string`
>
> **classification\_year** `string`

> [accordion] Get metadata
>
> **Slug:** `MOSPI_MCP_GET_METADATA`
>
> Returns the valid filter values (states, years, quarters, etc.) for a given dataset and indicator.
>
> Filter codes are arbitrary and dataset-specific ΓÇö for example, PLFS state\_code 99 means "All India", and NAS frequency\_code 1 means "Annual". These values cannot be inferred or guessed from parameter names alone.
>
> The returned filter\_values and api\_params should be used as-is when calling get\_data.
>
> Step 3 of: list\_datasets ΓåÆ get\_indicators ΓåÆ get\_metadata ΓåÆ get\_data
>
> #### Input Parameters
>
> **type** `string`
>
> **level** `string`
>
> Required for CPI ("Group"/"Item").
>
> **Format** `string`
>
> **module** `string`
>
> For NSS77 only ΓÇö land\_livestock (portal nss77) or aidis (portal nss77a).     Required when indicator\_code overlaps both modules (16-19, 24, 26, 29, 32, 34, 36).     Auto-derived for codes unique to one module.
>
> **series** `string`
>
> For CPI and NAS only ("Current"/"Back").
>
> **dataset** `string` *required*
>
> Dataset name (same values as get\_indicators).
>
> **base\_year** `string`
>
> Required for CPI ("2024"/"2012"/"2010"),        IIP ("2011-12"/"2004-05"/"1993-94"),        NAS ("2022-23"/"2011-12"),        WPI ("2011-12"/"2004-05"/"1993-94").        Not applicable for PLFS, ASI.
>
> **frequency** `string`
>
> Required for IIP ("Annually"/"Monthly").
>
> **state\_code** `string`
>
> For NAS only — required when indicator\_code is 23-34         (state-level GSDP/NSDP/GSVA family). Values 01-37, where         37 = All-India aggregate. Comma separated for multiple         states. Not applicable when frequency\_code=2 (Quarterly) —         state-level indicators have Annual data only.
>
> **survey\_code** `string`
>
> For NSS76 (1=Disability, 2=Housing & drinking water), NSS75E          (2=Education, indicators 43-55), NSS80 (1=Telecom (CMST), 2=Education (CMSE)),          and NSS77 AIDIS module (always 1).
>
> **frequency\_code** `string`
>
> Required for PLFS and ASUSE.             PLFS: 1=Annual, 2=Quarterly bulletin, 3=Monthly.             ASUSE: 1=Annual, 2=Quarterly.
>
> **indicator\_code** `string`
>
> Required for: PLFS, NAS, ENERGY, AISHE, ASUSE, GENDER,             NFHS, ENVSTATS, RBI, NSS77, NSS78, NSS76, NSS75E, NSS79, CPIALRL, HCES, TUS, EC, UDISE, MNRE, NSS80, NSS73.             Not applicable for: CPI, IIP, ISP, ASI, WPI.             For RBI, this maps to sub\_indicator\_code internally.
>
> **sub\_indicator\_code** `string`
>
> **classification\_year** `string`
>
> Required for ASI ("2008"/"2004"/"1998"/"1987").
>
> **use\_of\_energy\_balance\_code** `string`
>
> For ENERGY only (1=Supply, 2=Consumption).

> [accordion] List datasets
>
> **Slug:** `MOSPI_MCP_LIST_DATASETS`
>
> Returns an overview of all MoSPI statistical datasets with descriptions and coverage. This is the starting point ΓÇö call this first to identify the right dataset.
>
> The API covers 500+ indicators across employment, prices, industry, national accounts, health, education, disability, housing, environment, trade, and more. Each dataset has its own indicator codes, filter parameters, and valid values ΓÇö these are not standardized and cannot be inferred or guessed from parameter names alone.
>
> Four-step workflow (each step depends on the previous):
>
> 1. list\_datasets() ΓÇö identify the dataset
> 2. get\_indicators(dataset) ΓÇö list available indicators
> 3. get\_metadata(dataset, indicator\_code) ΓÇö retrieve valid filter values
> 4. get\_data(dataset, filters) ΓÇö fetch the data
>
> Returns: dict with 'datasets' (name, description, use\_for for each dataset) and 'workflow' (the four-step sequence).
