openalex_describe_fields
ActiveTool of @cyanheads/openalex-mcp-server
List valid field names for an OpenAlex entity type and context (filter, group_by, or select). Use proactively before constructing a filter or group_by to avoid invalid-field 400 errors. Pass `query` to narrow the results by name similarity — useful when you have a partial or guessed field name.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"entity_type",
"context"
],
"properties": {
"query": {
"type": "string",
"description": "Optional partial or guessed field name to rank results by similarity. Pass the field you tried (e.g. \"funder\") to get the closest matches first. Omit to return all fields for the entity_type + context."
},
"context": {
"enum": [
"filter",
"group_by",
"select"
],
"type": "string",
"description": "Field usage context. \"filter\": fields accepted in the filter param. \"group_by\": fields accepted in group_by (same valid set as filter). \"select\": fields accepted in select."
},
"entity_type": {
"enum": [
"works",
"authors",
"sources",
"institutions",
"topics",
"keywords",
"publishers",
"funders"
],
"type": "string",
"description": "OpenAlex entity type to list fields for."
}
}
}Parent server
@cyanheads/openalex-mcp-server
https://github.com/cyanheads/openalex-mcp-server
2/7 registries