Skip to main content
Glama
the-real-snipeit-mcp

the-real-snipeit-mcp

the-real-snipeit-mcp

An unofficial MCP server for the Snipe-IT REST API: one generated tool for every operation in the vendored Snipe-IT OpenAPI 3.1 spec (read + write), hand-written wrappers for common workflows, stdio transport.

Unofficial, not affiliated with Snipe-IT/Grokability. This project is not affiliated with, endorsed by, sponsored by or supported by Grokability, Inc. or the Snipe-IT project. "Snipe-IT" is a trademark of its owner. The vendored API description and its license situation are described in NOTICE.

Three tool layers (183 tools):

  • 37 hand-wrappers (snipeit_*): friendlier UX for common workflows

  • 145 generated tools (snipeit_gen_*): one per operation of the vendored spec (vendor/snipe-it-rest-api.json, Snipe-IT 8.2.0)

  • snipeit_raw_request: escape hatch for any method and path under SNIPEIT_API_BASE

Plus 3 resources and 3 prompts. The counts are held by tests/unit/docsFacts.test.ts.


Maintenance status

  • Maintained on a best-effort basis by one maintainer (@mguttmann) in spare time. The author runs it in production behind a private MCP gateway. There is no support contract and no guaranteed response time.

  • Security fixes take priority over features. Report vulnerabilities privately through GitHub Private Vulnerability Reporting, never in a public issue (see SECURITY.md).

  • Dependency updates come from Dependabot; CI fails when a runtime dependency has a known high or critical advisory.

  • Supported Node.js versions: 22.12 or newer (engines in package.json); CI tests Node 22, 24 and 26.

  • Only the latest minor release gets fixes. Releases and their changes: CHANGELOG.md.

  • Issues and pull requests are welcome; see CONTRIBUTING.md.

Related MCP server: swsd-mcp

Install

Requires Node.js 22.12 or newer. The server needs SNIPEIT_API_BASE (your instance, including /api/v1) and SNIPEIT_API_TOKEN; all other variables are optional (see Configuration). Only the npm package the-real-snipeit-mcp and the MCP Registry name io.github.mguttmann/the-real-snipeit-mcp are this project.

npx (any stdio MCP host)

npx fetches and runs the package; no clone or build is needed. Attach it to Claude Code (type the token in your shell, never into a chat):

claude mcp add snipeit \
  -e SNIPEIT_API_BASE=https://snipe-it.example.com/api/v1 \
  -e SNIPEIT_API_TOKEN=<token> \
  -- npx -y the-real-snipeit-mcp

Any other stdio host takes the same command in its JSON configuration (Claude Desktop: claude_desktop_config.json):

{
  "mcpServers": {
    "snipeit": {
      "command": "npx",
      "args": ["-y", "the-real-snipeit-mcp"],
      "env": {
        "SNIPEIT_API_BASE": "https://snipe-it.example.com/api/v1",
        "SNIPEIT_API_TOKEN": "<token>"
      }
    }
  }
}

A configuration file with these values holds the token: keep it readable for your user only and out of version control. the-real-snipeit-mcp@<version> pins a version.

Global install

npm install -g the-real-snipeit-mcp

The command is the-real-snipeit-mcp; use it as "command" in the host configuration above (without args).

From source

git clone https://github.com/mguttmann/the-real-snipeit-mcp.git
cd the-real-snipeit-mcp
npm ci
cp .env.example .env
# edit .env: set SNIPEIT_API_BASE and SNIPEIT_API_TOKEN
npm run build        # prebuild runs lint, typecheck and the unit tests first
node --env-file=.env dist/index.js

npm run inspector opens the MCP Inspector against the built server.

Pinned install for gateways and servers

For an unattended host, install an exact version from a committed lockfile, without install scripts and without dev dependencies, and check the registry signatures and provenance attestations:

mkdir snipeit-mcp && cd snipeit-mcp
npm init -y
npm install --save-exact --ignore-scripts the-real-snipeit-mcp@<version>   # once; commit package.json and package-lock.json
# on every deploy:
npm ci --omit=dev --ignore-scripts
npm audit signatures
node --env-file=/path/to/.env node_modules/the-real-snipeit-mcp/dist/index.js

Each release on GitHub Releases carries the npm tarball, a CycloneDX SBOM and SHA256SUMS; releases published by the release workflow carry an npm provenance statement and a GitHub build provenance attestation.

MCP Registry and Glama

Each stable release is listed in the official MCP Registry as io.github.mguttmann/the-real-snipeit-mcp (the npm package, with its environment variables). glama.json names the maintainer of the Glama listing.

Configuration

Variable

Default

Description

SNIPEIT_API_TOKEN

(required)

Snipe-IT Personal API Token (JWT)

SNIPEIT_API_BASE

https://snipe-it.example.com/api/v1

API base URL. The default is an RFC 2606 placeholder; set your instance. The server starts with any valid URL but logs a warning when the placeholder is in use, when http goes to a non-loopback host (cleartext token), for other schemes, for credentials in the URL and for a query or fragment

SNIPEIT_CONFIRM_WRITES

true

If on (default), destructive tools require confirm: "YES". Only false, 0, no or off (any case) disable the guard; empty or unrecognised values keep it on and log a warning. The effective state is logged to stderr at startup

SNIPEIT_TIMEOUT_MS

30000

Timeout in ms per attempt (positive integer), covering the response headers and the full body read

SNIPEIT_LOG_LEVEL

info

debug | info | warn | error

SNIPEIT_MAX_RESULT_BYTES

1048576 (1 MiB)

Cap for one tool result (serialized JSON, bytes); minimum 65536. Values above 8 MiB log a warning: TypeScript SDK clients read at most 10 MiB per message. Larger results are shortened to valid JSON with a truncation marker (see Large and binary results). One HTTP response body is never buffered beyond the larger of 16 MiB and 4 times this value.

SNIPEIT_CALL_DEADLINE_MS

0 (none)

Overall deadline for one tool call in ms, across retries, backoffs and all: true pagination; 0 disables it. A call past the deadline ends with a DEADLINE_EXCEEDED tool error; all: true returns the rows collected so far with truncated: true and next_offset

SNIPEIT_REDACT_PII

false

Mask personal data in tool results and resource reads with (redacted) (not in error texts or write previews): email, employee_num(ber), phone, mobile, address, address2, username, first_name, last_name at any depth, and name of objects that describe a person. Asset, model and location names stay. Accepts true/false (also 1/0, yes/no, on/off); an unrecognised value turns it on and logs a warning

SNIPEIT_REDACT_SECRETS

false

Mask secrets in tool results and resources with (redacted): the value of every key matching password|secret|token|api[_-]?key at any depth, and the value of every custom_fields entry (object or array form) whose display name or database column (_snipeit_*, also as a flat key in write responses) matches passw|kennw|secret|token|key|recovery|bitlocker|pin|laps (any case; broad on purpose, so "Keyboard layout" is masked too); also old and new of every log_meta entry (action log, /reports/activity) and the default_value of every custom field definition whose name or column matches either rule. Null and empty values stay. Error texts that echo such a JSON field are masked as well. Same accepted values as SNIPEIT_REDACT_PII; an unrecognised value turns it on and logs a warning. Write tools always refuse a body that contains the placeholder (see Write safety)

SNIPEIT_READ_ONLY

false

Refuse every write at runtime with a READ_ONLY tool error; all tools stay registered and reads work. Same accepted values as SNIPEIT_REDACT_PII; an unrecognised value turns it on

SNIPEIT_REQUIRE_PREVIEW

false

While the write guard is on, confirm: "YES" executes only after a preview of the identical request in the last 10 minutes, once per preview. Off: confirm: "YES" executes in the first call. Same accepted values as SNIPEIT_REDACT_PII

Variables come from the environment, from node --env-file=<file>, or from a .env in the working directory (or DOTENV_CONFIG_PATH), which never overrides a variable that is already set. The names (never the values) of the variables a .env added are logged to stderr at startup.


Tool reference

Hand-wrappers (37 tools)

Identity (1)

Tool

Endpoint

Annotations

snipeit_me

GET /users/me

readOnly

Hardware / Assets (13)

Tool

Endpoint

Annotations

snipeit_list_hardware

GET /hardware (paginated, common filters)

readOnly

snipeit_search_hardware

GET /hardware?search={query} (convenience)

readOnly

snipeit_get_hardware_by_id

GET /hardware/{id}

readOnly

snipeit_get_hardware_by_tag

