MCP tools

The MCP server exposes four tools. Tool arguments mirror the REST API, which is documented in the API reference.

list_societies

Lists societies in the catalogue. The list is paginated.

Argument	Type	Required	Description
active	string	no	'true' or 'false', filters by active status
country	string	no	Filter by home country code
q	string	no	Search by name or code
limit	integer	no	Page size, 1 to 200, default 50
offset	integer	no	Page offset, default 0

get_society

Returns one society with its roles, sourced rights, detail rights and links.

Argument	Type	Required	Description
code	string	yes	The society’s code

list_reference_values

Returns one reference vocabulary.

Argument	Type	Required	Description
vocabulary	string	yes	One of right-types, right-subtypes, society-types, society-roles, agency-kinds, countries

create_or_update_society

Creates or updates one society. code is the natural key: an unknown code creates, a known code updates.

Argument	Type	Required	Description
code	string	yes	The society’s code
name	string	on create	Display name
kind	string	on create	The society’s kind
homeCountryCode	string	no	Home country code
cisacCode	string	no	CISAC society code
comment	string	no	Free-text comment
active	boolean	no	false deactivates the society
roles	array	no	{ role, societyType } entries
rights	array of strings	no	Right types the society collects
detailRights	array	no	{ role, rightType, countryCode, subRights } entries
links	array	no	{ linkedAgencyCode, rightType } entries

Valid values for role, societyType, rightType and the detail-right subRights come from list_reference_values.

The absence rule

The same rule applies to every write:

• An omitted section is left unchanged.
• An explicit empty array [] clears that section.
• active: false deactivates the society.
• Nothing is ever hard-deleted.