`search`

Pack: ror · Endpoint: https://gateway.pipeworx.io/ror/mcp

Search the Research Organization Registry (ROR) for universities, research institutes, hospitals, companies, and funders by name or acronym, with optional filters for organization type (education, healthcare, company, government, nonprofit, facility, archive, other) and ISO-3166 alpha-2 country code. Returns each organization ROR id, official and alternate names, country and location, types, and external identifiers. Answers which ROR id belongs to a named research institution.

Parameters

Name	Type	Required	Description
`query`	string	yes	e.g. “harvard university”
`type`	string	no	education \| healthcare \| company \| archive \| nonprofit \| government \| facility \| other
`country`	string	no	ISO-3166 alpha-2 country code, e.g. “US”
`page`	number	no	1-based page (default 1)

Example call

Arguments

{
  "query": "harvard university"
}

curl

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

TypeScript (@pipeworx/sdk)

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

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

More examples

{
  "query": "Stanford",
  "type": "education",
  "country": "US",
  "page": 1
}

Response shape

Field	Type	Description
`number_of_results`	number	Total number of results matching the query
`items`	array	Array of organization records
`time_taken`	number	API response time in milliseconds
`query`	object	Query parameters used

Full JSON Schema

{
  "type": "object",
  "description": "Search results from ROR organizations endpoint",
  "properties": {
    "number_of_results": {
      "type": "number",
      "description": "Total number of results matching the query"
    },
    "items": {
      "type": "array",
      "description": "Array of organization records",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "ROR organization ID (URL)"
          },
          "name": {
            "type": "string",
            "description": "Organization name"
          },
          "email_address": {
            "type": [
              "string",
              "null"
            ],
            "description": "Organization email address if available"
          },
          "ip_addresses": {
            "type": "array",
            "description": "Associated IP address ranges",
            "items": {
              "type": "string"
            }
          },
          "established": {
            "type": [
              "number",
              "null"
            ],
            "description": "Year the organization was established"
          },
          "types": {
            "type": "array",
            "description": "Organization types",
            "items": {
              "type": "string"
            }
          },
          "relationships": {
            "type": "array",
            "description": "Related organizations",
            "items": {
              "type": "object"
            }
          },
          "links": {
            "type": "array",
            "description": "External links",
            "items": {
              "type": "object"
            }
          },
          "aliases": {
            "type": "array",
            "description": "Alternative names",
            "items": {
              "type": "string"
            }
          },
          "acronyms": {
            "type": "array",
            "description": "Organization acronyms",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "type": "object",
            "properties": {
              "country_name": {
                "type": "string"
              },
              "country_code": {
                "type": "string"
              }
            }
          },
          "addresses": {
            "type": "array",
            "description": "Organization addresses",
            "items": {
              "type": "object"
            }
          }
        }
      }
    },
    "time_taken": {
      "type": "number",
      "description": "API response time in milliseconds"
    },
    "query": {
      "type": "object",
      "description": "Query parameters used"
    }
  }
}

Connect

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

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

See Getting Started for client-specific install steps.

search