Listano Docs
AI IntegrationListano Control MCP

Listano Control MCP overview

Authenticated MCP server for managing Listano company catalogs.

Listano Control MCP is the authenticated catalog management server for Listano.

It allows an AI system to manage offerings for the authenticated company: create drafts, update core fields, add translations, manage attributes, check publish readiness, publish drafts, and discontinue live offerings.

Server details

FieldValue
NameListano Control
Version1.0.0
Websitehttps://listano.eu
Endpointhttps://control.listano.eu/mcp
Access modelAuthenticated company-scoped integration

Listano Control MCP requires authenticated sessions over a secure connection. Catalog data can only be read or changed according to the permissions granted to the authenticated integration, scoped by company.

Main concepts

ConceptMeaning
OfferingA product, service, right, or access item published in a company catalog.
DraftAn unpublished version of an offering. A draft is not live.
Drafts are automatically deleted after 30 days if not published.
Current versionThe live published version visible to buyers.
RevisionA numbered version of an offering. Published revisions can become outdated when replaced.
Main languageThe language used for the core offering title, description, and category label.
TranslationsNon-main-language versions of offering content.
AttributesStructured buyer-comparison fields such as dimensions, capacity, material, compatibility, or terms.
Publish readinessValidation that checks whether a draft can be published.

What the server is for

Listano Control MCP manages the company catalog attached to the authenticated integration session.

Use Listano Control MCP to manage a company catalog through structured actions:

  • list and inspect catalog offerings
  • create new offering drafts
  • update main-language core fields
  • add and update offering translations
  • add, update, translate, or remove attributes
  • check if a draft is ready to publish
  • publish valid drafts
  • discard drafts
  • discontinue published offerings

What the server is not for

Listano Control MCP is not a general search server and does not expose public catalog discovery. Public discovery belongs to Listano Search MCP.

It also does not currently manage media. Catalog media is not supported in catalog v1.

Draft and publishing behavior

Drafts are temporary. If a draft is not published within 30 days after creation, it will be automatically deleted.

A draft is not live until it is published.

When an offering already has a current published version, editing it creates or updates an unpublished draft revision. The current published version remains live until the draft is published.

When a draft is published, it becomes the current version. Any previous current version is replaced and marked as outdated.

Immutable fields

The offering kind and language cannot be changed through core updates.

If either value is wrong after creation, the safe recovery is to discard the draft and create a new offering with the correct values.