search_publishers

Find scholarly publishers in OpenAlex using full-text search, filters, and sorting to identify academic publishing sources for research.

Instructions

Search publishers

Input Schema

TableJSON Schema

Name	Required	Description
`search`	No	Full-text search query
`filter`	No	Key:value OpenAlex filters. Supports entity attributes (e.g., 'country_codes', 'hierarchy_level'), IDs, and convenience filters (e.g., 'display_name.search'). Example: 'country_codes:US,hierarchy_level:0'
`sort`	No	Sort field with optional :desc
`page`	No	Page number
`per_page`	No	Results per page (max 200)
`cursor`	No	Cursor for deep pagination
`group_by`	No	Group results by field
`select`	No	Fields to return
`sample`	No	Random sample size
`seed`	No	Random seed
`mailto`	No	Email for rate limits
`api_key`	No	Premium API key

Implementation Reference

src/tools/searchPublishers.ts:3-10 (handler)

The core handler function that executes the 'search_publishers' tool by making an OpenAlex API request to the /publishers endpoint and formatting the JSON response as MCP content.

export async function searchPublishers(args: any) {
    return {
        content: [{
                type: "text",
                text: JSON.stringify(await makeOpenAlexRequest("/publishers", args), null, 2)
            }]
    };
}

src/index.ts:162-182 (schema)

The input schema definition for the 'search_publishers' tool, defining parameters like search, filter, sort, pagination, etc., as registered in the ListTools response.

{
    name: "search_publishers",
    description: "Search publishers",
    inputSchema: {
        type: "object",
        properties: {
            search: { type: "string", description: "Full-text search query" },
            filter: { type: "string", description: "Key:value OpenAlex filters. Supports entity attributes (e.g., 'country_codes', 'hierarchy_level'), IDs, and convenience filters (e.g., 'display_name.search'). Example: 'country_codes:US,hierarchy_level:0'" },
            sort: { type: "string", description: "Sort field with optional :desc" },
            page: { type: "number", description: "Page number" },
            per_page: { type: "number", description: "Results per page (max 200)" },
            cursor: { type: "string", description: "Cursor for deep pagination" },
            group_by: { type: "string", description: "Group results by field" },
            select: { type: "string", description: "Fields to return" },
            sample: { type: "number", description: "Random sample size" },
            seed: { type: "number", description: "Random seed" },
            mailto: { type: "string", description: "Email for rate limits" },
            api_key: { type: "string", description: "Premium API key" }
        }
    }
},

src/index.ts:291-292 (registration)
The registration/dispatch case in the main tool handler switch statement that routes calls to the searchPublishers function.
```
case "search_publishers":
    return await searchPublishers(args);
```

OpenAlex MCP Server