list_tickets
List support tickets with optional filters and pagination.
pagesearchstatussort_byper_pageprioritysort_dirrequester_emailio.github.xalantis-hubPublished by GitHub account xalantis-hubv0.3.1Updated Oct 25, 2026
Tickets, CRM, contracts, projects and the whole Xalantis public API from your AI assistant.
Local MCP server that lets an assistant read and act on Xalantis business data — tickets, CRM, contracts, knowledge, billing and projects — through the public X
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Follow the launch instructions in the repository.
MCP server for Xalantis. It lets MCP-compatible AI clients read and act on Xalantis business data through the public /api/v1 API.
Release 0.3.0 reaches all 323 operations of the public API (contract 2.11.0): dedicated tools for the most frequent tasks, and four generic tools driven by the bundled OpenAPI spec for everything else.
Listed in the official MCP Registry as io.github.xalantis-hub/xalantis-mcp, and on Glama.
Add to claude_desktop_config.json:
Then set XALANTIS_API_KEY in the shell/session that launches the MCP server.
Add to .cursor/mcp.json:
Dedicated tools:
Through the generic tools: every other operation of the public API, including the rest of Projects (sprints, milestones, lists, labels, custom fields, documents, time tracking, automations, analytics, exports, imports, client portal), compliance cases, signature envelopes, contract referentials and CRM imports.
Four tools cover any operation of the public API without a dedicated tool:
search_operations: finds operations by keywords (all required, accents ignored; summaries are in French), area and HTTP method. Without arguments, lists the areas.describe_operation: returns the path, query and header parameters, the body schema and the scopes of one operation.read_operation: runs a GET operation. Binary or CSV responses can be written to a local file with save_to.call_operation: runs a POST, PUT, PATCH or DELETE operation. Requires confirm: true; multipart uploads take local paths in files.The spec ships with the package (openapi/xalantis-openapi.json) and is refreshed at each release. Text responses above 200 KB are refused with a hint to paginate or use save_to.
Every write sends an Idempotency-Key, generated for each call unless one is passed in headers: about 80 routes require it, and replaying the same key returns the first response without a second effect.
Project routes require an API key linked to a member of the workspace (keys created from the Developers settings are) and the matching projects:* scopes.
Tools that mutate data or may expose sensitive data require a confirm: true argument. The AI client should only pass this after the user explicitly confirms the action.
Examples of confirmed actions:
If confirmation is missing, the tool returns an error explaining that confirmation is required.
Binary endpoints are supported through file-aware tools:
Downloads can either return base64 or write to a local path:
When output_path is omitted, the tool returns metadata plus base64 content.
Once connected, an MCP-compatible assistant can answer or act on prompts such as:
/tmp/report.xlsx.”confirm: true.output_path carefully.npm test calls every tool with a fake transport and fails if one targets a route the spec does not declare or sends a write without an Idempotency-Key. Run sync-openapi before a release (default source: the sibling xalantis-application/storage/app/openapi.json).
MIT
Source: README.md at commit 8e715a8
List support tickets with optional filters and pagination.
pagesearchstatussort_byper_pageprioritysort_dirrequester_emailGet a single ticket by UUID.
uuidrequiredCreate a new support ticket. The assistant/client should ask for user confirmation before creating user-visible tickets.
typechannelconfirmsubjectrequiredprioritydescriptionrequiredcategory_slugrequester_namerequester_emailrequiredUpdate an existing ticket. Requires confirmation for status/assignee/priority changes that affect operations.
uuidrequireddue_atstatusconfirmsubjectpriorityassignee_iddescriptioncategory_slugDelete a ticket. Destructive: requires explicit confirmation.
uuidrequiredconfirmrequiredGet support ticket metrics.
tofromgroup_byList activity history for a ticket.
pageper_pageticket_uuidrequiredList all replies and notes for a ticket.
pageper_pageticket_uuidrequiredAdd a reply or internal note to a ticket. Public replies should be confirmed by the user first.
confirmcontentrequiredis_internalticket_uuidrequiredUpdate a ticket reply or internal note.
confirmcontentrequiredreply_uuidrequiredticket_uuidrequiredDelete a ticket reply. Destructive: requires explicit confirmation.
confirmrequiredreply_uuidrequiredticket_uuidrequiredList links attached to a ticket.
pageper_pageticket_uuidrequiredLink a ticket to another ticket or object. Requires confirmation.
datarequiredconfirmrequiredticket_uuidrequiredRemove a ticket link. Destructive: requires confirmation.
confirmrequiredlink_uuidrequiredticket_uuidrequiredList time entries for a ticket.
pageper_pageticket_uuidrequiredCreate a time entry on a ticket. Requires confirmation.
datarequiredconfirmrequiredticket_uuidrequiredList watchers for a ticket.
pageper_pageticket_uuidrequiredAdd or remove a ticket watcher. Requires confirmation because it changes notifications.
datarequiredconfirmrequiredticket_uuidrequiredRun or mark triage for a ticket. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredEscalate a ticket. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredDe-escalate a ticket. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredList service catalog items visible to the API key.
pagesearchcategoryper_pageCreate a service request from a catalog item. Requires confirmation.
datarequiredconfirmrequiredcatalog_item_uuidrequiredApprove a service request. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredReject a service request. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredFulfill a service request. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredReopen a service request. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredList ticket categories.
pagesearchper_pageList ticket tags.
pagesearchper_pageAttach or detach a tag on a ticket. Requires confirmation.
dataconfirmrequiredtag_uuidrequiredticket_uuidrequiredList SLA breaches.
pagestatusper_pageAcknowledge an SLA breach. Requires confirmation.
dataconfirmrequiredbreach_uuidrequiredRun a bulk ticket action. Requires confirmation.
datarequiredconfirmrequiredList generated ticket reports.
pageper_pageDownload a generated ticket report. Returns base64 unless output_path is provided.
confirmrequiredoutput_pathreport_uuidrequiredCreate a ticket report. Requires confirmation because it may process/export sensitive data.
datarequiredconfirmrequiredarchiving a ticket. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredunarchiving a ticket. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredrestoring ticket independence. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredduplicating a ticket. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredlinking a duplicate ticket. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredmerging a ticket. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredsplitting a ticket. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredList merge candidates for a ticket.
pageper_pageticket_uuidrequiredList duplicate candidates for a ticket.
pageper_pageticket_uuidrequiredList escalation executions for a ticket.
pageper_pageticket_uuidrequiredList ticket attachments metadata.
pageper_pageticket_uuidrequiredUpload a local file as a ticket attachment. Requires confirmation.
dataconfirmrequiredfile_pathrequiredfield_nameticket_uuidrequiredDownload a ticket attachment. Returns base64 unless output_path is provided.
confirmrequiredoutput_pathticket_uuidrequiredattachment_uuidrequiredDelete a ticket attachment. Destructive: requires confirmation.
confirmrequiredticket_uuidrequiredattachment_uuidrequiredRetry a failed ticket reply. Requires confirmation.
dataconfirmrequiredreply_uuidrequiredticket_uuidrequiredcreating a ticket subtask. Requires confirmation.
dataconfirmrequiredchild_uuidticket_uuidrequiredtoggling a ticket subtask. Requires confirmation.
dataconfirmrequiredchild_uuidticket_uuidrequireddeleting a ticket subtask. Requires confirmation.
dataconfirmrequiredchild_uuidticket_uuidrequiredupdating a ticket time entry. Requires confirmation.
dataconfirmrequiredchild_uuidticket_uuidrequireddeleting a ticket time entry. Requires confirmation.
dataconfirmrequiredchild_uuidticket_uuidrequiredAcknowledge requester response on a ticket. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredList incident updates for a ticket.
pageper_pageticket_uuidrequiredCreate an incident update. Requires confirmation.
datarequiredconfirmrequiredticket_uuidrequiredGet incident report for a ticket.
ticket_uuidrequiredGet archived incident report for a ticket.
ticket_uuidrequiredarchiving an incident report. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredrequesting incident report signoff. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredlinking incident CI. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredlinking incident problem. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredlinking incident service component. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredupdating incident publication. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredupdating incident severity override. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredupdating incident closure review. Requires confirmation.
dataconfirmrequiredticket_uuidrequiredGet Service Desk agent status.
pageper_pageUpdate Service Desk agent status. Requires confirmation.
datarequiredconfirmrequiredList service catalog administration view.
pagesearchper_pageGet a service catalog item by UUID.
item_uuidrequiredcreating a service catalog item. Requires confirmation.
dataconfirmrequireditem_uuidupdating a service catalog item. Requires confirmation.
dataconfirmrequireditem_uuiddeleting a service catalog item. Requires confirmation.
dataconfirmrequireditem_uuidduplicating a service catalog item. Requires confirmation.
dataconfirmrequireditem_uuidtoggling a service catalog item. Requires confirmation.
dataconfirmrequireditem_uuidList ticket reply template.
pagesearchper_pageCreate a ticket reply template item. Requires confirmation.
datarequiredconfirmrequiredUpdate a ticket reply template item. Requires confirmation.
datarequiredconfirmrequireditem_uuidrequiredDelete a ticket reply template item. Destructive: requires confirmation.
confirmrequireditem_uuidrequiredList ticket automation.
pagesearchper_pageCreate a ticket automation item. Requires confirmation.
datarequiredconfirmrequiredUpdate a ticket automation item. Requires confirmation.
datarequiredconfirmrequireditem_uuidrequiredDelete a ticket automation item. Destructive: requires confirmation.
confirmrequireditem_uuidrequiredCreate a ticket category. Requires confirmation.
datarequiredconfirmrequiredUpdate a ticket category. Requires confirmation.
datarequiredconfirmrequireditem_uuidrequiredDelete a ticket category. Destructive: requires confirmation.
confirmrequireditem_uuidrequiredCreate a ticket tag. Requires confirmation.
datarequiredconfirmrequiredUpdate a ticket tag. Requires confirmation.
datarequiredconfirmrequireditem_uuidrequiredDelete a ticket tag. Destructive: requires confirmation.
confirmrequireditem_uuidrequiredCreate a SLA policy. Requires confirmation.
datarequiredconfirmrequiredUpdate a SLA policy. Requires confirmation.
datarequiredconfirmrequireditem_uuidrequiredDelete a SLA policy. Destructive: requires confirmation.
confirmrequireditem_uuidrequiredList SLA policies.
pagesearchper_pageList escalation policies.
pagesearchper_pageCreate an escalation policy. Requires confirmation.
datarequiredconfirmrequiredUpdate an escalation policy. Requires confirmation.
datarequiredconfirmrequiredpolicy_uuidrequiredReorder ticket automations. Requires confirmation.
datarequiredconfirmrequiredList executions for a ticket automation.
pageper_pageautomation_uuidrequiredduplicating ticket automation. Requires confirmation.
dataconfirmrequiredautomation_uuidrequiredtoggling ticket automation. Requires confirmation.
dataconfirmrequiredautomation_uuidrequiredList client.
pagesearchper_pageGet one client item by UUID.
item_uuidrequiredCreate a client item. Requires confirmation.
datarequiredconfirmrequiredUpdate a client item. Requires confirmation.
datarequiredconfirmrequireditem_uuidrequiredDelete a client item. Destructive: requires confirmation.
confirmrequireditem_uuidrequiredList contact.
pagesearchper_pageGet one contact item by UUID.
item_uuidrequiredCreate a contact item. Requires confirmation.
datarequiredconfirmrequiredUpdate a contact item. Requires confirmation.
datarequiredconfirmrequireditem_uuidrequiredDelete a contact item. Destructive: requires confirmation.
confirmrequireditem_uuidrequiredList deal.
pagesearchper_pageGet one deal item by UUID.
item_uuidrequiredCreate a deal item. Requires confirmation.
datarequiredconfirmrequiredUpdate a deal item. Requires confirmation.
datarequiredconfirmrequireditem_uuidrequiredDelete a deal item. Destructive: requires confirmation.
confirmrequireditem_uuidrequiredList representatives for a client.
pageper_pageclient_uuidrequiredCreate a representative for a client. Requires confirmation.
datarequiredconfirmrequiredclient_uuidrequiredList CRM pipelines.
pageper_pageList knowledge base articles.
pagesearchper_pageSearch the knowledge base.
qpagesearchper_pageList knowledge base categories.
pageper_pageGet a knowledge article by identifier or slug.
identifierrequiredGet UUID-based categories, products and labels accepted by Knowledge article writes.
Takes no parameters.
List internal Knowledge articles visible to the configured integration actor.
pagelocalesearchstatusper_pageproduct_uuidcategory_uuidGet an internal Knowledge article by UUID.
article_uuidrequiredCreate an internal Knowledge draft. Requires explicit confirmation and a stable idempotency key.
datarequiredconfirmrequiredidempotency_keyrequiredUpdate a draft or stage a revision for a published article. Requires explicit confirmation.
datarequiredconfirmrequiredarticle_uuidrequiredidempotency_keyrequiredSubmit a Knowledge draft or pending revision to editorial review. Requires explicit confirmation.
confirmrequiredarticle_uuidrequiredidempotency_keyrequiredArchive a Knowledge article while preserving its history. Requires explicit confirmation.
confirmrequiredarticle_uuidrequiredidempotency_keyrequiredSoft-delete a Knowledge article. Destructive: requires explicit confirmation and the dedicated delete scope.
confirmrequiredarticle_uuidrequiredidempotency_keyrequiredGet the current billing subscription.
Takes no parameters.
List billing invoices.
pageper_pageGet a billing invoice by UUID.
invoice_uuidrequiredList finance invoices.
pageper_pageGet a finance invoice by UUID.
invoice_uuidrequiredList finance expenses.
pageper_pageGet a finance expense by UUID.
expense_uuidrequiredList contract.
pagesearchper_pageGet one contract item by UUID.
item_uuidrequiredCreate a contract item. Requires confirmation.
datarequiredconfirmrequiredUpdate a contract item. Requires confirmation.
datarequiredconfirmrequireditem_uuidrequiredDelete a contract item. Destructive: requires confirmation.
confirmrequireditem_uuidrequiredList contract clause.
pagesearchper_pageGet one contract clause item by UUID.
item_uuidrequiredCreate a contract clause item. Requires confirmation.
datarequiredconfirmrequiredUpdate a contract clause item. Requires confirmation.
datarequiredconfirmrequireditem_uuidrequiredDelete a contract clause item. Destructive: requires confirmation.
confirmrequireditem_uuidrequiredList contract PDF design.
pagesearchper_pageGet one contract PDF design item by UUID.
item_uuidrequiredCreate a contract PDF design item. Requires confirmation.
datarequiredconfirmrequiredUpdate a contract PDF design item. Requires confirmation.
datarequiredconfirmrequireditem_uuidrequiredDelete a contract PDF design item. Destructive: requires confirmation.
confirmrequireditem_uuidrequiredList comments for a contract.
pageper_pagecontract_uuidrequiredAdd a comment to a contract. Requires confirmation.
datarequiredconfirmrequiredcontract_uuidrequiredUpdate a contract comment. Requires confirmation.
datarequiredconfirmrequiredcomment_uuidrequiredcontract_uuidrequiredDelete a contract comment. Destructive: requires confirmation.
confirmrequiredcomment_uuidrequiredcontract_uuidrequiredList negotiations for a contract.
pageper_pagecontract_uuidrequiredCreate a contract negotiation entry. Requires confirmation.
datarequiredconfirmrequiredcontract_uuidrequiredResolve a contract negotiation. Requires confirmation.
dataconfirmrequiredcontract_uuidrequirednegotiation_uuidrequiredList obligations for a contract.
pageper_pagecontract_uuidrequiredCreate a contract obligation. Requires confirmation.
datarequiredconfirmrequiredcontract_uuidrequiredUpdate a contract obligation. Requires confirmation.
datarequiredconfirmrequiredcontract_uuidrequiredobligation_uuidrequiredFulfill a contract obligation. Requires confirmation.
dataconfirmrequiredcontract_uuidrequiredobligation_uuidrequiredWaive a contract obligation. Requires confirmation.
dataconfirmrequiredcontract_uuidrequiredobligation_uuidrequiredSubmit a contract for approval. Requires confirmation.
dataconfirmrequiredcontract_uuidrequiredRequest signatures for a contract. Requires confirmation because it may notify signers.
dataconfirmrequiredcontract_uuidrequiredList contract requests.
pagesearchper_pageCreate a contract request. Requires confirmation.
datarequiredconfirmrequiredGet a contract request by UUID.
request_uuidrequiredadding a contract PDF design asset. Requires confirmation.
datarequiredconfirmrequireddesign_uuidrequiredadding a contract PDF design assignment. Requires confirmation.
datarequiredconfirmrequireddesign_uuidrequireddeleting a contract PDF design asset. Destructive: requires confirmation.
confirmrequiredchild_uuidrequireddesign_uuidrequireddeleting a contract PDF design assignment. Destructive: requires confirmation.
confirmrequiredchild_uuidrequireddesign_uuidrequiredList the projects visible to the user linked to the API key.
searchstatusper_pageinclude_archivedGet one project by UUID.
project_uuidrequiredList the task statuses of a project, in board order. Use their UUIDs to filter or transition tasks.
project_uuidrequiredSearch and paginate the tasks of a project.
typelabelssearchsprintstatusepic_idsort_byper_pageassigneesdue_statemilestonepriorities+3 moreGet one task with its relations (status, assignees, labels, parent, epic…).
task_uuidrequiredproject_uuidrequiredCreate a task, subtask or epic in a project. Requires confirmation.
typetitlerequiredconfirmrequireddue_datepriorityepic_uuiddescriptionparent_uuidproject_uuidrequiredtask_status_uuidUpdate a task and its planning references (sprint, milestone, estimates, custom fields). Use transition_project_task to change only the status. Requires confirmation.
typetitleconfirmrequireddue_datepriorityprogressepic_uuidtask_uuidrequireddescriptionparent_uuidsprint_uuidproject_uuidrequired+6 moreMove a task to another status of the same project. Requires confirmation.
confirmrequiredtask_uuidrequiredstatus_uuidrequiredproject_uuidrequiredList the visible comments of a task.
per_pagetask_uuidrequiredproject_uuidrequiredAdd a comment to a task, attributed to the user linked to the API key. Requires confirmation.
confirmrequiredcontentrequiredtask_uuidrequiredproject_uuidrequiredStep 1/3 for any Xalantis API operation without a dedicated tool (projects and tasks, compliance cases, signature envelopes, contract referentials, CRM imports…). Searches the 323 operations of the public API by keywords (all required, accents ignored; summaries are in French, e.g. "tâche commentaire"), area and HTTP method. Without any filter, lists the areas. Next: describe_operation.
areaquerymethodStep 2/3: path, query and header parameters, body schema and required scopes of one operation. Next: read_operation (GET) or call_operation (writes).
operation_idrequiredStep 3/3 for reads: runs a GET operation described by describe_operation. Never modifies data. Binary responses (exports, documents) are written to a local file.
querysave_topath_paramsoperation_idrequiredStep 3/3 for writes: runs a POST, PUT, PATCH or DELETE operation described by describe_operation. Can create, change or delete data within the API key scopes: requires confirm=true after explicit user confirmation. An Idempotency-Key is generated unless one is passed in headers; reuse it only to retry the exact same request.
bodyfilesqueryconfirmrequiredheaderssave_topath_paramsoperation_idrequired80% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Declare a license in the repository or the registry entry.
npm install -g @xalantis/mcp-server{ "mcpServers": { "xalantis": { "command": "npx", "args": ["-y", "@xalantis/mcp-server"], "env": { "XALANTIS_API_KEY": "sk_live_..." } } }}claude mcp add xalantis -- npx -y @xalantis/mcp-server{ "mcpServers": { "xalantis": { "command": "npx", "args": ["-y", "@xalantis/mcp-server"], "env": { "XALANTIS_API_KEY": "sk_live_..." } } }}{ "operation_id": "post_projects_By_projectUuid_tasks_By_taskUuid_time_entries", "path_params": { "projectUuid": "project-uuid", "taskUuid": "task-uuid" }, "body": { "duration_minutes": 45, "description": "Review" }, "confirm": true}{ "ticket_uuid": "ticket-uuid", "file_path": "/local/path/evidence.pdf", "confirm": true}{ "ticket_uuid": "ticket-uuid", "attachment_uuid": "attachment-uuid", "output_path": "/tmp/evidence.pdf", "confirm": true}npm cinpm run lintnpm test # compiles, then checks every tool against the bundled specnpm run sync-openapi -- path/to/openapi.json