`search`

Pack: dataverse-harvard · Endpoint: https://gateway.pipeworx.io/dataverse-harvard/mcp

Keyword search across Harvard Dataverse — the ~200k-dataset open research repository. Returns dataset titles, DOIs, authors, publication dates and descriptions; pass a returned DOI to dataset or dataset_files. Use to find research data behind a paper or topic (e.g. “climate”, “survey experiment”, “replication data”).

Parameters

Name	Type	Required	Description
`query`	string	yes
`type`	string	no	dataset \| file \| dataverse
`sort`	string	no	name \| date
`per_page`	number	no	1-1000 (default 25).
`start`	number	no

Example call

Arguments

{
  "query": "climate change"
}

curl

curl -X POST https://gateway.pipeworx.io/dataverse-harvard/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"climate change"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('search', {
  "query": "climate change"
});

More examples

{
  "query": "economic data",
  "type": "dataset",
  "sort": "date",
  "per_page": 50
}

Response shape

Field	Type	Description
`status`	string	API response status
`data`	object	Search results data

Full JSON Schema

{
  "type": "object",
  "description": "Search results from Harvard Dataverse API",
  "properties": {
    "status": {
      "type": "string",
      "description": "API response status"
    },
    "data": {
      "type": "object",
      "description": "Search results data",
      "properties": {
        "q": {
          "type": "string",
          "description": "Query string used"
        },
        "total_count": {
          "type": "integer",
          "description": "Total number of results"
        },
        "start": {
          "type": "integer",
          "description": "Starting position"
        },
        "spelling_alternatives": {
          "type": "object",
          "description": "Spelling alternative suggestions"
        },
        "items": {
          "type": "array",
          "description": "Array of search result items",
          "items": {
            "type": "object",
            "description": "Search result item (dataset, file, or dataverse)"
          }
        }
      }
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "dataverse-harvard": {
      "url": "https://gateway.pipeworx.io/dataverse-harvard/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search