`groups`

Pack: opendata-canada · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/groups for the schema, then POST the same URL with its arguments for the data.

List the subject-area themes used across open.canada.ca (e.g. Nature And Environment, Science And Technology, Health And Safety), ranked by dataset count. Each theme includes an fq filter string to pass to the search tool to list that theme’s datasets. Use this to browse what Canada publishes by topic before searching.

Parameters

Name	Type	Required	Description
`limit`	number	no

Example call

Arguments

{
  "limit": 15
}

curl

curl -X POST https://gateway.pipeworx.io/opendata-canada/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"groups","arguments":{"limit":15}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('groups', {
  "limit": 15
});

Response shape

Always returns: groups, count

Field	Type	Description
`groups`	array	Themes from the Solr `subject` facet.
`count`	integer	Number of themes returned
`total_datasets`	integer	Total datasets across the portal
`note`	string	Explanatory note about the theme source

Full JSON Schema

{
  "type": "object",
  "properties": {
    "groups": {
      "type": "array",
      "description": "Themes from the Solr `subject` facet.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Theme name"
          },
          "title": {
            "type": "string",
            "description": "Human-readable theme title"
          },
          "datasets": {
            "type": "integer",
            "description": "Number of datasets carrying this theme"
          },
          "fq": {
            "type": "string",
            "description": "Solr filter query that reproduces this theme, e.g. subject:\"transport\""
          }
        }
      }
    },
    "count": {
      "type": "integer",
      "description": "Number of themes returned"
    },
    "total_datasets": {
      "type": "integer",
      "description": "Total datasets across the portal"
    },
    "note": {
      "type": "string",
      "description": "Explanatory note about the theme source"
    }
  },
  "required": [
    "groups",
    "count"
  ]
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the opendata-canada pack

{
  "mcpServers": {
    "opendata-canada": {
      "url": "https://gateway.pipeworx.io/opendata-canada/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

groups