Gahmen MCP

🚀 Gahmen MCP Server

The MCP (Model Context Protocol) server for Singapore's data.gov.sg APIs, offering effortless access to government datasets and collections.

🚀 Quick Start

The Gahmen MCP Server serves as a gateway to Singapore's government data on data.gov.sg. It enables users to access, search, and download datasets with ease.

✨ Features

• Gain access to data.gov.sg collections and datasets.
• Conduct searches within datasets using the CKAN datastore API.
• Enjoy dataset download functionality with filtering support.
• Benefit from built - in rate limiting to respect API quotas (5 requests per minute).

🛠️ Available Tools

Collections

• list_collections: List all collections on data.gov.sg.
• get_collection: Get metadata for a specific collection.

Datasets

• list_datasets: List all datasets on data.gov.sg.
• get_dataset_metadata: Get metadata for a specific dataset.
• search_dataset: Search for data within a dataset using the CKAN datastore.
• initiate_download: Start downloading a dataset with optional filtering.
• poll_download: Check the download status and get the download URL.

📦 Installation

npm install

🔨 Development

npx @smithery/cli dev

🏗️ Build

npx @smithery/cli build

💻 Usage Examples

Basic Usage

Search a Dataset

// Search population data
search_dataset({
  resource_id: "d_8b84c4ee58e3cfc0ece0d773c8ca6abc",
  q: { "year": "2023" },
  limit: 10
})

Advanced Usage

Get Collection with Datasets

// Get collection 522 with all dataset metadata
get_collection({
  collectionId: "522",
  withDatasetMetadata: true
})

⚙️ Technical Details

API Rate Limits

The server implements automatic rate limiting:

• Maximum 5 requests per minute.
• 12 - second minimum interval between requests.

No Authentication Required

data.gov.sg APIs are public and don't require authentication.

📄 License

This project is licensed under the MIT license.