# Koumoul opendata

Access to Koumoul platform datasets - diverse French open data

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add koumoul/opendata

# Browse available tools
npx -y @smithery/cli@latest tool list koumoul/opendata

# Get full schema for a tool
npx -y @smithery/cli@latest tool get koumoul/opendata search_datasets

# Call a tool
npx -y @smithery/cli@latest tool call koumoul/opendata search_datasets '{}'
```

## Direct MCP Connection

Endpoint: `https://opendata--koumoul.run.tools`

## Tools (6)

- `search_datasets` — Full-text search for datasets by French keywords. Returns matching datasets with ID, title, summary, and page link.
- `describe_dataset` — Get detailed metadata for a dataset: column schema, sample rows, license, spatial/temporal coverage.
- `search_data` — Search for data rows in a dataset using full-text search (query) or precise column filters. Returns matching rows and a…
- `aggregate_data` — Aggregate dataset rows by 1-3 columns with optional metrics (sum, avg, min, max, count). Defaults to counting unique va…
- `get_field_values` — List distinct values of a specific column. Useful to discover what values exist before filtering, or to populate a filt…
- `calculate_metric` — Calculate a single metric (avg, sum, min, max, stats, value_count, cardinality, percentiles) on a dataset column. Suppo…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get koumoul/opendata <tool-name>
```