Kickserv MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.39.1更新於 Nov 14, 2026

Look up Kickserv customers, jobs, notes and time entries, and create jobs, tasks and charges.

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行效率與工作流商業與電商

概覽

AI 產生的概覽

託管的 Kickserv MCP 伺服器,讓助理查詢客戶、工單、備註與工時,並建立或更新客戶、工單、任務、備註、工時與費用。

可以做什麼
  • 搜尋與讀取客戶,包含關聯聯絡人、工單、任務與備註
  • 列出並讀取工單(工作單、估價單、發票),含客戶、員工、費用明細與工時
  • 讀取客戶與工單的備註和工時紀錄,以及任務、員工與價目表項目
  • 建立與更新客戶和工單,包括改期與重新指派員工
  • 新增客戶與工單備註、建立任務、記錄工時、新增工單費用
  • 查看用量、提出功能需求、升級或取消訂閱
適用情境
適合以外勤服務或承包業務為主、使用 Kickserv 的團隊:想向助理詢問本週排程、客戶歷史、技師工時或工單狀態,或請助理代為草擬工單、任務與備註,而不必開啟應用程式。
執行需求
遠端 MCP 端點,只需填入 URL 連線;透過 OAuth 登入,首次連線時需提供 Kickserv 帳號 slug 與員工 API 權杖。無需本機安裝。免費方案每月 50 次工具呼叫,付費方案可提高上限。
安裝前請注意
有十個工具會寫入 Kickserv:建立或更新客戶與工單、新增備註、任務、工時與工單費用,並可能改變估價或發票總額。標示為公開的備註客戶可見。伺服器依使用者儲存 Kickserv 帳號 slug 與 API 權杖。付費方案透過 Stripe 結帳連結扣款,取消後當期不退款。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Kickserv MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Fkickserv/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "kickserv-by-usefulapi": {
      "type": "http",
      "url": "https://kickserv.usefulapi.io/mcp"
    }
  }
}

README

Kickserv MCP by usefulapi

Use Kickserv from Claude, Cursor, or any MCP client — look up customers, jobs, notes and time entries, and create or update customers, jobs, tasks, notes, time and charges. Hosted, no local install: connect with your own Kickserv credentials.

Live endpoint: https://kickserv.usefulapi.io/mcp · Homepage: https://usefulapi.io/kickserv

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://kickserv.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http kickserv https://kickserv.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "kickserv": {      "url": "https://kickserv.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Kickserv credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/kickserv/

On first connect you'll provide your Kickserv account slug (from app.kickserv.com/) and employee API token (My Account > API token). They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
kickserv_list_customersreadList customers
kickserv_get_customerreadGet a customer
kickserv_list_customer_jobsreadList a customer's jobs
kickserv_list_jobsreadList jobs
kickserv_get_jobreadGet a job
kickserv_list_customer_notesreadList a customer's notes
kickserv_list_job_notesreadList a job's notes
kickserv_list_job_time_entriesreadList a job's time entries
kickserv_get_taskreadGet a task
kickserv_list_employeesreadList employees
kickserv_list_itemsreadList items
kickserv_create_customerwriteCreate a customer
kickserv_update_customerwriteUpdate a customer
kickserv_add_customer_notewriteAdd a note to a customer
kickserv_create_jobwriteCreate a job
kickserv_update_jobwriteUpdate a job
kickserv_add_job_notewriteAdd a note to a job
kickserv_create_taskwriteCreate a task
kickserv_log_time_entrywriteLog time on a job
kickserv_add_job_chargewriteAdd a charge to a job
kickserv_usage_statusmetaUsage status (free-tier meter)
kickserv_request_featuremetaRequest a missing feature
kickserv_upgrademetaUpgrade to Pro or Pro+
kickserv_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run kickserv_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with kickserv_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with kickserv_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Kickserv.

來源:servers/kickserv/README.md,提交 f22f848

工具

20

kickserv_list_customers

List customers

List or search customers, 30 per page. Every filter is an exact match on that field. Use `only` to keep the response small. Kickserv: GET /{account}/customers.xml.

輸入參數nameonlypageincludebilling_cityphone_numberservice_citybilling_stateemail_addressservice_statecustomer_numberservice_zip_code

kickserv_get_customer

Get a customer

Fetch one customer by customer number, optionally with related contacts, jobs, tasks and notes. The result's `id` is what job/task create calls need as `customer_id`. Kickserv: GET /{account}/customers/{customer_number}.xml.

輸入參數includecustomer_number必填

kickserv_list_customer_jobs

List a customer's jobs

List the jobs for one customer, 30 per page. Kickserv: GET /{account}/customers/{customer_number}/jobs.xml.

輸入參數onlypageincludecustomer_number必填

kickserv_list_jobs

List jobs

List jobs (work orders, estimates, invoices), 30 per page, filterable by schedule window, status, assigned employee, category (job type) or job status. Kickserv: GET /{account}/jobs.xml.

輸入參數onlypagestatusincludescheduledjob_type_idjob_status_idemployee_number

kickserv_get_job

Get a job

Fetch one job by job number, optionally with its customer, assigned employees, job charges (line items), time entries and notes. Kickserv: GET /{account}/jobs/{job_number}.xml.

輸入參數includejob_number必填

kickserv_list_customer_notes

List a customer's notes

List the notes on one customer. Kickserv: GET /{account}/customers/{customer_number}/notes.xml.

