Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

io.usefulapi/kickserv

REMOTE · KICKSERV.USEFULAPI.IO · SCANNED OCT 4

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

76 Trust /100
Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →

Endpoint Security89
Transport & Reachability100
Schema Quality & AI Usability70
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 3534 tokens (~176/item across 20 items; 20 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management13
  • Stability observed for 4 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
  • An AI judge read all 20 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities60
  • Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28. See how to fix → Fail
Install

How do I install the io.usefulapi/kickserv MCP server?

io.usefulapi/kickserv is a hosted endpoint at https://kickserv.usefulapi.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

remote · kickserv.usefulapi.io

# add to Claude Code
claude mcp add --transport http io-usefulapi-kickserv 'https://kickserv.usefulapi.io/mcp'
// .cursor/mcp.json
{
  "mcpServers": {
    "io-usefulapi-kickserv": {
      "url": "https://kickserv.usefulapi.io/mcp"
    }
  }
}
// .vscode/mcp.json
{
  "servers": {
    "io-usefulapi-kickserv": {
      "type": "http",
      "url": "https://kickserv.usefulapi.io/mcp"
    }
  }
}
# ~/.codex/config.toml
[mcp_servers.io-usefulapi-kickserv]
url = "https://kickserv.usefulapi.io/mcp"
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-kickserv": {
      "type": "remote",
      "url": "https://kickserv.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add io-usefulapi-kickserv --url 'https://kickserv.usefulapi.io/mcp' --transport streamable-http
# ~/.hermes/config.yaml
mcp_servers:
  io-usefulapi-kickserv:
    url: "https://kickserv.usefulapi.io/mcp"
// ~/.netclaw/config/netclaw.json
{
  "McpServers": {
    "io-usefulapi-kickserv": {
      "Transport": "http",
      "Url": "https://kickserv.usefulapi.io/mcp"
    }
  }
}
# add to Vellum
assistant mcp add io-usefulapi-kickserv -t streamable-http -u 'https://kickserv.usefulapi.io/mcp'
// mcp.json
{
  "mcpServers": {
    "io-usefulapi-kickserv": {
      "type": "http",
      "url": "https://kickserv.usefulapi.io/mcp"
    }
  }
}

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 2 Oct 26 +1
    • Server version: 1.3.0 → 1.5.1 functional
  • 1 Oct 26 +5
    • HTTPS: unverified → pass ▲ security
    • Stability: unverified → 0.03 ▲ functional
    • Server version: 1.0.0 → 1.3.0 functional
  • 30 Sept 26 +52
    • Authorization: unverified → pass ▲ security
    • Injection markers: unverified → pass ▲ security
    • Transport: fail → pass ▲ security
    • First check of Judged manipulation: pass security
    • First check of Authorization: partial security
    • MCP protocol: unverified → fail ▼ functional
    • Tool coverage: unverified → 100 ▲ functional
    • First check of Schema quality: fail functional
    • First check of Schema quality: excellent functional
    • First check of Schema quality: fail functional
    • First check of Destructive annotations: 100 functional
    • First check of Tool coverage: 100 functional
  • 29 Sept 26 18

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 4 Oct 2026 · Probed https://kickserv.usefulapi.io/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject Issuer Valid from Valid until Key Signature Serial
CN=usefulapi.io CN=WE1,O=Google Trust Services,C=US 13 Sept 2026 12 Dec 2026 ECDSA 256 ECDSA-SHA256 d9be3287b0fde9630e825ba1f79bff3f
SANs: usefulapi.io, *.usefulapi.io
CN=WE1,O=Google Trust Services,C=US (CA) CN=GTS Root R4,O=Google Trust Services LLC,C=US 13 Dec 2023 20 Feb 2029 ECDSA 256 ECDSA-SHA384 7ff31977972c224a76155d13b6d685e3
CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE 15 Nov 2023 28 Jan 2028 ECDSA 384 SHA256-RSA 7fe530bf331343bedd821610493d8a1b

Background: What to check on a remote MCP endpoint →

DNSSEC insecure

Validation of kickserv.usefulapi.io. — Not signed

Zone DS Keys Algorithms Outcome
. trust_anchor 20326, 38696 8, 8 Verified
io. present 57355 8 Verified
usefulapi.io. absent Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation
Authentication Enforced and verified

The endpoint asked for a token and published valid RFC 9728 metadata describing how to get one.

Result Enforced and verified
Enforced On tool calls
HTTP status 200

WWW-Authenticate challenge Bearer realm="OAuth", resource_metadata="https://kickserv.usefulapi.io/.well-known/oauth-protected-resource/mcp"

Bearer realm="OAuth", resource_metadata="https://kickserv.usefulapi.io/.well-known/oauth-protected-resource/mcp"

Protected resource metadata

Document https://kickserv.usefulapi.io/.well-known/oauth-protected-resource/mcp
Retrieved Yes
Resource https://kickserv.usefulapi.io/mcp
Authorisation server https://kickserv.usefulapi.io

Background: How OAuth 2.1 works in the 2026 MCP spec →

Transports 2 probes
Transport URL Outcome Status Location
streamable-http https://kickserv.usefulapi.io/mcp Verified 200
http (plaintext) http://kickserv.usefulapi.io/mcp HTTPS enforced 301 https://kickserv.usefulapi.io/mcp
MCP tools · 20 exposed · ~3,534 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
kickserv_add_customer_note ~85

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.

NameTypeReqDescription
customer_numberintegeryesCustomer number.
notestringyesNote text.
publicboolean–True to make the note public (customer-visible).

No output schema declared.

No examples provided.

kickserv_add_job_charge ~166

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.

NameTypeReqDescription
descriptionstring–Line-item description.
detailsstring–Line-item details.
discountnumber–Discount.
item_idinteger–Item `id` from kickserv_list_items.
job_charge_type_idintegeryesJob charge type id.
job_numberintegeryesJob number.
price_per_unitnumber–Unit price.
quantitynumber–Quantity.

No output schema declared.

No examples provided.

kickserv_add_job_note ~85

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.

NameTypeReqDescription
job_numberintegeryesJob number.
notestringyesNote text.
publicboolean–True to make the note public (customer-visible).

No output schema declared.

No examples provided.

kickserv_create_customer ~437

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

NameTypeReqDescription
account_numberstring–Your own account number for the customer.
alt_contactstring–Alternate contact name.
alt_phone_numberstring–Alternate phone number.
billing_addressstring–Billing address (where invoices go), line 1.
billing_address_2string–Billing address line 2.
billing_citystring–Billing city.
billing_countrystring–Billing country.
billing_statestring–Billing state.
billing_zip_codestring–Billing ZIP/postal code.
companyboolean–True if the customer is a company rather than a person.
company_namestring–Company name.
contactstring–Primary contact name.
customer_source_idinteger–Customer source (lead source) id.
customer_type_idinteger–Customer type id.
email_addressstring–Email address.
faxstring–Fax number.
first_namestring–Contact first name.
is_activeboolean–False to mark the customer inactive (reversible).
last_namestring–Contact last name.
mobilestring–Mobile number.
namestringyesCustomer name (required).
notify_via_emailboolean–Send the customer email notifications.
notify_via_smsboolean–Send the customer SMS notifications.
phone_numberstring–Phone number.
service_addressstring–Service address (where the work happens), line 1.
service_address_2string–Service address line 2.
service_citystring–Service city.
service_countrystring–Service country (2-letter code).
service_statestring–Service state (2-letter abbreviation in the US).
service_zip_codestring–Service ZIP/postal code.
special_instructionsstring–Special instructions shown to technicians.

No output schema declared.

No examples provided.

kickserv_create_job ~302

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.

NameTypeReqDescription
customer_idintegeryesThe customer's internal `id` (NOT the customer_number).
descriptionstring–Job description / work to be done.
durationnumber–Job duration.
employee_idsarray–Employee `id`s (from kickserv_list_employees) to assign. Replaces the current assignment.
ends_atstring–When the job ends. A date/time string Kickserv can parse, e.g. `2026-10-02 09:30` or `10/2/2026 09:30am`.
estimateboolean–True to create the job as an estimate.
job_type_idintegeryesJob category (job type) id.
namestring–Job name/title.
po_numberstring–Customer purchase-order number.
scheduled_onstring–When the job is scheduled. A date/time string Kickserv can parse, e.g. `2026-10-02 09:30` or `10/2/2026 09:30am`.

No output schema declared.

No examples provided.

kickserv_create_task ~265

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.

NameTypeReqDescription
customer_idinteger–The customer's internal `id`.
descriptionstring–Task description.
durationinteger–Task duration.
employee_idsarray–Employee `id`s (from kickserv_list_employees) to assign. Replaces the current assignment.
ends_atstring–When the task ends. A date/time string Kickserv can parse, e.g. `2026-10-02 09:30` or `10/2/2026 09:30am`.
job_idintegeryesThe job's internal `id` (NOT the job_number).
namestringyesTask name.
scheduled_atstring–When the task is scheduled. A date/time string Kickserv can parse, e.g. `2026-10-02 09:30` or `10/2/2026 09:30am`.
task_type_idintegeryesTask type id.

No output schema declared.

No examples provided.

kickserv_get_customer ~104

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.

NameTypeReqDescription
customer_numberintegeryesCustomer number (as shown in Kickserv).
includearray–Related data to embed: contacts, jobs, tasks, notes, tax_entity, custom_field_assignments.

No output schema declared.

No examples provided.

kickserv_get_job ~105

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.

NameTypeReqDescription
includearray–Related data to embed: customer, employees, job_charges, time_entries, notes, job_type, job_status, tax_entity, custom_field_assignments.
job_numberintegeryesJob number (as shown in Kickserv).

No output schema declared.

No examples provided.

kickserv_get_task ~51

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

NameTypeReqDescription
task_idintegeryesTask id.

No output schema declared.

No examples provided.

kickserv_list_customer_jobs ~148

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

NameTypeReqDescription
customer_numberintegeryesCustomer number.
includearray–Related data to embed: customer, employees, job_charges, time_entries, notes, job_type, job_status, tax_entity, custom_field_assignments.
onlystring–Comma-separated list of columns to return, e.g. `customer_number,name`. Kickserv recommends this: it makes responses much smaller and faster.
pageinteger–Page number (Kickserv returns 30 records per page). Omit for page 1.

No output schema declared.

No examples provided.

kickserv_list_customer_notes ~44

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

NameTypeReqDescription
customer_numberintegeryesCustomer number.

No output schema declared.

No examples provided.

kickserv_list_customers ~258

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.

NameTypeReqDescription
billing_citystring–Billing city.
billing_statestring–Billing state.
customer_numberinteger–Customer number.
email_addressstring–Exact email address.
includearray–Related data to embed: contacts, jobs, tasks, notes, tax_entity, custom_field_assignments.
namestring–Exact customer name.
onlystring–Comma-separated list of columns to return, e.g. `customer_number,name`. Kickserv recommends this: it makes responses much smaller and faster.
pageinteger–Page number (Kickserv returns 30 records per page). Omit for page 1.
phone_numberstring–Exact phone number, e.g. 800-555-1212.
service_citystring–Service city.
service_statestring–Service state (2-letter abbreviation).
service_zip_codestring–Service ZIP (full zip+4 if the record has one).

No output schema declared.

No examples provided.

kickserv_list_employees ~58

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.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

kickserv_list_items ~100

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

NameTypeReqDescription
namestring–Filter by item name.
pageinteger–Page number (Kickserv returns 30 records per page). Omit for page 1.
whichstring–Which items to return: active (default), inactive, or all.

No output schema declared.

No examples provided.

kickserv_list_job_notes ~44

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

NameTypeReqDescription
job_numberintegeryesJob number.

No output schema declared.

No examples provided.

kickserv_list_job_time_entries ~53

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

NameTypeReqDescription
job_numberintegeryesJob number.

No output schema declared.

No examples provided.

kickserv_list_jobs ~232

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.

NameTypeReqDescription
employee_numberinteger–Only jobs assigned to this employee number.
includearray–Related data to embed: customer, employees, job_charges, time_entries, notes, job_type, job_status, tax_entity, custom_field_assignments.
job_status_idinteger–Only jobs with this custom job status id.
job_type_idinteger–Only jobs in this category (job type id).
onlystring–Comma-separated list of columns to return, e.g. `customer_number,name`. Kickserv recommends this: it makes responses much smaller and faster.
pageinteger–Page number (Kickserv returns 30 records per page). Omit for page 1.
scheduledstring–Scheduled-date window, e.g. today or this_week.
statusstring–Job status.

No output schema declared.

No examples provided.

kickserv_log_time_entry ~239

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.

NameTypeReqDescription
billableboolean–Whether the time is billable.
employee_idintegeryesThe employee's `id`.
ended_onstring–When the work ended. A date/time string Kickserv can parse, e.g. `2026-10-02 09:30` or `10/2/2026 09:30am`.
job_numberintegeryesJob number.
mileagenumber–Mileage driven.
notestring–Note about the work.
number_of_hoursnumberyesHours worked, e.g. 1.25.
started_onstringyesWhen the work started, e.g. `2026-10-02 13:00` or `10/02/2026 01:00pm`.
time_entry_type_idinteger–Time entry type id.

No output schema declared.

No examples provided.

kickserv_update_customer ~468

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.

NameTypeReqDescription
account_numberstring–Your own account number for the customer.
alt_contactstring–Alternate contact name.
alt_phone_numberstring–Alternate phone number.
billing_addressstring–Billing address (where invoices go), line 1.
billing_address_2string–Billing address line 2.
billing_citystring–Billing city.
billing_countrystring–Billing country.
billing_statestring–Billing state.
billing_zip_codestring–Billing ZIP/postal code.
companyboolean–True if the customer is a company rather than a person.
company_namestring–Company name.
contactstring–Primary contact name.
customer_numberintegeryesCustomer number to update.
customer_source_idinteger–Customer source (lead source) id.
customer_type_idinteger–Customer type id.
email_addressstring–Email address.
faxstring–Fax number.
first_namestring–Contact first name.
is_activeboolean–False to mark the customer inactive (reversible).
last_namestring–Contact last name.
mobilestring–Mobile number.
namestring–New customer name.
notify_via_emailboolean–Send the customer email notifications.
notify_via_smsboolean–Send the customer SMS notifications.
phone_numberstring–Phone number.
service_addressstring–Service address (where the work happens), line 1.
service_address_2string–Service address line 2.
service_citystring–Service city.
service_countrystring–Service country (2-letter code).
service_statestring–Service state (2-letter abbreviation in the US).
service_zip_codestring–Service ZIP/postal code.
special_instructionsstring–Special instructions shown to technicians.

No output schema declared.

No examples provided.

kickserv_update_job ~290

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.

NameTypeReqDescription
descriptionstring–Job description / work to be done.
durationnumber–Job duration.
employee_idsarray–Employee `id`s (from kickserv_list_employees) to assign. Replaces the current assignment.
ends_atstring–When the job ends. A date/time string Kickserv can parse, e.g. `2026-10-02 09:30` or `10/2/2026 09:30am`.
job_numberintegeryesJob number to update.
job_status_idinteger–New custom job status id.
job_type_idinteger–New job category (job type) id.
namestring–Job name/title.
po_numberstring–Customer purchase-order number.
scheduled_onstring–When the job is scheduled. A date/time string Kickserv can parse, e.g. `2026-10-02 09:30` or `10/2/2026 09:30am`.

No output schema declared.

No examples provided.

Common questions

What is the io.usefulapi/kickserv MCP server?

io.usefulapi/kickserv is an MCP server listed in the public MCP registry as io.usefulapi/kickserv. Look up Kickserv customers, jobs, notes and time entries, and create jobs, tasks and charges. This page covers its hosted endpoint (https://kickserv.usefulapi.io/mcp).

Is the io.usefulapi/kickserv MCP server safe to use?

io.usefulapi/kickserv scores 76 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the io.usefulapi/kickserv MCP server expose?

io.usefulapi/kickserv exposes 20 tools: kickserv_list_customers, kickserv_get_customer, kickserv_list_customer_jobs, kickserv_list_jobs, kickserv_get_job, and 15 more. Their descriptions and schemas cost roughly 3,534 tokens of context every time the server is loaded.

Does the io.usefulapi/kickserv MCP server require authentication?

Yes. io.usefulapi/kickserv asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.

Is the io.usefulapi/kickserv MCP server still maintained?

io.usefulapi/kickserv is still listed as active in the MCP registry. We last reached this channel on 4 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.