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 the Research Organization Registry (ROR) for research institutions, universities, companie…

ROR_search_organizations tool specification

Tool Information:

  • Name: ROR_search_organizations

  • Type: BaseRESTTool

  • Description: Search the Research Organization Registry (ROR) for research institutions, universities, companies, and other organizations. ROR provides unique persistent identifiers for research organizations worldwide, similar to ORCID for researchers. Returns organization names, types, locations, external identifiers (GRID, ISNI, Wikidata), and ROR IDs. Use this to find organizations by name, identify affiliations, or get ROR IDs for detailed lookups with ROR_get_organization. Supports searching by name, acronym, or keyword.

Parameters:

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

Example Usage:

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