輸入參數customer_number必填

kickserv_list_job_notes

List a job's notes

List the notes on one job. Kickserv: GET /{account}/jobs/{job_number}/notes.xml.

輸入參數job_number必填

kickserv_list_job_time_entries

List a job's time entries

List the time entries (hours logged by technicians) on one job. Kickserv: GET /{account}/jobs/{job_number}/time_entries.xml.

輸入參數job_number必填

kickserv_get_task

Get a task

Fetch one task (appointment / to-do attached to a job) by id. Kickserv: GET /{account}/tasks/{task_id}.xml.

輸入參數task_id必填

kickserv_list_employees

List employees

List all employees (technicians and office staff), active and inactive. Use their `id` for job/task assignment and time entries, and `employee_number` to filter jobs. Kickserv: GET /{account}/employees.xml.

無需輸入參數。

kickserv_list_items

List items

List products/services (the price list used for job charges), 30 per page. Active items only by default. Kickserv: GET /{account}/items.xml.

輸入參數namepagewhich

kickserv_create_customer

Create a customer

WRITE: create a new customer. Kickserv assigns the customer number. Kickserv: POST /{account}/customers.xml.

輸入參數faxname必填mobilecompanycontactis_activelast_namefirst_namealt_contactbilling_citycompany_namephone_number另有 19 個

kickserv_update_customer

Update a customer

WRITE: update fields on an existing customer. Only the fields you pass change. Balances, credit limit and custom fields are not settable here. Kickserv: PATCH /{account}/customers/{customer_number}.xml.

輸入參數faxnamemobilecompanycontactis_activelast_namefirst_namealt_contactbilling_citycompany_namephone_number另有 20 個

kickserv_add_customer_note

Add a note to a customer

WRITE: add a note to a customer. Set `public` to true to make it visible to the customer. Kickserv: POST /{account}/customers/{customer_number}/notes.xml.

輸入參數note必填publiccustomer_number必填

kickserv_create_job

Create a job

WRITE: create a job (work order) for a customer. `customer_id` is the customer's internal `id` (from kickserv_get_customer), not the customer number; `job_type_id` is the job category. Set `estimate` to create it as an estimate. Kickserv: POST /{account}/jobs.xml.

輸入參數nameends_atdurationestimatepo_numbercustomer_id必填descriptionjob_type_id必填employee_idsscheduled_on

kickserv_update_job

Update a job

WRITE: update an existing job — reschedule it, rename it, change its description, category or custom job status, or reassign employees (employee_ids replaces the assignment). Totals, tax and payment fields are not settable here. Kickserv: PATCH /{account}/jobs/{job_number}.xml.

輸入參數nameends_atdurationpo_numberjob_number必填descriptionjob_type_idemployee_idsscheduled_onjob_status_id

kickserv_add_job_note

Add a note to a job

WRITE: add a note to a job. Set `public` to true to make it visible to the customer. Kickserv: POST /{account}/jobs/{job_number}/notes.xml.

輸入參數note必填publicjob_number必填

kickserv_create_task

Create a task

WRITE: create a task (appointment / to-do) on a job and optionally assign employees. `job_id` is the job's internal `id` (from kickserv_get_job), not the job number. Kickserv: POST /{account}/tasks.xml.

輸入參數name必填job_id必填ends_atdurationcustomer_iddescriptionemployee_idsscheduled_attask_type_id必填

kickserv_log_time_entry

Log time on a job

WRITE: log hours worked by an employee on a job. `employee_id` is the employee's `id` from kickserv_list_employees. Kickserv: POST /{account}/jobs/{job_number}/time_entries.xml.

輸入參數notemileagebillableended_onjob_number必填started_on必填employee_id必填number_of_hours必填time_entry_type_id

kickserv_add_job_charge

Add a charge to a job

WRITE: add a charge (line item — a product, service or part) to a job. This changes the job's estimate/invoice total; it does NOT charge the customer's card. Pick `item_id` from kickserv_list_items. Kickserv: POST /{account}/jobs/{job_number}/job_charges.xml.

輸入參數detailsitem_iddiscountquantityjob_number必填descriptionprice_per_unitjob_charge_type_id必填

版本歷史

25
  1. v1.39.1最新Nov 13, 2026
  2. v1.38.0Nov 12, 2026
  3. v1.37.3Nov 11, 2026
  4. v1.36.5Nov 8, 2026
  5. v1.36.4Nov 7, 2026
  6. v1.35.3Nov 5, 2026
  7. v1.35.2Nov 5, 2026
  8. v1.35.1Nov 4, 2026
  9. v1.35.0Nov 3, 2026
  10. v1.34.1Nov 3, 2026
  11. v1.33.0Nov 1, 2026
  12. v1.31.0Oct 31, 2026
  13. v1.30.0Oct 31, 2026
  14. v1.29.2Oct 30, 2026
  15. v1.29.0Oct 30, 2026
  16. v1.24.0Oct 26, 2026
  17. v1.21.3Oct 25, 2026
  18. v1.21.0Oct 25, 2026
  19. v1.20.0Oct 24, 2026
  20. v1.17.0Oct 23, 2026
  21. v1.16.4Oct 22, 2026
  22. v1.16.3Oct 21, 2026
  23. v1.11.1Oct 9, 2026
  24. v1.10.0Oct 9, 2026
  25. v1.0.0Sep 30, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合