PilotMCP
Platforms and tools

Sellsy

The 25 tools Pilot MCP serves for Sellsy: 16 read-only, and 9 that write with the €29 plan, taken from the server.

Pilot MCP serves 16 read-only tools for Sellsy, on every plan. With the €29 plan, it also serves 6 that create or change and 3 that delete. Their names start with sellsy_.

What each entry shows

The name, description and parameters come from the list the server serves to your assistant (tools/list). Descriptions are in English: this is the text your assistant receives. Your assistant never fills in platform credentials: Pilot adds them on each call.

Writing and deleting

Write tools are only served with the €29 plan: your assistant creates, changes, pauses and deletes there, with no access level to pick when you connect. On the free plan, it does not see them. A change that sets an object to deleted or archived counts as a deletion, and a deletion targets one object at a time. Changes apply directly on the ad platform: Pilot reads the object from the platform before and after the write, and logs it in your workspace. See Read and write.

Tool families

Other tools

sellsy_get_account

Sellsy: Get Account · read-only · idempotent

Identity of the connected Sellsy account (teams via /teams). Call it first to check that the token is valid. Read-only.

No parameters.

sellsy_get_company

Sellsy: Get Company · read-only · idempotent

Details of a Sellsy company by its identifier. Read-only.

ParameterTypeRequiredDescription
idintegeryesSellsy identifier of the company.
embedstring[]noRelated objects to include.

sellsy_get_invoice

Sellsy: Get Invoice · read-only · idempotent

Details of an invoice (lines, amounts excluding and including tax, status, due date). Read-only.

ParameterTypeRequiredDescription
idintegeryesSellsy identifier of the invoice.
embedstring[]noRelated objects to include.

sellsy_get_opportunity

Sellsy: Get Opportunity · read-only · idempotent

Details of one Sellsy opportunity by its identifier. Read-only.

ParameterTypeRequiredDescription
idintegeryesSellsy identifier of the opportunity.

sellsy_get_task

Sellsy: Get Task · read-only · idempotent

Details of one Sellsy task by its identifier. Read-only.

ParameterTypeRequiredDescription
idintegeryesSellsy identifier of the task.

sellsy_list_companies

Sellsy: List Companies · read-only · idempotent

Lists the companies (customers, prospects, suppliers) of the Sellsy account. To filter by type, name, creation date or country, use search_companies. Read-only.

ParameterTypeRequiredDescription
limitintegernoNumber of items (1-100, default 25).
offsetinteger or stringnoPage cursor: send back AS IS the `pagination.offset` of the previous call (often an opaque base64 string). Never increment it.
orderstringnoSort field. Values: "name", "id", "created_at", "updated_at".
directionstringnoSort direction. Values: "asc", "desc".
embedstring[]noRelated objects to include: 'main_contact', 'invoicing_address', 'opportunities', 'invoices', 'smart_tags', 'owner'... (each one requires its own OAuth scope).

sellsy_list_individuals

Sellsy: List Individuals · read-only · idempotent

Lists individuals (private-person customers, distinct from the contacts attached to a company). Read-only.

ParameterTypeRequiredDescription
limitintegernoNumber of items (1-100, default 25).
offsetinteger or stringnoPage cursor: send back AS IS the `pagination.offset` of the previous call (often an opaque base64 string). Never increment it.
orderstringnoSort field. Values: "id", "created_at", "updated_at".
directionstringnoSort direction. Values: "asc", "desc".

sellsy_list_items

Sellsy: List Items · read-only · idempotent

Lists the catalog (billable products and services). Read-only.

ParameterTypeRequiredDescription
limitintegernoNumber of items (1-100, default 25).
offsetinteger or stringnoPage cursor: send back AS IS the `pagination.offset` of the previous call (often an opaque base64 string). Never increment it.
directionstringnoSort direction. Values: "asc", "desc".

sellsy_list_payments

Sellsy: List Payments · read-only · idempotent

Lists the payments recorded in the Sellsy account, paginated. Read-only.

ParameterTypeRequiredDescription
limitintegernoNumber of items (1-100, default 25).
offsetinteger or stringnoPage cursor: send back AS IS the `pagination.offset` of the previous call (often an opaque base64 string). Never increment it.
directionstringnoSort direction. Values: "asc", "desc".

sellsy_list_pipelines

Sellsy: List Pipelines · read-only · idempotent

Lists the sales pipelines and their steps. Call it BEFORE creating an opportunity: `pipeline` and `step` are required there. Read-only.

ParameterTypeRequiredDescription
limitintegernoNumber of items (1-100, default 25).
offsetinteger or stringnoPage cursor: send back AS IS the `pagination.offset` of the previous call (often an opaque base64 string). Never increment it.

sellsy_list_tasks

