list_tickets
List support tickets with optional filters and pagination.
pagesearchstatussort_byper_pageprioritysort_dirrequester_emailio.github.xalantis-hub由 GitHub 帳號 xalantis-hub 發布v0.3.1更新於 Oct 25, 2026
Tickets, CRM, contracts, projects and the whole Xalantis public API from your AI assistant.
本機 MCP 伺服器,讓助理透過 Xalantis 公開 API 讀取並操作工單、CRM、合約、知識庫、帳務和專案等業務資料。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
參照 儲存庫 中的啟動說明。
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
來源:README.md,提交 8e715a8
List support tickets with optional filters and pagination.
pagesearchstatussort_byper_pageprioritysort_dirrequester_emailGet a single ticket by UUID.
uuid必填Create a new support ticket. The assistant/client should ask for user confirmation before creating user-visible tickets.
typechannelconfirmsubject必填prioritydescription必填category_slugrequester_namerequester_email必填Update an existing ticket. Requires confirmation for status/assignee/priority changes that affect operations.
uuid必填due_atstatusconfirmsubjectpriorityassignee_iddescriptioncategory_slugDelete a ticket. Destructive: requires explicit confirmation.
uuid必填confirm必填Get support ticket metrics.
tofromgroup_byList activity history for a ticket.
pageper_pageticket_uuid必填List all replies and notes for a ticket.
pageper_pageticket_uuid必填Add a reply or internal note to a ticket. Public replies should be confirmed by the user first.
confirmcontent必填is_internalticket_uuid必填Update a ticket reply or internal note.
confirmcontent必填reply_uuid必填ticket_uuid必填Delete a ticket reply. Destructive: requires explicit confirmation.
confirm必填reply_uuid必填ticket_uuid必填List links attached to a ticket.
pageper_pageticket_uuid必填Link a ticket to another ticket or object. Requires confirmation.
data必填confirm必填ticket_uuid必填Remove a ticket link. Destructive: requires confirmation.
confirm必填link_uuid必填ticket_uuid必填List time entries for a ticket.
pageper_pageticket_uuid必填Create a time entry on a ticket. Requires confirmation.
data必填confirm必填ticket_uuid必填List watchers for a ticket.
pageper_pageticket_uuid必填Add or remove a ticket watcher. Requires confirmation because it changes notifications.
data必填confirm必填ticket_uuid必填Run or mark triage for a ticket. Requires confirmation.
dataconfirm必填ticket_uuid必填Escalate a ticket. Requires confirmation.
dataconfirm必填ticket_uuid必填De-escalate a ticket. Requires confirmation.
dataconfirm必填ticket_uuid必填List service catalog items visible to the API key.
pagesearchcategoryper_pageCreate a service request from a catalog item. Requires confirmation.
data必填confirm必填catalog_item_uuid必填Approve a service request. Requires confirmation.
dataconfirm必填ticket_uuid必填Reject a service request. Requires confirmation.
dataconfirm必填ticket_uuid必填Fulfill a service request. Requires confirmation.
dataconfirm必填ticket_uuid必填Reopen a service request. Requires confirmation.
dataconfirm必填ticket_uuid必填List ticket categories.
pagesearchper_pageList ticket tags.
pagesearchper_pageAttach or detach a tag on a ticket. Requires confirmation.
dataconfirm必填tag_uuid必填ticket_uuid必填List SLA breaches.
pagestatusper_pageAcknowledge an SLA breach. Requires confirmation.
dataconfirm必填breach_uuid必填Run a bulk ticket action. Requires confirmation.
data必填confirm必填List generated ticket reports.
pageper_pageDownload a generated ticket report. Returns base64 unless output_path is provided.
confirm必填output_pathreport_uuid必填Create a ticket report. Requires confirmation because it may process/export sensitive data.
data必填confirm必填archiving a ticket. Requires confirmation.
dataconfirm必填ticket_uuid必填unarchiving a ticket. Requires confirmation.
dataconfirm必填ticket_uuid必填restoring ticket independence. Requires confirmation.
dataconfirm必填ticket_uuid必填duplicating a ticket. Requires confirmation.
dataconfirm必填ticket_uuid必填linking a duplicate ticket. Requires confirmation.
dataconfirm必填ticket_uuid必填merging a ticket. Requires confirmation.
dataconfirm必填ticket_uuid必填splitting a ticket. Requires confirmation.
dataconfirm必填ticket_uuid必填List merge candidates for a ticket.
pageper_pageticket_uuid必填List duplicate candidates for a ticket.
pageper_pageticket_uuid必填List escalation executions for a ticket.
pageper_pageticket_uuid必填List ticket attachments metadata.
pageper_pageticket_uuid必填Upload a local file as a ticket attachment. Requires confirmation.
dataconfirm必填file_path必填field_nameticket_uuid必填Download a ticket attachment. Returns base64 unless output_path is provided.
confirm必填output_pathticket_uuid必填attachment_uuid必填Delete a ticket attachment. Destructive: requires confirmation.
confirm必填ticket_uuid必填attachment_uuid必填Retry a failed ticket reply. Requires confirmation.
dataconfirm必填reply_uuid必填ticket_uuid必填creating a ticket subtask. Requires confirmation.
dataconfirm必填child_uuidticket_uuid必填toggling a ticket subtask. Requires confirmation.
dataconfirm必填child_uuidticket_uuid必填deleting a ticket subtask. Requires confirmation.
dataconfirm必填child_uuidticket_uuid必填updating a ticket time entry. Requires confirmation.
dataconfirm必填child_uuidticket_uuid必填deleting a ticket time entry. Requires confirmation.
dataconfirm必填child_uuidticket_uuid必填Acknowledge requester response on a ticket. Requires confirmation.
dataconfirm必填ticket_uuid必填List incident updates for a ticket.
pageper_pageticket_uuid必填Create an incident update. Requires confirmation.
data必填confirm必填ticket_uuid必填Get incident report for a ticket.
ticket_uuid必填Get archived incident report for a ticket.
ticket_uuid必填archiving an incident report. Requires confirmation.
dataconfirm必填ticket_uuid必填requesting incident report signoff. Requires confirmation.
dataconfirm必填ticket_uuid必填linking incident CI. Requires confirmation.
dataconfirm必填ticket_uuid必填linking incident problem. Requires confirmation.
dataconfirm必填ticket_uuid必填linking incident service component. Requires confirmation.
dataconfirm必填ticket_uuid必填updating incident publication. Requires confirmation.
dataconfirm必填ticket_uuid必填updating incident severity override. Requires confirmation.
dataconfirm必填ticket_uuid必填updating incident closure review. Requires confirmation.
dataconfirm必填ticket_uuid必填Get Service Desk agent status.
pageper_pageUpdate Service Desk agent status. Requires confirmation.
data必填confirm必填List service catalog administration view.
pagesearchper_pageGet a service catalog item by UUID.
item_uuid必填creating a service catalog item. Requires confirmation.
dataconfirm必填item_uuidupdating a service catalog item. Requires confirmation.
dataconfirm必填item_uuiddeleting a service catalog item. Requires confirmation.
dataconfirm必填item_uuidduplicating a service catalog item. Requires confirmation.
dataconfirm必填item_uuidtoggling a service catalog item. Requires confirmation.
dataconfirm必填item_uuidList ticket reply template.
pagesearchper_pageCreate a ticket reply template item. Requires confirmation.
data必填confirm必填Update a ticket reply template item. Requires confirmation.
data必填confirm必填item_uuid必填Delete a ticket reply template item. Destructive: requires confirmation.
confirm必填item_uuid必填List ticket automation.
pagesearchper_pageCreate a ticket automation item. Requires confirmation.
data必填confirm必填Update a ticket automation item. Requires confirmation.
data必填confirm必填item_uuid必填Delete a ticket automation item. Destructive: requires confirmation.
confirm必填item_uuid必填Create a ticket category. Requires confirmation.
data必填confirm必填Update a ticket category. Requires confirmation.
data必填confirm必填item_uuid必填Delete a ticket category. Destructive: requires confirmation.
confirm必填item_uuid必填Create a ticket tag. Requires confirmation.
data必填confirm必填Update a ticket tag. Requires confirmation.
data必填confirm必填item_uuid必填Delete a ticket tag. Destructive: requires confirmation.
confirm必填item_uuid必填Create a SLA policy. Requires confirmation.
data必填confirm必填Update a SLA policy. Requires confirmation.
data必填confirm必填item_uuid必填Delete a SLA policy. Destructive: requires confirmation.
confirm必填item_uuid必填List SLA policies.
pagesearchper_pageList escalation policies.
pagesearchper_pageCreate an escalation policy. Requires confirmation.
data必填confirm必填Update an escalation policy. Requires confirmation.
data必填confirm必填policy_uuid必填Reorder ticket automations. Requires confirmation.
data必填confirm必填List executions for a ticket automation.
pageper_pageautomation_uuid必填duplicating ticket automation. Requires confirmation.
dataconfirm必填automation_uuid必填toggling ticket automation. Requires confirmation.
dataconfirm必填automation_uuid必填List client.
pagesearchper_pageGet one client item by UUID.
item_uuid必填Create a client item. Requires confirmation.
data必填confirm必填Update a client item. Requires confirmation.
data必填confirm必填item_uuid必填Delete a client item. Destructive: requires confirmation.
confirm必填item_uuid必填List contact.
pagesearchper_pageGet one contact item by UUID.
item_uuid必填Create a contact item. Requires confirmation.
data必填confirm必填Update a contact item. Requires confirmation.
data必填confirm必填item_uuid必填Delete a contact item. Destructive: requires confirmation.
confirm必填item_uuid必填List deal.
pagesearchper_pageGet one deal item by UUID.
item_uuid必填Create a deal item. Requires confirmation.
data必填confirm必填Update a deal item. Requires confirmation.
data必填confirm必填item_uuid必填Delete a deal item. Destructive: requires confirmation.
confirm必填item_uuid必填List representatives for a client.
pageper_pageclient_uuid必填Create a representative for a client. Requires confirmation.
data必填confirm必填client_uuid必填List 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.
identifier必填Get UUID-based categories, products and labels accepted by Knowledge article writes.
無需輸入參數。
List internal Knowledge articles visible to the configured integration actor.
pagelocalesearchstatusper_pageproduct_uuidcategory_uuidGet an internal Knowledge article by UUID.
article_uuid必填Create an internal Knowledge draft. Requires explicit confirmation and a stable idempotency key.
data必填confirm必填idempotency_key必填Update a draft or stage a revision for a published article. Requires explicit confirmation.
data必填confirm必填article_uuid必填idempotency_key必填Submit a Knowledge draft or pending revision to editorial review. Requires explicit confirmation.
confirm必填article_uuid必填idempotency_key必填Archive a Knowledge article while preserving its history. Requires explicit confirmation.
confirm必填article_uuid必填idempotency_key必填Soft-delete a Knowledge article. Destructive: requires explicit confirmation and the dedicated delete scope.
confirm必填article_uuid必填idempotency_key必填Get the current billing subscription.
無需輸入參數。
List billing invoices.
pageper_pageGet a billing invoice by UUID.
invoice_uuid必填List finance invoices.
pageper_pageGet a finance invoice by UUID.
invoice_uuid必填List finance expenses.
pageper_pageGet a finance expense by UUID.
expense_uuid必填List contract.
pagesearchper_pageGet one contract item by UUID.
item_uuid必填Create a contract item. Requires confirmation.
data必填confirm必填Update a contract item. Requires confirmation.
data必填confirm必填item_uuid必填Delete a contract item. Destructive: requires confirmation.
confirm必填item_uuid必填List contract clause.
pagesearchper_pageGet one contract clause item by UUID.
item_uuid必填Create a contract clause item. Requires confirmation.
data必填confirm必填Update a contract clause item. Requires confirmation.
data必填confirm必填item_uuid必填Delete a contract clause item. Destructive: requires confirmation.
confirm必填item_uuid必填List contract PDF design.
pagesearchper_pageGet one contract PDF design item by UUID.
item_uuid必填Create a contract PDF design item. Requires confirmation.
data必填confirm必填Update a contract PDF design item. Requires confirmation.
data必填confirm必填item_uuid必填Delete a contract PDF design item. Destructive: requires confirmation.
confirm必填item_uuid必填List comments for a contract.
pageper_pagecontract_uuid必填Add a comment to a contract. Requires confirmation.
data必填confirm必填contract_uuid必填Update a contract comment. Requires confirmation.
data必填confirm必填comment_uuid必填contract_uuid必填Delete a contract comment. Destructive: requires confirmation.
confirm必填comment_uuid必填contract_uuid必填List negotiations for a contract.
pageper_pagecontract_uuid必填Create a contract negotiation entry. Requires confirmation.
data必填confirm必填contract_uuid必填Resolve a contract negotiation. Requires confirmation.
dataconfirm必填contract_uuid必填negotiation_uuid必填List obligations for a contract.
pageper_pagecontract_uuid必填Create a contract obligation. Requires confirmation.
data必填confirm必填contract_uuid必填Update a contract obligation. Requires confirmation.
data必填confirm必填contract_uuid必填obligation_uuid必填Fulfill a contract obligation. Requires confirmation.
dataconfirm必填contract_uuid必填obligation_uuid必填Waive a contract obligation. Requires confirmation.
dataconfirm必填contract_uuid必填obligation_uuid必填Submit a contract for approval. Requires confirmation.
dataconfirm必填contract_uuid必填Request signatures for a contract. Requires confirmation because it may notify signers.
dataconfirm必填contract_uuid必填List contract requests.
pagesearchper_pageCreate a contract request. Requires confirmation.
data必填confirm必填Get a contract request by UUID.
request_uuid必填adding a contract PDF design asset. Requires confirmation.
data必填confirm必填design_uuid必填adding a contract PDF design assignment. Requires confirmation.
data必填confirm必填design_uuid必填deleting a contract PDF design asset. Destructive: requires confirmation.
confirm必填child_uuid必填design_uuid必填deleting a contract PDF design assignment. Destructive: requires confirmation.
confirm必填child_uuid必填design_uuid必填List the projects visible to the user linked to the API key.
searchstatusper_pageinclude_archivedGet one project by UUID.
project_uuid必填List the task statuses of a project, in board order. Use their UUIDs to filter or transition tasks.
project_uuid必填Search and paginate the tasks of a project.
typelabelssearchsprintstatusepic_idsort_byper_pageassigneesdue_statemilestonepriorities另有 3 個Get one task with its relations (status, assignees, labels, parent, epic…).
task_uuid必填project_uuid必填Create a task, subtask or epic in a project. Requires confirmation.
typetitle必填confirm必填due_datepriorityepic_uuiddescriptionparent_uuidproject_uuid必填task_status_uuidUpdate a task and its planning references (sprint, milestone, estimates, custom fields). Use transition_project_task to change only the status. Requires confirmation.
typetitleconfirm必填due_datepriorityprogressepic_uuidtask_uuid必填descriptionparent_uuidsprint_uuidproject_uuid必填另有 6 個Move a task to another status of the same project. Requires confirmation.
confirm必填task_uuid必填status_uuid必填project_uuid必填List the visible comments of a task.
per_pagetask_uuid必填project_uuid必填Add a comment to a task, attributed to the user linked to the API key. Requires confirmation.
confirm必填content必填task_uuid必填project_uuid必填Step 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_id必填Step 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_id必填Step 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.
bodyfilesqueryconfirm必填headerssave_topath_paramsoperation_id必填已滿足適用檢查項的 80%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
請在儲存庫或註冊中心條目中宣告授權條款。
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