GET /hardware/bytag/{tag}

readOnly

snipeit_get_hardware_by_serial

GET /hardware/byserial/{serial}

readOnly

snipeit_create_hardware

POST /hardware

writeOnce

snipeit_update_hardware

PATCH /hardware/{id}

writeIdempotent

snipeit_delete_hardware

DELETE /hardware/{id} (soft delete; snipeit_gen_hardwareidrestore restores)

writeIdempotent

snipeit_checkout_hardware

POST /hardware/{id}/checkout (user/location/asset)

writeOnce

snipeit_checkin_hardware

POST /hardware/{id}/checkin

writeOnce

snipeit_audit_hardware

POST /hardware/audit

writeOnce

snipeit_list_audit_due

GET /hardware/audit/due

readOnly

snipeit_list_audit_overdue

GET /hardware/audit/overdue

readOnly

Users (5)

Tool

Endpoint

Annotations

snipeit_list_users

GET /users

readOnly

snipeit_get_user

GET /users/{id}

readOnly

snipeit_get_user_assets

GET /users/{id}/assets

readOnly

snipeit_get_user_accessories

GET /users/{id}/accessories

readOnly

snipeit_get_user_licenses

GET /users/{id}/licenses

readOnly

Licenses (3)

Tool

Endpoint

Annotations

snipeit_list_licenses

GET /licenses

readOnly

snipeit_get_license_seats

GET /licenses/{id}/seats

readOnly

snipeit_checkout_license_seat

PUT /licenses/{license_id}/seats/{seat_id}

writeIdempotent

Accessories / Consumables / Components (8)

Tool

Endpoint

Annotations

snipeit_list_accessories

GET /accessories

readOnly

snipeit_checkout_accessory

POST /accessories/{id}/checkout

writeOnce

snipeit_checkin_accessory

POST /accessories/{id}/checkin (pivot-id)

writeOnce

snipeit_list_consumables

GET /consumables

readOnly

snipeit_checkout_consumable

POST /consumables/{id}/checkout

writeOnce

snipeit_list_components

GET /components

readOnly

snipeit_checkout_component

POST /components/{id}/checkout (to asset)

writeOnce

snipeit_checkin_component

POST /components/{id}/checkin (pivot-id)

writeOnce

Locations / Status-Labels / Maintenances (6)

Tool

Endpoint

Annotations

snipeit_list_locations

GET /locations

readOnly

snipeit_get_location

GET /locations/{id}

readOnly

snipeit_list_statuslabels

GET /statuslabels

readOnly

snipeit_get_statuslabel_assets

GET /statuslabels/{id}/assetlist

readOnly

snipeit_list_maintenances

GET /maintenances

readOnly

snipeit_create_maintenance

POST /maintenances

writeOnce

Bulk (1)

Tool

Behavior

Annotations

snipeit_bulk_checkout

Serially checks out up to 100 assets, returns a per-item success/error summary; on cancel it stops before the next item and reports aborted and not_attempted; logs each executed item (asset_id, outcome, HTTP status) to stderr

writeOnce

List tools (snipeit_list_*) accept limit?, offset?, and all?: boolean. With all: true, the tool auto-paginates up to 10 000 rows or until the result would exceed SNIPEIT_MAX_RESULT_BYTES; in that case it returns the rows collected so far with truncated: true, next_offset and total, and you continue with limit/offset.

Auto-generated tools (snipeit_gen_*)

Every operation (path and method) in the vendored Snipe-IT OpenAPI 3.1 spec is exposed as snipeit_gen_<snake_operation_id>. Each title is METHOD /path, and each description starts with METHOD /path: followed by the spec's description of the operation. The two file-upload operations (POST /hardware/{id}/files, POST /models/{id}/files) cannot upload: the vendored spec declares a JSON body, Snipe-IT expects multipart/form-data; their descriptions say so. Use these when the hand-wrapper layer doesn't cover what you need. GET tools have readOnlyHint: true; all other methods have destructiveHint: true and go through the write guard. Regenerate with npm run codegen after npm run refresh-spec.

snipeit_raw_request

Escape hatch for anything else:

{ method: "PATCH", path: "/locations/4", body: { name: "HQ" } }

Its annotations are static (destructiveHint: true, idempotentHint: false) for every method. GET requests bypass the write guard; other methods honor SNIPEIT_CONFIRM_WRITES. The path must start with a single /; absolute URLs and paths that leave SNIPEIT_API_BASE are rejected.


Resources

URI

Description

snipeit://me

Current authenticated user (GET /users/me)

snipeit://settings

Server settings (GET /settings). This endpoint is not in the vendored 8.2.0 spec; when the instance does not serve it, the resource returns {error, note} instead of failing the read

snipeit://hardware/summary

{total, by_status_label, by_category}: aggregated counts, at most 6 count requests at a time. A count that failed (for example under API throttling) is -1, and the result then carries partial: true and errors[]

Prompts

Prompt

Args

Purpose

snipeit-inventory-audit

none

Lists overdue/due audits + unassigned assets, then summarizes

snipeit-user-onboarding

user_id, optional kit

Suggests a checkout sequence for a new user

snipeit-license-health

none

Seat usage + licenses expiring within 90 days


Workflows / Recipes

Onboard a new user with a laptop

  1. Confirm the user: snipeit_get_user(id: 42)

  2. Find an available laptop: snipeit_list_hardware(category_id: 3, status_id: 5) (ready-to-deploy)

  3. Checkout: snipeit_checkout_hardware(id: 100, checkout_to_type: "user", assigned_user: 42, note: "Onboarding 2026-05-25")

Bulk-checkout a kit to one user

{
  "items": [
    { "asset_id": 100, "checkout_to_type": "user", "assigned_user": 42 },
    { "asset_id": 101, "checkout_to_type": "user", "assigned_user": 42 },
    { "asset_id": 102, "checkout_to_type": "user", "assigned_user": 42 }
  ]
}

Continues on per-item errors. Returns {summary: {total, ok, errors}, results: [...]}.

Audit overdue cleanup

  1. snipeit_list_audit_overdue(all: true): full list, auto-paginated

  2. For each: snipeit_audit_hardware(asset_tag: "...", location_id: 1, next_audit_date: "2027-05-25")

Find an asset by tag or serial

  • By asset tag: snipeit_get_hardware_by_tag(tag: "A-42") (handles URL encoding)

  • By serial: snipeit_get_hardware_by_serial(serial: "SN12345")

Discover what an LLM can do

Browse the MCP Inspector:

npm run build && npm run inspector

Write safety

The write guard is on by default: every tool with destructiveHint: true returns a redacted preview instead of executing; re-invoke it with confirm: "YES" to execute. The preview names the tool, the method, the URL, the query parameters and a redacted body (password/secret/token/api_key fields replaced with (redacted)); snipeit_bulk_checkout lists each concrete request. A preview is a normal result, not an error: its text has status: "preview" and its _meta carries "snipeit/preview": true, so a client can tell it from an executed write without parsing. Every write tool shows the full URL (SNIPEIT_API_BASE + path).

Only SNIPEIT_CONFIRM_WRITES set to false, 0, no or off (trimmed, any case) disables the guard so write tools execute directly. Unset, true/1/yes/on, an empty value or anything else keeps it on; an empty or unrecognised value also logs a warning. The effective state is logged to stderr once at startup.

confirm is set by the model, so the guard catches a model that forgets it, not a prompt injection in Snipe-IT data that adds it; human approval has to come from the MCP host or gateway. Two optional switches tighten it on the server side:

  • SNIPEIT_READ_ONLY=true refuses every write with a READ_ONLY tool error; all tools stay registered (the tool list does not change) and reads work, including snipeit_raw_request with GET.

  • SNIPEIT_REQUIRE_PREVIEW=true (with the guard on) executes confirm: "YES" only after a preview of the identical request in the last 10 minutes, once per preview, so every write is previewed first.

Independent of these settings, every write tool (hand-written, generated, snipeit_bulk_checkout and snipeit_raw_request with a method other than GET) refuses a body or query in which any value, at any depth of objects and arrays, is exactly (redacted), the placeholder of previews, SNIPEIT_REDACT_SECRETS and SNIPEIT_REDACT_PII. It returns a tool error with details.code: "REDACTED_PLACEHOLDER" and details.paths (for example body.custom_fields["BitLocker Key"].value, body[2].password, items[2].note, query.token), before the preview, SNIPEIT_READ_ONLY and the request, so an asset read with redaction on and written back unchanged cannot overwrite a recovery key with the placeholder. A string that only contains (redacted) is sent as before. Set the real value or omit the field.