Sellsy: List Tasks · read-only · idempotent

Lists the CRM tasks of the Sellsy account, paginated. Read-only.

ParameterTypeRequiredDescription
limitintegernoNumber of items (1-100, default 25).
offsetinteger or stringnoPage cursor: send back AS IS the `pagination.offset` of the previous call (often an opaque base64 string). Never increment it.
directionstringnoSort direction. Values: "asc", "desc".

sellsy_search_all

Sellsy: Search All · read-only · idempotent

Cross-object full-text search (companies, contacts, documents...). Handy to find a customer's identifier from its name. Read-only.

ParameterTypeRequiredDescription
qstringyesSearch term.
typestring[]noObject types to restrict to, e.g. ['company','contact','invoice'].
limitintegernoNumber of items (1-100, default 25).
archivedbooleannoInclude archived objects.

sellsy_search_companies

Sellsy: Search Companies · read-only · idempotent

Searches companies with filters (customer/prospect/supplier type, name, email, SIRET, postal code, country, creation date). It is the ONLY way to filter by date. Read-only.

ParameterTypeRequiredDescription
namestringnoFilter on the name (partial match).
emailstringnoFilter on the email.
typestring[]noThird-party types to keep. Values: "prospect", "client", "supplier".
createdobjectnoCreation date range.
country_codestringnoTwo-letter ISO country code, e.g. 'FR'.
postal_codestringnoPostal code.
is_archivedbooleannoInclude or exclude archived records.
limitintegernoNumber of items (1-100, default 25).
offsetinteger or stringnoPage cursor: send back AS IS the `pagination.offset` of the previous call (often an opaque base64 string). Never increment it.

sellsy_search_estimates

Sellsy: Search Estimates · read-only · idempotent

Searches estimates (quotes) with filters (date range, status). Used to measure the quoted volume and the conversion rate. Read-only.

ParameterTypeRequiredDescription
dateobjectnoDocument date range.
createdanynoCreation date range.
limitintegernoNumber of items (1-100, default 25).
offsetinteger or stringnoPage cursor: send back AS IS the `pagination.offset` of the previous call (often an opaque base64 string). Never increment it.

sellsy_search_invoices

Sellsy: Search Invoices · read-only · idempotent

Searches invoices with filters (date range, status, customer, currency). It is the revenue tool: filter status=['paid'] over a `date` range for collected revenue. Read-only.

ParameterTypeRequiredDescription
dateobjectnoDocument date range (invoicing).
statusstring[]noStatuses to keep. 'paid' = collected, 'late' = overdue. Values: "draft", "due", "payinprogress", "paid", "late", "cancelled".
numberstringnoInvoice number.
currencystringnoISO currency, e.g. 'EUR'.
createdanynoCreation date range.
limitintegernoNumber of items (1-100, default 25).
offsetinteger or stringnoPage cursor: send back AS IS the `pagination.offset` of the previous call (often an opaque base64 string). Never increment it.

sellsy_search_opportunities

Sellsy: Search Opportunities · read-only · idempotent

Searches opportunities with filters (pipeline, step, status, amount, creation or due date, owners). Used to measure the sales pipeline. Read-only.

ParameterTypeRequiredDescription
namestringnoFilter on the name.
statusesstring[]noStatuses to keep, e.g. ['won'] for signed revenue. Values: "open", "won", "lost", "cancelled", "closed", "late".
pipelineinteger[]noPipeline identifiers.
stepinteger[]noStep identifiers.
createdobjectnoCreation date range.
due_dateanynoDue date range.
limitintegernoNumber of items (1-100, default 25).
offsetinteger or stringnoPage cursor: send back AS IS the `pagination.offset` of the previous call (often an opaque base64 string). Never increment it.

Create and change (€29)

Served with the €29 plan.

sellsy_create_company

Sellsy: Create Company · create or change, €29 plan · creates an object on each call

Creates a company (customer, prospect or supplier) in Sellsy. WRITE: simulated by default, requires dry_run=false + confirm=true.

ParameterTypeRequiredDescription
namestringyesCompany legal name. Required.
typestringyesKind of third party. Required. Values: "prospect", "client", "supplier".
emailstringnoMain email.
websitestringnoWebsite.
phone_numberstringnoLandline phone number.
mobile_numberstringnoMobile phone number.
referencestringnoInternal reference.
notestringnoFree-text note.
owner_idintegernoIdentifier of the owning salesperson.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).

sellsy_create_contact

Sellsy: Create Contact · create or change, €29 plan · creates an object on each call

Creates a contact (person attached to a company) in Sellsy. WRITE: simulated by default, requires dry_run=false + confirm=true.

