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
托管的 Kickserv MCP 服务器，让助手查询客户、工单、备注和工时，并创建或更新客户、工单、任务、备注、工时和费用。
Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/io.usefulapi%2Fkickserv/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。把它添加到你客户端的 mcpServers 配置中。
{
"mcpServers": {
"kickserv-by-usefulapi": {
"type": "http",
"url": "https://kickserv.usefulapi.io/mcp"
}
}
}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
https://kickserv.usefulapi.io/mcp.claude mcp add --transport http kickserv https://kickserv.usefulapi.io/mcp, then run /mcp to log in.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.
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.
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].
MIT © usefulapi. Not affiliated with or endorsed by Kickserv.
来源：servers/kickserv/README.md，提交 f22f848
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_codeGet 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必填List a customer's jobs
List the jobs for one customer, 30 per page. Kickserv: GET /{account}/customers/{customer_number}/jobs.xml.
onlypageincludecustomer_number必填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_numberGet 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必填List a customer's notes
List the notes on one customer. Kickserv: GET /{account}/customers/{customer_number}/notes.xml.
customer_number必填List a job's notes
List the notes on one job. Kickserv: GET /{account}/jobs/{job_number}/notes.xml.
job_number必填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必填Get a task
Fetch one task (appointment / to-do attached to a job) by id. Kickserv: GET /{account}/tasks/{task_id}.xml.
task_id必填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.
无需输入参数。
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.
namepagewhichCreate 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 个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 个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必填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_onUpdate 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_idAdd 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必填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必填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_idAdd 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必填已满足适用检查项的 100%
该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。
io.usefulapi官方发布者
面向 Ably 的托管 MCP 服务器，让助手查看实时频道、在线状态与用量统计、发布消息，并查看应用配置。
io.usefulapi官方发布者
面向 Oyster 的远程 MCP 服务器，让助手读取团队、休假、报销、合同与发票数据，并审批或拒绝相关申请。
io.usefulapi官方发布者
读取 Avirato 酒店 PMS 的预订、可用房、房价与餐标数据，并可在预订上登记现金付款。
io.usefulapi官方发布者
托管的只读 MCP 服务器，让助手列出 Willo 账户中的面试、参与者和部门元数据。
io.usefulapi官方发布者
托管型 MCP 服务器，让助手读取 Testlify 招聘工作区的资料、测评和测评候选人。
{ "mcpServers": { "kickserv": { "url": "https://kickserv.usefulapi.io/mcp" } }}