MCP server

UpKeep MCP by usefulapi

io.usefulapi/upkeep

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

Read UpKeep work orders, assets, parts and meters; create requests and work orders.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

29

Token cost

About 9,026 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http upkeep https://upkeep.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.upkeep]
url = "https://upkeep.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"upkeep":{"httpUrl":"https://upkeep.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"upkeep":{"url":"https://upkeep.usefulapi.io/mcp"}}}

VS Code

{"servers":{"upkeep":{"type":"http","url":"https://upkeep.usefulapi.io/mcp"}}}

Antigravity

agy mcp add upkeep https://upkeep.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"upkeep","server_url":"https://upkeep.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"upkeep","server_url":"https://upkeep.usefulapi.io/mcp"}

Tools

• upkeep_add_meter_reading ~206 tokens
  WRITE: record a new reading on a meter (for example engine hours or mileage). A reading cannot be removed with this server, and a meter notification can create a work order automatically when its condition is met. POST /meters/{id}/readings.
• upkeep_add_work_order_message Sends messages · ~168 tokens
  WRITE: post a message (comment) on a work order's activity thread; people following the work order may be notified. POST /work-orders/{id}/update-messages.
• upkeep_approve_request ~165 tokens
  WRITE: approve a pending work request, which converts it into a work order (it may notify the assignee). Needs a token whose role may approve requests. Approving a request that is already approved or declined fails with HTTP 409. POST /requests/{id}/approve.
• upkeep_create_request ~455 tokens
  WRITE: submit a new work request for the maintenance team to approve (it appears in UpKeep's Requests list and may notify the approvers or the assignee). It is not a work order until approved. If the account has a request form configured, pass its field labels in `fields`. POST /requests.
• upkeep_create_work_order ~358 tokens
  WRITE: create a new work order (it may notify the assignee and appears in UpKeep's work order board). Ids for asset, location and assignee come from the list tools. POST /work-orders.
• upkeep_get_account ~94 tokens
  Confirm the UpKeep API token is active: returns the company id, the token's name, when it was created and when it was last used. GET /api/v1/organization-api-tokens/introspect.
• upkeep_get_asset ~233 tokens
  One asset by id with purchase and warranty details, custom fields and (optionally) assigned users, teams, vendors, parts, files and sub-assets. GET /assets/{id}.
• upkeep_get_location ~102 tokens
  One location by id. GET /locations/{id}.
• upkeep_get_meter ~97 tokens
  One meter by id. GET /meters/{id}.
• upkeep_get_part ~109 tokens
  One part by id with quantity, cost, location and custom fields. GET /parts/{id}.
• upkeep_get_purchase_order ~128 tokens
  One purchase order by id with its parts, quantities, costs and shipping details. GET /purchase-orders/{id}.
• upkeep_get_request ~121 tokens
  One work request by id with its form fields and, once approved, the linked work order id. GET /requests/{id}.
• upkeep_get_user ~96 tokens
  One user by id. GET /users/{id}.
• upkeep_get_work_order ~205 tokens
  One work order by id with its checklist items, custom fields, time log, parts and files. GET /work-orders/{id}.
• upkeep_list_assets ~674 tokens
  List assets (equipment) with name, model, serial and barcode, location, status, downtime status, warranty and number of open work orders. Filter by name, serial number, barcode, location, status, category or assignee. GET /assets.
• upkeep_list_customers ~180 tokens
  List customers (the parties whose assets or locations you maintain) with contact details. GET /customers.
• upkeep_list_locations ~525 tokens
  List locations (sites, buildings, rooms) with address, barcode, parent location and hierarchy level. GET /locations.
• upkeep_list_meter_readings ~298 tokens
  Readings recorded for one meter (value, date, who recorded it), newest first. GET /meters/{id}/readings.
• upkeep_list_meters ~471 tokens
  List meters (usage counters such as hours, mileage, temperature) with units, reading frequency and the asset or location they belong to. GET /meters.
• upkeep_list_parts ~508 tokens
  List spare parts with quantity on hand, minimum quantity, cost, category, location and part number. Compare quantity with minimumQuantity to find parts to reorder. GET /parts.
• upkeep_list_preventive_maintenance ~390 tokens
  List preventive maintenance (PM) templates, the recurring work that generates scheduled work orders, with their schedules. Filter by text, asset, location, assignee, team or priority. Pages are 1-based. GET /pm.
• upkeep_list_purchase_orders ~588 tokens
  List purchase orders with status (awaiting, approved, declined, fulfilled), vendor, dates, total cost and quantities. GET /purchase-orders.
• upkeep_list_requests ~667 tokens
  List work requests submitted by staff or through the request portal (before they become work orders), with status open/approved/rejected. GET /requests.
• upkeep_list_teams ~169 tokens
  List teams with name and description. Use the ids to assign work. GET /teams.
• upkeep_list_users ~387 tokens
  List UpKeep users (technicians, admins, requesters) with account type, job title, status and last login. Use the ids to assign work orders. GET /users.
• upkeep_list_vendors ~175 tokens
  List vendors (suppliers and contractors) with contact details. GET /vendors.
• upkeep_list_work_orders ~911 tokens
  List work orders (reactive and preventive), newest first, with status, priority, due date, asset, location, assignee, parts, time and cost. Filter by status, completion, priority, category, asset, location, assignee, title or date ranges. GET /work-orders.
• upkeep_update_part_quantity ~225 tokens
  WRITE: set the quantity on hand (and optionally the minimum quantity that triggers a low-stock notification) of a part. This overwrites the stored number: read the part first and pass the new total, not the difference. PATCH /parts/{id}.
• upkeep_update_work_order ~321 tokens
  WRITE: change fields of an existing work order: status (open, onHold, inProgress, complete), title, description, priority, due date or assignee. Only the fields you pass change; completing a work order may trigger the account's integrations (for example Zapier). Archiving and deleting are not offere

Browse

• Website monitoring
• Shipping and parcels

Related MCP servers

• Fleetio MCP by usefulapi
  Read Fleetio vehicles, work orders, service, issues, inspections, fuel, parts; log issues, meters.
• Shopmonkey MCP by usefulapi
  Look up shop customers, vehicles, work orders and parts, and create orders or book appointments.
• vintrace MCP by usefulapi
  Read vintrace vessels, batches, work orders, lab results, stock; assign work orders, add notes.
• Linnworks MCP by usefulapi
  Read Linnworks inventory, stock and orders; set stock levels and add order notes.
• Signal Bureau
  SigB (Signal Bureau): maintained, source-traced record of entities and events in your named domain.
• Polar MCP by usefulapi
  Products, customers, orders, subscriptions, benefits, revenue metrics and refunds.
• Agent-asset reclamation (lost-and-found)
  Lost-and-found for agent-created assets: sweep, title proof, register, check first.
• Buildium MCP by usefulapi
  Read Buildium properties, units, leases, tenants, balances and bills; manage work orders.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/upkeep.svg)](https://aptlynx.net/servers/io.usefulapi/upkeep)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents