Skip to main content
Glama
opendatasoft-universal

opendatasoft-universal

by Hug0x0

mcp-opendatasoft-universal

Universal MCP server for querying any OpenDataSoft Explore v2.1 portal.

Tools

Run the MCP and call opendatasoft_universal_get_sources first to inspect source coverage. This server also exposes domain-specific tools for the topic described above.

Core tools include catalog search, dataset inspection, record queries, aggregate queries, portal/dataset health checks, and schema drift checks for any OpenDataSoft Explore v2.1 portal.

Related MCP server: data-utah

Install

npm install
npm run build
npm test
npm run dev

Claude Desktop

{
  "mcpServers": {
    "opendatasoft-universal": {
      "command": "npx",
      "args": ["mcp-opendatasoft-universal"]
    }
  }
}

Sources

Publishing

See docs/publishing.md.

Glama / Docker

The repo includes Dockerfile and glama.json.

Build steps:

["npm install", "npm run build"]

CMD arguments:

["node", "dist/index.js"]

Safety

This MCP helps agents discover and summarize public sources. It is not an official authority. Verify decisions against the competent public service or original data producer.

License

MIT

Available Tools

8 tools
opendatasoft_universal_aggregate_recordsC

Run an OpenDataSoft Explore v2.1 aggregate query on any dataset.

Inputs: select (required), dataset (required), portal_url (required), limit, +3 more.

opendatasoft_universal_check_schemaC

Compare expected field names against the current OpenDataSoft dataset schema.

Inputs: dataset (required), portal_url (required), expected_fields (required).

opendatasoft_universal_fetch_source_excerptC

Fetch a short text excerpt from a curated source by index or title keyword.

Inputs: source_key (required), max_chars.

opendatasoft_universal_get_sourcesB

List curated sources used by this MCP.

Inputs: no named parameters.

opendatasoft_universal_health_checkC

Check whether an OpenDataSoft portal and optional dataset are reachable through Explore v2.1.

Inputs: portal_url (required), dataset.

opendatasoft_universal_inspect_datasetC

Inspect one dataset schema on any OpenDataSoft Explore v2.1 portal.

Inputs: dataset (required), portal_url (required).

opendatasoft_universal_query_recordsC

Query records from any OpenDataSoft Explore v2.1 dataset.

Inputs: dataset (required), portal_url (required), limit, where, +2 more.

opendatasoft_universal_search_catalogC

Search any OpenDataSoft Explore v2.1 catalog.

Inputs: query (required), portal_url (required), limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 8 tools

    Disambiguation4/5

    Most tools have distinct purposes (search, inspect, query, aggregate, health), but inspect_dataset and check_schema both deal with dataset schemas and could be confused by an agent selecting between them.

    Naming Consistency4/5

    All tools share the 'opendatasoft_universal_' prefix and mostly follow verb_noun naming (search_catalog, inspect_dataset, query_records), but 'health_check' breaks the pattern as a compound noun rather than verb_noun.

    Tool Count5/5

    8 tools is well-scoped for a universal read-only API client, covering discovery, inspection, querying, and aggregation without unnecessary bloat or missing essentials.

    Completeness4/5

    The set covers core OpenDataSoft operations (search, inspect, query, aggregate, health), but lacks an explicit 'list all datasets' tool, though search_catalog can partially substitute for that function.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables searching, querying, and retrieving metadata from Oregon Open Data (data.oregon.gov) via the Socrata SoQL API, with no API key required.
      150 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables searching and querying Utah Open Data datasets via the Socrata SoQL API, including datasets, metadata, and row-level data retrieval.
      7 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables querying and searching King County Open Data datasets via Socrata SoQL, including metadata retrieval and data querying by resource ID.
      141 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables querying and searching the Providence Open Data catalog via Socrata SoQL, including dataset search, data querying, and metadata retrieval.
      92 npm
      MIT