Listano Docs
AI IntegrationListano Control MCP

Permissions

Scopes required by Listano Control MCP tools.

Permissions

Listano Control MCP is company-scoped and permission-controlled.

The authenticated integration session determines which company the tools act for and which operations are available.

Use whoami to inspect the current company and granted scopes.

Scopes

ScopeLabelAllows
catalog:readView offeringsList and read catalog offerings, supported languages, and publish readiness.
catalog:writeManage offeringsCreate, update, translate, and manage draft offerings.
catalog:publishPublish and discontinuePublish drafts and discontinue live offerings.

Tool permission matrix

ToolRequired scope
pingnone
whoaminone
catalog-readmenone
get-supported-languagesnone
list-offeringscatalog:read
get-offeringcatalog:read
check-offering-publish-readinesscatalog:read
new-offeringcatalog:write
update-offering-corecatalog:write
upsert-offering-translationscatalog:write
upsert-offering-attributescatalog:write
upsert-offering-attribute-translationscatalog:write
remove-offering-attributecatalog:write
discard-offering-draftcatalog:write
publish-offeringcatalog:publish
discontinue-offeringcatalog:publish

At the start of a session, call whoami.

If a mutation fails because of permissions, call whoami again and report which scope is missing.

Do not attempt to work around missing scopes. The integration must be granted the required permission before the operation can succeed.