Ror Tools#

Configuration File: ror_tools.json Tool Type: Local Tools Count: 3

This page contains all tools defined in the ror_tools.json configuration file.

Available Tools#

ROR_get_organization (Type: BaseRESTTool)#

Get detailed metadata for a specific research organization by its ROR ID. Returns comprehensive i…

ROR_get_organization tool specification

Tool Information:

  • Name: ROR_get_organization

  • Type: BaseRESTTool

  • Description: Get detailed metadata for a specific research organization by its ROR ID. Returns comprehensive information including all name variants (official, aliases, acronyms, labels in different languages), organization type, establishment year, geographic location, website/Wikipedia links, external identifiers (GRID, ISNI, Wikidata, FundRef), and relationships to parent/child/related organizations. Use ROR_search_organizations first to find the ROR ID.

Parameters:

  • ror_id (string) (required) ROR identifier. Can be the short ID (e.g., ‘042nb2s44’) or full URL (e.g., ‘https://ror.org/042nb2s44’). Find IDs using ROR_search_organizations.

Example Usage:

query = {
    "name": "ROR_get_organization",
    "arguments": {
        "ror_id": "example_value"
    }
}
result = tu.run(query)

ROR_match_affiliation (Type: BaseRESTTool)#

Resolve a free-text author affiliation string (as printed in a paper, e.g. ‘Department of Chemist…

ROR_match_affiliation tool specification

Tool Information:

  • Name: ROR_match_affiliation

  • Type: BaseRESTTool

  • Description: Resolve a free-text author affiliation string (as printed in a paper, e.g. ‘Department of Chemistry, Harvard University’) to the best-matching organization in the Research Organization Registry (ROR). Uses ROR’s special ‘affiliation’ matching algorithm, which returns ranked candidates each with a match score, substring, and matching_type; the single best match has chosen=true and gives the canonical ROR id and organization name/location. Use this for author-affiliation disambiguation and organization normalization. For plain name/keyword lookup use ROR_search_organizations instead.

Parameters:

  • affiliation (string) (required) Raw affiliation string to match, typically copied from a publication byline (e.g., ‘Department of Chemistry, Harvard University’, ‘MIT Media Lab, Cambridge, MA’).

Example Usage:

query = {
    "name": "ROR_match_affiliation",
    "arguments": {
        "affiliation": "example_value"
    }
}
result = tu.run(query)

ROR_search_organizations (Type: BaseRESTTool)#

Search Research Organization Registry (ROR) v2 with explicit page pagination and exact total meta…

ROR_search_organizations tool specification

Tool Information:

  • Name: ROR_search_organizations

  • Type: BaseRESTTool

  • Description: Search Research Organization Registry (ROR) v2 with explicit page pagination and exact total metadata. ROR fixes the page size at 20 and rejects page_size while silently ignoring limit, so this wrapper exposes only the supported page control. Continue with metadata.next_page while metadata.has_more is true.

Parameters:

  • query (string) (required) Search query for organization name, acronym, or keyword (e.g., ‘MIT’, ‘Harvard University’, ‘Max Planck’, ‘CERN’)

  • page (integer) (optional) One-based ROR result page. Each page contains up to 20 organizations. Continue with metadata.next_page.

Example Usage:

query = {
    "name": "ROR_search_organizations",
    "arguments": {
        "query": "example_value"
    }
}
result = tu.run(query)