ParameterTypeRequiredDescription
last_namestringyesLast name. Required.
first_namestringnoFirst name.
emailstringnoEmail address.
positionstringnoJob title.
phone_numberstringnoLandline phone number.
mobile_numberstringnoMobile phone number.
notestringnoFree-text note.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).

sellsy_create_individual

Sellsy: Create Individual · create or change, €29 plan · creates an object on each call

Creates an individual (private-person customer) in Sellsy. WRITE: simulated by default, requires dry_run=false + confirm=true.

ParameterTypeRequiredDescription
last_namestringyesLast name. Required.
typestringyesKind of third party. Required. Values: "prospect", "client", "supplier".
first_namestringnoFirst name.
emailstringnoEmail address.
phone_numberstringnoLandline phone number.
mobile_numberstringnoMobile phone number.
notestringnoFree-text note.
owner_idintegernoIdentifier of the owning salesperson.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).

sellsy_create_opportunity

Sellsy: Create Opportunity · create or change, €29 plan · creates an object on each call

Creates a sales opportunity in Sellsy. `pipeline` and `step` are required: get them through list_pipelines BEFORE calling this tool. WRITE: simulated by default, requires dry_run=false + confirm=true.

ParameterTypeRequiredDescription
namestringyesName of the opportunity. Required.
pipelineintegeryesPipeline identifier (list_pipelines). Required.
stepintegeryesStep identifier (list_pipelines). Required.
relatedobject[]yesAttached third party: exactly one company OR one individual. Required.
amountnumbernoEstimated amount.
probabilitynumbernoProbability of success (0-100).
statusstringnoStatus, default 'open'. Values: "open", "won", "lost", "cancelled", "closed", "late".
due_datestringnoDue date, format YYYY-MM-DD.
notestringnoFree-text note.
owner_idintegernoIdentifier of the owning salesperson.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).

sellsy_create_task

Sellsy: Create Task · create or change, €29 plan · creates an object on each call

Creates a CRM task attached to a third party or an opportunity. WRITE: simulated by default, requires dry_run=false + confirm=true.

ParameterTypeRequiredDescription
due_datestringyesDue date, format YYYY-MM-DD. Required.
label_idintegeryesIdentifier of the task label. Required.
relatedobject[]yesAttached object (only one). Required.
titlestringnoTitle of the task.
descriptionstringnoDescription of the task.
assigned_staff_idsinteger[]noIdentifiers of the assigned staff members.
owner_idintegernoIdentifier of the owner.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).

sellsy_update_opportunity

Sellsy: Update Opportunity · create or change, €29 plan · creates an object on each call

Updates an opportunity (step, status, amount, due date): the tool to move a deal forward in the pipeline. WRITE: simulated by default, requires dry_run=false + confirm=true.

ParameterTypeRequiredDescription
idintegeryesIdentifier of the opportunity. Required.
stepintegernoNew step (list_pipelines).
statusstringnoNew status. Values: "open", "won", "lost", "cancelled", "closed", "late".
amountnumbernoNew amount.
probabilitynumbernoNew probability (0-100).
due_datestringnoNew due date, format YYYY-MM-DD.
notestringnoFree-text note.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).

Delete (€29)

Served with the €29 plan. A deletion targets one object at a time.

sellsy_delete_company

Sellsy: Delete Company · delete, €29 plan, one object at a time · creates an object on each call

Deletes one Sellsy company by its identifier. WRITE: simulated by default, requires dry_run=false + confirm=true. The object is read before (an unknown id is an error) and after (still readable after the call is an error). The Sellsy API documents no trash and no restore for it: the deletion is permanent.

ParameterTypeRequiredDescription
idintegeryesSellsy identifier of the company to delete.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).

sellsy_delete_opportunity

Sellsy: Delete Opportunity · delete, €29 plan, one object at a time · creates an object on each call

Deletes one Sellsy opportunity by its identifier. WRITE: simulated by default, requires dry_run=false + confirm=true. The object is read before (an unknown id is an error) and after (still readable after the call is an error). The Sellsy API documents no trash and no restore for it: the deletion is permanent.

ParameterTypeRequiredDescription
idintegeryesSellsy identifier of the opportunity to delete.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).

sellsy_delete_task

Sellsy: Delete Task · delete, €29 plan, one object at a time · creates an object on each call

Deletes one Sellsy task by its identifier. WRITE: simulated by default, requires dry_run=false + confirm=true. The object is read before (an unknown id is an error) and after (still readable after the call is an error). The Sellsy API documents no trash and no restore for it: the deletion is permanent.

ParameterTypeRequiredDescription
idintegeryesSellsy identifier of the task to delete.
dry_runbooleannoIf true (the DEFAULT for destructive actions), simulates without writing anything and describes what would be done.
confirmbooleannoMust be true to actually run a destructive or bulk action (delete/archive/bulk).

On this page