Every preview, refusal and confirmed execution logs one info line (tool, method, URL), and every executed write request logs one info line with its HTTP status (no query, no body).

Snipe-IT API quirk

Snipe-IT often returns HTTP 200 with {"status":"error","messages":…} for validation errors. This server detects that envelope and surfaces the messages as a tool error (with isError: true), so callers never accidentally treat a Snipe-IT error as success. Successful envelopes ({"status":"success","payload":…}) are unwrapped automatically so tool data is the inner payload, not the outer wrapper.

Large and binary results

  • Size cap. Every tool result is limited to SNIPEIT_MAX_RESULT_BYTES (default 1 MiB). Lists ({total, rows}) keep the leading rows that fit and gain truncated: true and next_offset; the pagination hint is adjusted to match. Top-level arrays keep the leading items with a truncated object next to data. Any other oversized result is replaced by {truncated: true, size_bytes, max_result_bytes, note}. The output is always valid JSON, never a cut string.

  • Body read bound. A single HTTP response body is read up to the larger of 16 MiB and 4 times SNIPEIT_MAX_RESULT_BYTES; a larger JSON or text body fails with a RESPONSE_TOO_LARGE tool error instead of being buffered.

  • Binary downloads. Responses whose content type is not JSON, XML or text/* (for example backup zips, uploaded files, images, PDFs) are not decoded. The tool returns {binary: true, content_type, size_bytes, size_exact, filename, note}; download the file from Snipe-IT directly if you need its content.

  • Timeouts, retries, redirects. SNIPEIT_TIMEOUT_MS covers each attempt including the body read. 429 is always retried; 5xx and network errors are retried only for idempotent methods (GET, PUT, DELETE); POST and PATCH are retried only when the connection was never established (ECONNREFUSED, ENOTFOUND, EAI_AGAIN), so a write is never sent twice. Redirects are never followed. A cancelled tool call (MCP cancellation or a closed client) aborts its HTTP request and any retry backoff at once; SNIPEIT_CALL_DEADLINE_MS optionally bounds a whole call.


Develop

npm run dev               # tsx watch
npm test                  # unit; live tests only with SNIPEIT_LIVE_TESTS=1
npm run test:contract     # gateway tool contract + protocol revisions
npm run test:unit         # unit only (CI-safe)
SNIPEIT_LIVE_TESTS=1 npm run test:integration  # live; also needs SNIPEIT_API_TOKEN
npm run lint
npm run typecheck
npm run codegen           # regenerate src/tools/generated from vendor/snipe-it-rest-api.json
npm run refresh-spec      # pull latest OpenAPI spec from snipe-it.readme.io
npm run inspector         # MCP Inspector

See ARCHITECTURE.md for the layer diagram and data flow. See CONTRIBUTING.md for adding hand-wrappers, regenerating the codegen layer, and debugging.

Security

  • API token is read from SNIPEIT_API_TOKEN env only. Never hard-coded. .env is git-ignored.

  • Versions 0.1.7 and older can send the token to another host through snipeit_raw_request with an absolute URL; upgrade to 0.2.0 or newer (see CHANGELOG.md).

  • The logger and every error text returned to the model redact known secret patterns (Bearer tokens, JWTs, Authorization headers of any scheme, api_token/password/secret/token/api_key fields and query parameters, URL userinfo).

  • Tool results carry Snipe-IT data, including personal data of users (names, e-mail addresses, employee numbers), to the MCP client and its model provider. SNIPEIT_REDACT_PII=true masks those fields; see SECURITY.md.

  • Tool results can also carry secrets that Snipe-IT stores in custom fields (recovery keys, local admin passwords). SNIPEIT_REDACT_SECRETS=true masks secret-named fields and secret custom field values in tool results and resources; see SECURITY.md.

  • Every request is pinned to the SNIPEIT_API_BASE origin and path; redirects are never followed (any 3xx becomes a tool error naming the status and Location), so a misconfigured base URL (for example http:// behind an HTTPS redirect) fails loudly instead of turning a write into a silent GET.

  • All log output goes to stderr only; stdout is reserved for the MCP protocol.

  • If your token has ever been pasted into a chat or commit, rotate it.

License

MIT (see LICENSE). The vendored Snipe-IT API description is not covered by it; see NOTICE.

Available Tools

183 tools
snipeit_audit_hardwareAudit hardwareC
Destructive

POST /hardware/audit: marks an asset as audited at a location.

Inputs: asset_tag (required), note, confirm, location_id, +1 more.

snipeit_bulk_checkoutBulk checkout assetsA
Destructive

Serially checks out multiple assets. Continues on per-item errors. Returns a result array with success/error for each item. Stops before the next item when the request is cancelled; the summary then reports aborted and not_attempted.

Inputs: items (required), confirm.

snipeit_checkin_accessoryCheckin accessory from a userB
Destructive

POST /accessories/{id}/checkin: check an accessory back in. Per Snipe-IT spec, the id here is the ID of the record in the accessories_users join table (the pivot/relationship ID), not the accessory ID.

Inputs: id (required), note, confirm.

snipeit_checkin_componentCheckin component from an assetA
Destructive

POST /components/{id}/checkin: check a quantity of a component back in. Per spec, the id here is the record ID in the components_assets join table (the pivot/relationship ID), and checkin_qty is required.

Inputs: id (required), checkin_qty (required), confirm.

snipeit_checkin_hardwareCheckin hardwareD
Destructive

POST /hardware/{id}/checkin

Inputs: id (required), name, note, confirm, +2 more.

snipeit_checkout_accessoryCheckout accessory to a userA
Destructive

POST /accessories/{id}/checkout: check an accessory out to a user. Note: per Snipe-IT spec, the target user field is assigned_user (not assigned_to).

Inputs: id (required), assigned_user (required), note, confirm, +1 more.

snipeit_checkout_componentCheckout component to an assetC
Destructive

POST /components/{id}/checkout: check a quantity of a component out to an asset. Per spec, assigned_to is the asset ID and assigned_qty is required.

Inputs: id (required), assigned_to (required), assigned_qty (required), confirm.

snipeit_checkout_consumableCheckout consumable to a userC
Destructive

POST /consumables/{id}/checkout: check a consumable out to a user.

Inputs: id (required), assigned_to (required), note, confirm, +1 more.

snipeit_checkout_hardwareCheckout hardware to user / location / assetC
Destructive

POST /hardware/{id}/checkout. Provide checkout_to_type plus the matching target id.

Inputs: id (required), checkout_to_type (required), name, note, +7 more.

snipeit_checkout_license_seatCheckout (assign) a license seatC
DestructiveIdempotent

PUT /licenses/{license_id}/seats/{seat_id}: assign a seat to a user or asset.

Inputs: seat_id (required), license_id (required), note, confirm, +2 more.

snipeit_create_hardwareCreate hardwareC
Destructive

POST /hardware: required: asset_tag, status_id, model_id (per Snipe-IT spec).

Inputs: body (required), confirm.

snipeit_create_maintenanceCreate asset maintenanceA
Destructive

POST /maintenances: schedule or record a maintenance event. Required: asset_id, asset_maintenance_type, title, start_date (YYYY-MM-DD). title is sent as both 'name' (Snipe-IT 8.x) and 'title' (older servers). Note: supplier_id is required by the Snipe-IT 8.2.0 API; pass it unless your server accepts it missing.

Inputs: title (required), asset_id (required), start_date (required), asset_maintenance_type (required), +5 more.

snipeit_delete_hardwareDelete hardwareA
DestructiveIdempotent

DELETE /hardware/{id}: soft-deletes the asset; restore it with snipeit_gen_hardwareidrestore (POST /hardware/{id}/restore).

Inputs: id (required), confirm.

snipeit_gen_accessoriesGET /accessoriesC
Read-onlyIdempotent

GET /accessories: Return a listing of accessories. Generated from Snipe-IT OpenAPI operation accessories.

Inputs: sort, limit, order, expand, +3 more.

snipeit_gen_accessories_1POST /accessoriesC
Destructive

POST /accessories: Create a new accessory. Generated from Snipe-IT OpenAPI operation accessories-1.

Inputs: body, confirm.

snipeit_gen_accessories_checkinPOST /accessories/{id}/checkinC
Destructive

POST /accessories/{id}/checkin: Checkin an accessory from a user. Generated from Snipe-IT OpenAPI operation accessories-checkin.

Inputs: id (required), confirm.

snipeit_gen_accessories_checkoutPOST /accessories/{id}/checkoutC
Destructive

POST /accessories/{id}/checkout: Check an accessory out to a user. Generated from Snipe-IT OpenAPI operation accessories-checkout.

Inputs: id (required), body, limit, offset, +1 more.

snipeit_gen_accessoriesidGET /accessories/{id}C
Read-onlyIdempotent

GET /accessories/{id}: Get the details on an accessory. Generated from Snipe-IT OpenAPI operation accessoriesid.

Inputs: id (required).

snipeit_gen_accessoriesid_1PUT /accessories/{id}C
DestructiveIdempotent

PUT /accessories/{id}: Updates an accessory. Generated from Snipe-IT OpenAPI operation accessoriesid-1.

Inputs: id (required), body, confirm.

snipeit_gen_accessoriesid_2PATCH /accessories/{id}C
DestructiveIdempotent

PATCH /accessories/{id}: Selectively updates an accessory. Generated from Snipe-IT OpenAPI operation accessoriesid-2.

Inputs: id (required), body, confirm.

snipeit_gen_accessoriesid_3DELETE /accessories/{id}C
DestructiveIdempotent

DELETE /accessories/{id}: Deletes an accessory. Generated from Snipe-IT OpenAPI operation accessoriesid-3.

Inputs: id (required), confirm.

snipeit_gen_accessoriesidcheckedoutGET /accessories/{id}/checkedoutC
Read-onlyIdempotent

GET /accessories/{id}/checkedout: Show which users a specific accessory has been checked out to. Generated from Snipe-IT OpenAPI operation accessoriesidcheckedout.

Inputs: id (required), limit, offset.

snipeit_gen_backups_1GET /settings/backupsC
Read-onlyIdempotent

GET /settings/backups. Generated from Snipe-IT OpenAPI operation backups-1.

Inputs: sort, limit, order, offset, +1 more.

snipeit_gen_backupsdownloadfileGET /settings/backups/download/{file}C
Read-onlyIdempotent

GET /settings/backups/download/{file}: /settings/backups/download/:file. Generated from Snipe-IT OpenAPI operation backupsdownloadfile.

Inputs: file (required).

snipeit_gen_categories_1GET /categoriesC
Read-onlyIdempotent

GET /categories: List categories. Generated from Snipe-IT OpenAPI operation categories-1.

Inputs: name, sort, limit, order, +7 more.

snipeit_gen_categories_2POST /categoriesC
Destructive

POST /categories: Create a Category. Generated from Snipe-IT OpenAPI operation categories-2.

Inputs: body, confirm.

snipeit_gen_categoriesidPUT /categories/{id}C
DestructiveIdempotent

PUT /categories/{id}: Update a Category. Generated from Snipe-IT OpenAPI operation categoriesid.

Inputs: id (required), body, confirm.

snipeit_gen_categoriesid_1PATCH /categories/{id}C
DestructiveIdempotent

PATCH /categories/{id}: Update a Category. Generated from Snipe-IT OpenAPI operation categoriesid-1.

Inputs: id (required), body, confirm.

snipeit_gen_categoriesid_2DELETE /categories/{id}C
DestructiveIdempotent

DELETE /categories/{id}: Delete a Category. Generated from Snipe-IT OpenAPI operation categoriesid-2.

Inputs: id (required), confirm.

snipeit_gen_categoriesid_3GET /categories/{id}C
Read-onlyIdempotent

GET /categories/{id}: Return a Category by id. Generated from Snipe-IT OpenAPI operation categoriesid-3.

Inputs: id (required).

snipeit_gen_companiesGET /companiesC
Read-onlyIdempotent

GET /companies: Return a listing of companies. Generated from Snipe-IT OpenAPI operation companies.

Inputs: name, sort, limit, order, +2 more.

snipeit_gen_companies_1POST /companiesC
Destructive

POST /companies: Create a new company. Generated from Snipe-IT OpenAPI operation companies-1.

Inputs: body, confirm.

snipeit_gen_companiesidGET /companies/{id}B
Read-onlyIdempotent

GET /companies/{id}: Retrieve the specific details of a company by id. Generated from Snipe-IT OpenAPI operation companiesid.

Inputs: id (required).

snipeit_gen_companiesid_1PUT /companies/{id}C
DestructiveIdempotent

PUT /companies/{id}: Updates a company's details. Generated from Snipe-IT OpenAPI operation companiesid-1.

Inputs: id (required), body, confirm.

snipeit_gen_companiesid_2PATCH /companies/{id}C
DestructiveIdempotent

PATCH /companies/{id}: Updates a part of a company's details. Generated from Snipe-IT OpenAPI operation companiesid-2.

Inputs: id (required), body, confirm.

snipeit_gen_companiesid_3DELETE /companies/{id}C
DestructiveIdempotent

DELETE /companies/{id}: Delete's a company. Generated from Snipe-IT OpenAPI operation companiesid-3.

Inputs: id (required), confirm.

snipeit_gen_componentsGET /componentsC
Read-onlyIdempotent

GET /components: Return a listing of components. Generated from Snipe-IT OpenAPI operation components.

Inputs: name, sort, limit, order, +4 more.

snipeit_gen_components_1POST /componentsC
Destructive

POST /components: Creates a component. Generated from Snipe-IT OpenAPI operation components-1.

Inputs: body, confirm.

snipeit_gen_componentsidGET /components/{id}C
Read-onlyIdempotent

GET /components/{id}: Get the details on a component. Generated from Snipe-IT OpenAPI operation componentsid.

Inputs: id (required).

snipeit_gen_componentsid_1PUT /components/{id}C
DestructiveIdempotent

PUT /components/{id}: Updates a component. Generated from Snipe-IT OpenAPI operation componentsid-1.

Inputs: id (required), body, confirm.

snipeit_gen_componentsid_2PATCH /components/{id}C
DestructiveIdempotent

PATCH /components/{id}: Updates a some details of a component. Generated from Snipe-IT OpenAPI operation componentsid-2.

Inputs: id (required), body, confirm.

snipeit_gen_componentsid_3DELETE /components/{id}C
DestructiveIdempotent

DELETE /components/{id}: Deletes a component. Generated from Snipe-IT OpenAPI operation componentsid-3.

Inputs: id (required), confirm.

snipeit_gen_componentsidassetsGET /components/{id}/assetsB
Read-onlyIdempotent

GET /components/{id}/assets: Returns a list of which assets a component has been checked out to. Generated from Snipe-IT OpenAPI operation componentsidassets.

Inputs: id (required).

snipeit_gen_componentsidcheckinPOST /components/{id}/checkinC
Destructive

POST /components/{id}/checkin: Check a component back in from an asset. Generated from Snipe-IT OpenAPI operation componentsidcheckin.

Inputs: id (required), body, confirm.

snipeit_gen_componentsidcheckoutPOST /components/{id}/checkoutC
Destructive

POST /components/{id}/checkout: Check an accessory out to an asset. Generated from Snipe-IT OpenAPI operation componentsidcheckout.

Inputs: id (required), body, confirm.

snipeit_gen_consumablesGET /consumablesC
Read-onlyIdempotent

GET /consumables: Return a listing of consumables. Generated from Snipe-IT OpenAPI operation consumables.

Inputs: name, sort, limit, order, +7 more.

snipeit_gen_consumables_1POST /consumablesC
Destructive

POST /consumables: Create a new consumable. Generated from Snipe-IT OpenAPI operation consumables-1.

Inputs: body, confirm.

snipeit_gen_consumables_2PUT /consumables/{id}C
DestructiveIdempotent

PUT /consumables/{id}: Updates a consumable. Generated from Snipe-IT OpenAPI operation consumables-2.

Inputs: id (required), body, confirm.

snipeit_gen_consumablesidGET /consumables/{id}B
Read-onlyIdempotent

GET /consumables/{id}: Get the details on a consumable. Generated from Snipe-IT OpenAPI operation consumablesid.

Inputs: id (required).

snipeit_gen_consumablesid_1PATCH /consumables/{id}C
DestructiveIdempotent

PATCH /consumables/{id}: Updates a portion of a consumable record. Generated from Snipe-IT OpenAPI operation consumablesid-1.

Inputs: id (required), body, confirm.

snipeit_gen_consumablesid_2DELETE /consumables/{id}C
DestructiveIdempotent

DELETE /consumables/{id}: Deletes a consumable. Generated from Snipe-IT OpenAPI operation consumablesid-2.

Inputs: id (required), confirm.

snipeit_gen_consumablesidcheckoutPOST /consumables/{id}/checkoutC
Destructive

POST /consumables/{id}/checkout: Check an consumable out to a user. Generated from Snipe-IT OpenAPI operation consumablesidcheckout.

Inputs: id (required), body, confirm.

snipeit_gen_departmentsGET /departmentsC
Read-onlyIdempotent

GET /departments: List departments. Generated from Snipe-IT OpenAPI operation departments.

Inputs: name, sort, limit, order, +5 more.

snipeit_gen_departments_1POST /departmentsC
Destructive

POST /departments: Create a department. Generated from Snipe-IT OpenAPI operation departments-1.

Inputs: body, confirm.

snipeit_gen_departments_editPUT /departments/{id}C
DestructiveIdempotent

PUT /departments/{id}: Edit a department. Generated from Snipe-IT OpenAPI operation departments-edit.

Inputs: id (required), body, confirm.

snipeit_gen_departmentsidGET /departments/{id}C
Read-onlyIdempotent

GET /departments/{id}: View a department. Generated from Snipe-IT OpenAPI operation departmentsid.

Inputs: id (required).

snipeit_gen_departmentsid_1PATCH /departments/{id}C
DestructiveIdempotent

PATCH /departments/{id}: Edit a department. Generated from Snipe-IT OpenAPI operation departmentsid-1.

Inputs: id (required), body, confirm.

snipeit_gen_departmentsid_2DELETE /departments/{id}C
DestructiveIdempotent

DELETE /departments/{id}: Delete a department. Generated from Snipe-IT OpenAPI operation departmentsid-2.

Inputs: id (required), confirm.

snipeit_gen_fieldsGET /fieldsetsC
Read-onlyIdempotent

GET /fieldsets: List all custom fieldsets. Generated from Snipe-IT OpenAPI operation fields.

Inputs: sort, limit, order, offset, +1 more.

snipeit_gen_fields_1GET /fieldsC
Read-onlyIdempotent

GET /fields: Returns a listing of available custom fields. Generated from Snipe-IT OpenAPI operation fields-1.

Inputs: sort, limit, order, offset, +1 more.

snipeit_gen_fields_2POST /fieldsC
Destructive

POST /fields: Create a custom field. Generated from Snipe-IT OpenAPI operation fields-2.

Inputs: body, confirm.

snipeit_gen_fieldsetsPOST /fieldsetsC
Destructive

POST /fieldsets: Create a Fieldset. Generated from Snipe-IT OpenAPI operation fieldsets.

Inputs: body, confirm.

snipeit_gen_fieldsetsidGET /fieldsets/{id}C
Read-onlyIdempotent

GET /fieldsets/{id}: Return fieldset info by id. Generated from Snipe-IT OpenAPI operation fieldsetsid.

Inputs: id (required).

snipeit_gen_fieldsetsid_1PUT /fieldsets/{id}C
DestructiveIdempotent

PUT /fieldsets/{id}: Update a Fieldset. Generated from Snipe-IT OpenAPI operation fieldsetsid-1.

Inputs: id (required), body, confirm.

snipeit_gen_fieldsetsid_2DELETE /fieldsets/{id}C
DestructiveIdempotent

DELETE /fieldsets/{id}: Delete a Fieldset. Generated from Snipe-IT OpenAPI operation fieldsetsid-2.

Inputs: id (required), confirm.

snipeit_gen_fieldsetsidfieldsGET /fieldsets/{id}/fieldsB
Read-onlyIdempotent

GET /fieldsets/{id}/fields: Return list of associated fields within a fieldset. Generated from Snipe-IT OpenAPI operation fieldsetsidfields.

Inputs: id (required).

snipeit_gen_fieldsidGET /fields/{id}A
Read-onlyIdempotent

GET /fields/{id}: Return field info by id. Generated from Snipe-IT OpenAPI operation fieldsid.

Inputs: id (required).

snipeit_gen_fieldsid_1DELETE /fields/{id}C
DestructiveIdempotent

DELETE /fields/{id}: Delete a custom field. Generated from Snipe-IT OpenAPI operation fieldsid-1.

Inputs: id (required), confirm.

snipeit_gen_fieldsid_2PATCH /fields/{id}C
DestructiveIdempotent

PATCH /fields/{id}: Update a custom field. Generated from Snipe-IT OpenAPI operation fieldsid-2.

Inputs: id (required), body, confirm.

snipeit_gen_fieldsidassociatePOST /fields/{id}/associateC
Destructive

POST /fields/{id}/associate: Associate a custom field with a custom fieldset. Generated from Snipe-IT OpenAPI operation fieldsidassociate.

Inputs: id (required), body, confirm.

snipeit_gen_fieldsiddisassociatePOST /fields/{id}/disassociateC
Destructive

POST /fields/{id}/disassociate: Removed the association of a custom field with a fieldset. Generated from Snipe-IT OpenAPI operation fieldsiddisassociate.

Inputs: id (required), body, confirm.

snipeit_gen_get_new_endpointGET /consumables/{id}/usersD
Read-onlyIdempotent

GET /consumables/{id}/users. Generated from Snipe-IT OpenAPI operation get_new-endpoint.

Inputs: id (required).

snipeit_gen_get_new_endpoint_consumables_id_userGET /consumables/{id}/userD
Read-onlyIdempotent

GET /consumables/{id}/user. Generated from Snipe-IT OpenAPI operation get_new-endpoint.

Inputs: id (required).

snipeit_gen_groups_1GET /groupsC
Read-onlyIdempotent

GET /groups. Generated from Snipe-IT OpenAPI operation groups-1.

Inputs: name, sort, limit, order, +2 more.

snipeit_gen_groupsidGET /groups/{id}C
Read-onlyIdempotent

GET /groups/{id}: Return a group. Generated from Snipe-IT OpenAPI operation groupsid.

Inputs: id (required).

snipeit_gen_groupsid_1POST /groupsC
Destructive

POST /groups: Create a group. Generated from Snipe-IT OpenAPI operation groupsid-1.

Inputs: body, confirm.

snipeit_gen_groupsid_2PUT /groups/{id}C
DestructiveIdempotent

PUT /groups/{id}: Edit a group. Generated from Snipe-IT OpenAPI operation groupsid-2.

Inputs: id (required), body, confirm.

snipeit_gen_groupsid_3DELETE /groups/{id}C
DestructiveIdempotent

DELETE /groups/{id}: Delete a group. Generated from Snipe-IT OpenAPI operation groupsid-3.

Inputs: id (required), confirm.

snipeit_gen_groupsid_4PATCH /groups/{id}C
DestructiveIdempotent

PATCH /groups/{id}: Partially edit a group. Generated from Snipe-IT OpenAPI operation groupsid-4.

Inputs: id (required), body, confirm.

snipeit_gen_hardwareauditPOST /hardware/auditC
Destructive

POST /hardware/audit: Mark an asset as audited. Generated from Snipe-IT OpenAPI operation hardwareaudit.

Inputs: body, confirm.

snipeit_gen_hardwareauditdueGET /hardware/audit/dueB
Read-onlyIdempotent

GET /hardware/audit/due: Retrieve a list of assets that are due for auditing soon. Generated from Snipe-IT OpenAPI operation hardwareauditdue.

Inputs: sort, limit, order, offset, +1 more.

snipeit_gen_hardwareauditoverdueGET /hardware/audit/overdueB
Read-onlyIdempotent

GET /hardware/audit/overdue: Retrieve a list of assets that are overdue for auditing. Generated from Snipe-IT OpenAPI operation hardwareauditoverdue.

Inputs: sort, limit, order, offset, +1 more.

snipeit_gen_hardware_by_asset_tagGET /hardware/bytag/{asset_tag}C
Read-onlyIdempotent

GET /hardware/bytag/{asset_tag}: Get the details of a specific asset by asset tag. Generated from Snipe-IT OpenAPI operation hardware-by-asset-tag.

Inputs: asset_tag (required), deleted.

snipeit_gen_hardware_by_idGET /hardware/{id}C
Read-onlyIdempotent

GET /hardware/{id}: Get the details of a specific asset. Generated from Snipe-IT OpenAPI operation hardware-by-id.

Inputs: id (required).

snipeit_gen_hardware_by_serialGET /hardware/byserial/{serial}C
Read-onlyIdempotent

GET /hardware/byserial/{serial}: Get the details of a specific asset by asset tag. Generated from Snipe-IT OpenAPI operation hardware-by-serial.

Inputs: serial (required), deleted.

snipeit_gen_hardware_checkinPOST /hardware/{id}/checkinC
Destructive

POST /hardware/{id}/checkin: Checkin an asset. Generated from Snipe-IT OpenAPI operation hardware-checkin.

Inputs: id (required), body, confirm.

snipeit_gen_hardware_checkoutPOST /hardware/{id}/checkoutC
Destructive

POST /hardware/{id}/checkout: Checkout an asset to a user, location or another asset. Generated from Snipe-IT OpenAPI operation hardware-checkout.

Inputs: id (required), body, confirm.

snipeit_gen_hardware_createPOST /hardwareC
Destructive

POST /hardware: Creates a new asset. Generated from Snipe-IT OpenAPI operation hardware-create.

Inputs: body, confirm.

snipeit_gen_hardware_deleteDELETE /hardware/{id}C
DestructiveIdempotent

DELETE /hardware/{id}: Deletes a specific asset. Generated from Snipe-IT OpenAPI operation hardware-delete.

Inputs: id (required), confirm.

snipeit_gen_hardware_files_deleteDELETE /hardware/{id}/files/{file_id}/deleteC
DestructiveIdempotent

DELETE /hardware/{id}/files/{file_id}/delete: /hardware/:id/files/:file_id. Generated from Snipe-IT OpenAPI operation hardware-files-delete.

Inputs: id (required), file_id (required), confirm.

snipeit_gen_hardwareidfilesfile_idGET /hardware/{id}/files/{file_id}B
Read-onlyIdempotent

GET /hardware/{id}/files/{file_id}: Download a hardware file. Generated from Snipe-IT OpenAPI operation hardwareidfilesfile_id.

Inputs: id (required), file_id (required).

snipeit_gen_hardwareidlicensesGET /hardware/{id}/licensesA
Read-onlyIdempotent

GET /hardware/{id}/licenses: Get the licenses checked out to an asset. Generated from Snipe-IT OpenAPI operation hardwareidlicenses.

Inputs: id (required).

snipeit_gen_hardwareidrestorePOST /hardware/{id}/restoreB
Destructive

POST /hardware/{id}/restore: Restore a deleted asset. Generated from Snipe-IT OpenAPI operation hardwareidrestore.

Inputs: id (required), confirm.

snipeit_gen_hardware_listGET /hardwareC
Read-onlyIdempotent

GET /hardware: Return a listing of assets. Generated from Snipe-IT OpenAPI operation hardware-list.

Inputs: sort, limit, order, filter, +12 more.

snipeit_gen_hardware_list_filesGET /hardware/{id}/filesC
Read-onlyIdempotent

GET /hardware/{id}/files: List uploaded files for an asset. Generated from Snipe-IT OpenAPI operation hardware-list-files.

Inputs: id (required).

snipeit_gen_hardware_partial_updatePATCH /hardware/{id}C
DestructiveIdempotent

PATCH /hardware/{id}: Partially updates a specific asset. Generated from Snipe-IT OpenAPI operation hardware-partial-update.

Inputs: id (required), body, confirm.

snipeit_gen_hardware_updatePUT /hardware/{id}C
DestructiveIdempotent

PUT /hardware/{id}: Updates a specific asset. Generated from Snipe-IT OpenAPI operation hardware-update.

Inputs: id (required), body, confirm.

snipeit_gen_hardware_upload_filesPOST /hardware/{id}/filesA
Destructive

POST /hardware/{id}/files: To upload multiple files to an asset, send file as an array, such as file[]. See below for details. Generated from Snipe-IT OpenAPI operation hardware-upload-files. File uploads do not work through this tool: Snipe-IT expects multipart/form-data and this tool sends JSON (the vendored spec declares JSON). Upload files in the Snipe-IT web UI.

Inputs: id (required), body, confirm.

snipeit_gen_licensesGET /licensesC
Read-onlyIdempotent

GET /licenses: Return a listing of licenses. Generated from Snipe-IT OpenAPI operation licenses.

Inputs: name, sort, limit, order, +14 more.

snipeit_gen_licensesidGET /licenses/{id}C
Read-onlyIdempotent

GET /licenses/{id}: /licenses/:id. Generated from Snipe-IT OpenAPI operation licensesid.

Inputs: id (required).

snipeit_gen_licensesid_1PUT /licenses/{id}D
DestructiveIdempotent

PUT /licenses/{id}: /licenses/:id. Generated from Snipe-IT OpenAPI operation licensesid-1.

Inputs: id (required), body, confirm.

snipeit_gen_licensesid_2PATCH /licenses/{id}D
DestructiveIdempotent

PATCH /licenses/{id}: /licenses/:id. Generated from Snipe-IT OpenAPI operation licensesid-2.

Inputs: id (required), body, confirm.

snipeit_gen_licensesid_3DELETE /licenses/{id}C
DestructiveIdempotent

DELETE /licenses/{id}: /licenses/:id. Generated from Snipe-IT OpenAPI operation licensesid-3.

Inputs: id (required), confirm.

snipeit_gen_licensesidseatsGET /licenses/{id}/seatsB
Read-onlyIdempotent

GET /licenses/{id}/seats: Return all unique Seat ID's for a particular license. Generated from Snipe-IT OpenAPI operation licensesidseats.

Inputs: id (required).

snipeit_gen_licensesidseatsseat_idGET /licenses/{id}/seats/{seat_id}B
Read-onlyIdempotent

GET /licenses/{id}/seats/{seat_id}: Get details for one specific unique Seat ID for a particular license. Generated from Snipe-IT OpenAPI operation licensesidseatsseat_id.

Inputs: id (required), seat_id (required).

snipeit_gen_licensesidseatsseat_id_2PATCH /licenses/{id}/seats/{seat_id}C
DestructiveIdempotent

PATCH /licenses/{id}/seats/{seat_id}: Update user or asset a license is checked-out to (Check-in/Check-out). Generated from Snipe-IT OpenAPI operation licensesidseatsseat_id-2.

Inputs: id (required), seat_id (required), body, confirm.

snipeit_gen_locationsGET /locationsC
Read-onlyIdempotent

GET /locations: List locations. Generated from Snipe-IT OpenAPI operation locations.

Inputs: zip, city, name, sort, +7 more.

snipeit_gen_locations_1GET /locations/{id}C
Read-onlyIdempotent

GET /locations/{id}: Get location details by id. Generated from Snipe-IT OpenAPI operation locations-1.

Inputs: id (required).

snipeit_gen_locations_2POST /locationsC
Destructive

POST /locations: Create a new location. Generated from Snipe-IT OpenAPI operation locations-2.

Inputs: body, confirm.

snipeit_gen_locations_3PUT /locations/{id}C
DestructiveIdempotent

PUT /locations/{id}: Updates a location. Generated from Snipe-IT OpenAPI operation locations-3.

Inputs: id (required), body, confirm.

snipeit_gen_locationsidPATCH /locations/{id}C
DestructiveIdempotent

PATCH /locations/{id}: Partially updates a location. Generated from Snipe-IT OpenAPI operation locationsid.

Inputs: id (required), body, confirm.

snipeit_gen_locationsid_2DELETE /locations/{id}C
DestructiveIdempotent

DELETE /locations/{id}: Deletes a location. Generated from Snipe-IT OpenAPI operation locationsid-2.

Inputs: id (required), confirm.

snipeit_gen_maintenancesGET /maintenancesC
Read-onlyIdempotent

GET /maintenances: List asset maintenances. Generated from Snipe-IT OpenAPI operation maintenances.

Inputs: sort, limit, order, offset, +2 more.

snipeit_gen_maintenances_1POST /maintenancesC
Destructive

POST /maintenances: Create a new maintenance. Generated from Snipe-IT OpenAPI operation maintenances-1.

Inputs: body, confirm.

snipeit_gen_maintenances_copyPUT /maintenances/{id}C
DestructiveIdempotent

PUT /maintenances/{id}: Update selected fields in an existing maintenance. Generated from Snipe-IT OpenAPI operation maintenances-copy.

Inputs: id (required), body, confirm.

snipeit_gen_maintenances_copy_1PATCH /maintenances/{id}C
DestructiveIdempotent

PATCH /maintenances/{id}: Update selected fields in an existing maintenance. Generated from Snipe-IT OpenAPI operation maintenances-copy-1.

Inputs: id (required), body, confirm.

snipeit_gen_maintenancesidDELETE /maintenances/{id}C
DestructiveIdempotent

DELETE /maintenances/{id}: Delete a maintenance. Generated from Snipe-IT OpenAPI operation maintenancesid.

Inputs: id (required), confirm.

snipeit_gen_manufacturersGET /manufacturersC
Read-onlyIdempotent

GET /manufacturers. Generated from Snipe-IT OpenAPI operation manufacturers.

Inputs: url, name, sort, limit, +6 more.

snipeit_gen_manufacturers_1POST /manufacturersC
Destructive

POST /manufacturers: Create a manufacturer. Generated from Snipe-IT OpenAPI operation manufacturers-1.

Inputs: body, confirm.

snipeit_gen_manufacturersidPATCH /manufacturers/{id}C
DestructiveIdempotent

PATCH /manufacturers/{id}: Partially update a Manufacturer. Generated from Snipe-IT OpenAPI operation manufacturersid.

Inputs: id (required), body, confirm.

snipeit_gen_manufacturersid_1GET /manufacturers/{id}C
Read-onlyIdempotent

GET /manufacturers/{id}: View a manufacturer. Generated from Snipe-IT OpenAPI operation manufacturersid-1.

Inputs: id (required).

snipeit_gen_manufacturersid_2DELETE /manufacturers/{id}C
DestructiveIdempotent

DELETE /manufacturers/{id}: Delete a manufacturer. Generated from Snipe-IT OpenAPI operation manufacturersid-2.

Inputs: id (required), confirm.

snipeit_gen_manufacturersid_3PUT /manufacturers/{id}C
DestructiveIdempotent

PUT /manufacturers/{id}: Update a Manufacturer. Generated from Snipe-IT OpenAPI operation manufacturersid-3.

Inputs: id (required), body, confirm.

snipeit_gen_modelsGET /modelsC
Read-onlyIdempotent

GET /models: Returns a list of models. Generated from Snipe-IT OpenAPI operation models.

Inputs: name, sort, limit, notes, +7 more.

snipeit_gen_models_1POST /modelsC
Destructive

POST /models: Create a model. Generated from Snipe-IT OpenAPI operation models-1.

Inputs: body, confirm.

snipeit_gen_models_files_listGET /models/{id}/filesB
Read-onlyIdempotent

GET /models/{id}/files: Retrieve a model's files by model ID. Generated from Snipe-IT OpenAPI operation models-files-list.

Inputs: id (required).

snipeit_gen_modelsidGET /models/{id}C
Read-onlyIdempotent

GET /models/{id}: Retrieve the specific details of a model by id. Generated from Snipe-IT OpenAPI operation modelsid.

Inputs: id (required).

snipeit_gen_modelsid_1PUT /models/{id}C
DestructiveIdempotent

PUT /models/{id}: Update a model. Generated from Snipe-IT OpenAPI operation modelsid-1.

Inputs: id (required), body, confirm.

snipeit_gen_modelsid_2PATCH /models/{id}C
DestructiveIdempotent

PATCH /models/{id}: Update a model. Generated from Snipe-IT OpenAPI operation modelsid-2.

Inputs: id (required), body, confirm.

snipeit_gen_modelsid_3DELETE /models/{id}C
DestructiveIdempotent

DELETE /models/{id}: Delete a model. Generated from Snipe-IT OpenAPI operation modelsid-3.

Inputs: id (required), confirm.

snipeit_gen_modelsidfilesPOST /models/{id}/filesA
Destructive

POST /models/{id}/files: Upload one or more files to a model. Generated from Snipe-IT OpenAPI operation modelsidfiles. File uploads do not work through this tool: Snipe-IT expects multipart/form-data and this tool sends JSON (the vendored spec declares JSON). Upload files in the Snipe-IT web UI.

Inputs: id (required), body, confirm.

snipeit_gen_modelsidfilesfile_idDELETE /models/{id}/files/{file_id}C
DestructiveIdempotent

DELETE /models/{id}/files/{file_id}: /models/:id/files/:file_id. Generated from Snipe-IT OpenAPI operation modelsidfilesfile_id.

Inputs: id (required), file_id (required), confirm.

snipeit_gen_post_auditidPOST /hardware/{id}/auditD
Destructive

POST /hardware/{id}/audit. Generated from Snipe-IT OpenAPI operation post_audit{id}.

Inputs: id (required), note, confirm, location_id, +1 more.

snipeit_gen_put_licensesidseatsseat_idPUT /licenses/{id}/seats/{seat_id}C
DestructiveIdempotent

PUT /licenses/{id}/seats/{seat_id}: Update user or asset a license is checked-out to (Check-in/Check-out). Generated from Snipe-IT OpenAPI operation put_licenses{id}seats{seat_id}.

Inputs: id (required), seat_id (required), body, confirm.

snipeit_gen_reportsactivityGET /reports/activityD
Read-onlyIdempotent

GET /reports/activity. Generated from Snipe-IT OpenAPI operation reportsactivity.

Inputs: sort, limit, order, offset, +6 more.

snipeit_gen_statuslabelsGET /statuslabelsC
Read-onlyIdempotent

GET /statuslabels: Retrieve a list of status labels. Generated from Snipe-IT OpenAPI operation statuslabels.

Inputs: name, sort, limit, order, +3 more.

snipeit_gen_statuslabels_1POST /statuslabelsC
Destructive

POST /statuslabels: Create a new status label. Generated from Snipe-IT OpenAPI operation statuslabels-1.

Inputs: body, confirm.

snipeit_gen_statuslabelsidGET /statuslabels/{id}C
Read-onlyIdempotent

GET /statuslabels/{id}: View a status label. Generated from Snipe-IT OpenAPI operation statuslabelsid.

Inputs: id (required).

snipeit_gen_statuslabelsid_1DELETE /statuslabels/{id}C
DestructiveIdempotent

DELETE /statuslabels/{id}: Delete a status label. Generated from Snipe-IT OpenAPI operation statuslabelsid-1.

Inputs: id (required), confirm.

snipeit_gen_statuslabelsid_2PUT /statuslabels/{id}C
DestructiveIdempotent

PUT /statuslabels/{id}: Updates a status label. Generated from Snipe-IT OpenAPI operation statuslabelsid-2.

Inputs: id (required), body, confirm.

snipeit_gen_statuslabelsid_3PATCH /statuslabels/{id}C
DestructiveIdempotent

PATCH /statuslabels/{id}: Updates selected fields in a status label. Generated from Snipe-IT OpenAPI operation statuslabelsid-3.

Inputs: id (required), body, confirm.

snipeit_gen_statuslabelsidassetlistGET /statuslabels/{id}/assetlistC
Read-onlyIdempotent

GET /statuslabels/{id}/assetlist: View assets with a specific status label. Generated from Snipe-IT OpenAPI operation statuslabelsidassetlist.

Inputs: id (required).

snipeit_gen_suppliersGET /suppliersD
Read-onlyIdempotent

GET /suppliers. Generated from Snipe-IT OpenAPI operation suppliers.

Inputs: fax, url, zip, city, +11 more.

snipeit_gen_suppliersidGET /suppliers/{id}C
Read-onlyIdempotent

GET /suppliers/{id}: /suppliers/:id. Generated from Snipe-IT OpenAPI operation suppliersid.

Inputs: id (required).

snipeit_gen_testinputPOST /licensesD
Destructive

POST /licenses: /licenses/. Generated from Snipe-IT OpenAPI operation testinput.

Inputs: body, confirm.

snipeit_gen_update_fieldsPUT /fields/{id}C
DestructiveIdempotent

PUT /fields/{id}: Update a custom field. Generated from Snipe-IT OpenAPI operation update-fields.

Inputs: id (required), body, confirm.

snipeit_gen_usersGET /usersC
Read-onlyIdempotent

GET /users: List users. Generated from Snipe-IT OpenAPI operation users.

Inputs: all, vip, zip, sort, +25 more.

snipeit_gen_users_2POST /usersC
Destructive

POST /users: Create a new user. Generated from Snipe-IT OpenAPI operation users-2.

Inputs: body, confirm.

snipeit_gen_users_3PATCH /users/{id}A
DestructiveIdempotent

PATCH /users/{id}: Partially update a user, passing only the fields you want to modify. Generated from Snipe-IT OpenAPI operation users-3.

Inputs: id (required), body, confirm.

snipeit_gen_usersidGET /users/{id}C
Read-onlyIdempotent

GET /users/{id}: View user details. Generated from Snipe-IT OpenAPI operation usersid.

Inputs: id (required).

snipeit_gen_usersid_1DELETE /users/{id}C
DestructiveIdempotent

DELETE /users/{id}: Delete a user. Generated from Snipe-IT OpenAPI operation usersid-1.

Inputs: id (required), confirm.

snipeit_gen_usersid_2PUT /users/{id}C
DestructiveIdempotent

PUT /users/{id}: Update a user. Generated from Snipe-IT OpenAPI operation usersid-2.

Inputs: id (required), body, confirm.

snipeit_gen_usersidaccessoriesGET /users/{id}/accessoriesB
Read-onlyIdempotent

GET /users/{id}/accessories: Get a list of accessories checked out to the user. Generated from Snipe-IT OpenAPI operation usersidaccessories.

Inputs: id (required).

snipeit_gen_usersidassetsGET /users/{id}/assetsB
Read-onlyIdempotent

GET /users/{id}/assets: Get a list of assets checked out to the user. Generated from Snipe-IT OpenAPI operation usersidassets.

Inputs: id (required), model_id, category_id.

snipeit_gen_usersideulasGET /users/{id}/eulasB
Read-onlyIdempotent

GET /users/{id}/eulas: Show the accepted EULAs by a specific user. Generated from Snipe-IT OpenAPI operation usersideulas.

Inputs: id (required).

snipeit_gen_usersidlicensesGET /users/{id}/licensesB
Read-onlyIdempotent

GET /users/{id}/licenses: Get a list of licenses checked out to the user. Generated from Snipe-IT OpenAPI operation usersidlicenses.

Inputs: id (required).

snipeit_gen_usersmeGET /users/meB
Read-onlyIdempotent

GET /users/me: Get details on the current user accessing the API. Generated from Snipe-IT OpenAPI operation usersme.

Inputs: no named parameters.

snipeit_gen_users_restorePOST /users/{id}/restoreB
Destructive

POST /users/{id}/restore: Restore a soft-deleted user. Generated from Snipe-IT OpenAPI operation users-restore.

Inputs: id (required), confirm.

snipeit_get_hardware_by_idGet hardware by idC
Read-onlyIdempotent

GET /hardware/{id}

Inputs: id (required).

snipeit_get_hardware_by_serialGet hardware by serialC
Read-onlyIdempotent

GET /hardware/byserial/{serial}

Inputs: serial (required), deleted.

snipeit_get_hardware_by_tagGet hardware by asset tagC
Read-onlyIdempotent

GET /hardware/bytag/{tag}: tag is URL-encoded automatically.

Inputs: tag (required), deleted.

snipeit_get_license_seatsGet seats for a licenseC
Read-onlyIdempotent

GET /licenses/{id}/seats: list all seats for a license.

Inputs: id (required), limit, offset.

snipeit_get_locationGet location by idC
Read-onlyIdempotent

GET /locations/{id}: retrieve a single location record.

Inputs: id (required).

snipeit_get_statuslabel_assetsGet assets for a status labelB
Read-onlyIdempotent

GET /statuslabels/{id}/assetlist: returns paginated assets that have this status label assigned.

Inputs: id (required), limit, offset.

snipeit_get_userGet user by idC
Read-onlyIdempotent

GET /users/{id}

Inputs: id (required).

snipeit_get_user_accessoriesGet accessories checked out to a userC
Read-onlyIdempotent

GET /users/{id}/accessories

Inputs: id (required).

snipeit_get_user_assetsGet assets checked out to a userC
Read-onlyIdempotent

GET /users/{id}/assets: list hardware checked out to this user.

Inputs: id (required), limit, offset.

snipeit_get_user_licensesGet licenses assigned to a userC
Read-onlyIdempotent

GET /users/{id}/licenses

Inputs: id (required).

snipeit_list_accessoriesList accessoriesB
Read-onlyIdempotent

GET /accessories: paginated list. Supports search and common filters.

Inputs: all, limit, offset, search, +4 more.

snipeit_list_audit_dueList audits dueD
Read-onlyIdempotent

GET /hardware/audit/due

Inputs: all, limit, offset.

snipeit_list_audit_overdueList audits overdueD
Read-onlyIdempotent

GET /hardware/audit/overdue

Inputs: all, limit, offset.

snipeit_list_componentsList componentsC
Read-onlyIdempotent

GET /components: paginated list. Supports search and common filters.

Inputs: all, limit, offset, search, +3 more.

snipeit_list_consumablesList consumablesB
Read-onlyIdempotent

GET /consumables: paginated list. Supports search and common filters.

Inputs: all, limit, offset, search, +3 more.

snipeit_list_hardwareList hardware (assets)C
Read-onlyIdempotent

GET /hardware: paginated. Supports search and common filters.

Inputs: all, sort, limit, order, +12 more.

snipeit_list_licensesList licensesC
Read-onlyIdempotent

GET /licenses: paginated list. Supports search and common filters.

Inputs: all, limit, offset, search, +6 more.

snipeit_list_locationsList locationsB
Read-onlyIdempotent

GET /locations: paginated list. Supports search and optional parent_id filter.

Inputs: all, limit, offset, search, +1 more.

snipeit_list_maintenancesList asset maintenancesB
Read-onlyIdempotent

GET /maintenances: paginated list. Optionally filter by asset_id, supplier_id, or maintenance type.

Inputs: all, limit, offset, asset_id, +2 more.

snipeit_list_statuslabelsList status labelsC
Read-onlyIdempotent

GET /statuslabels: paginated list. Supports search.

Inputs: all, limit, offset, search, +1 more.

snipeit_list_usersList usersC
Read-onlyIdempotent

GET /users: paginated list. Supports search and common filters.

Inputs: all, limit, offset, search, +5 more.

snipeit_meWho am IA
Read-onlyIdempotent

GET /users/me: returns the current authenticated user. Use to verify token + base URL.

Inputs: no named parameters.

snipeit_raw_requestSnipe-IT raw requestA
Destructive

Generic escape hatch: executes ANY HTTP method against SNIPEIT_API_BASE{path}. Use when no dedicated tool exists. Bearer auth, retry, status-envelope check, and pagination hint are handled automatically.

Inputs: path (required), method (required), body, query, +1 more.

snipeit_search_hardwareSearch hardware by free textC
Read-onlyIdempotent

Convenience: GET /hardware?search={query}.

Inputs: query (required), all, limit, offset.

snipeit_update_hardwareUpdate hardware (partial)C
DestructiveIdempotent

PATCH /hardware/{id}: partial update.

Inputs: id (required), body (required), confirm.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    D1.9/5.0

    Scored across 183 tools

    Disambiguation1/5

    The surface is dominated by duplicate coverage of the same endpoints: list_hardware vs gen_hardware_list, create_hardware vs gen_hardware_create, checkout_hardware vs gen_hardware_checkout, plus raw_request as a universal escape hatch. Agents cannot reliably choose between semantic tools and generated tools, and many gen_* names differ only by opaque suffixes.

    Naming Consistency2/5

    There are two competing naming schemes: readable semantic names like snipeit_list_hardware and generated names like snipeit_gen_hardware_list and snipeit_gen_fieldsid_3. The generated names use inconsistent numeric suffixes and tangled operation names, making verb/noun intent unpredictable despite staying in snake_case.

    Tool Count1/5

    183 tools is far beyond a reasonable scoped surface for this server, especially because many tools are near-duplicates of the same endpoint. The count creates overwhelming selection noise rather than adding useful capability.

    Completeness2/5

    Broad Snipe-IT resources are represented, but the surface has severe redundancy, broken/incomplete tools such as file uploads that explicitly do not work, and odd generated endpoints. Coverage is technically wide but operationally unreliable and hard to navigate.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server providing token-efficient access to OpenAPI/Swagger specs via MCP Resources for client-side exploration.
      582 npm
      76
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for SolarWinds Service Desk (SWSD/Samanage) enabling reading and modifying tickets, comments, knowledge-base articles, and more via each user's own API token.
      52
      1,760 npm
      5
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for the Snipe-IT asset management REST API, enabling read and write operations on assets, licenses, accessories, and more.
      13
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      MCP server for JumpCloud APIs with full OpenAPI-driven coverage, enabling endpoint discovery, operation invocation, and direct API requests while managing multi-tenant user tokens in Vault and guarding mutating tools.
      20
      MIT