Look up shop customers, vehicles, work orders and parts, and create orders or book appointments. Hosted by usefulapi — connect from Claude, Cursor, or any MCP client.
Add to your MCP config, then reload & authorize:
{
"mcpServers": {
"shopmonkey": {
"url": "https://shopmonkey.usefulapi.io/mcp"
}
}
}| Tool | Type | What it does |
|---|---|---|
shopmonkey_get_current_user | read | Get the current user Fetch the user this API key acts as — id, name, company, default location and permissions. A cheap way to confirm the key works and to find your locationId. Shopmonkey: GET /v3/user/me. |
shopmonkey_search_customers | read | Search customers Search customers with a server-side filter, sort and paging. Returns customers with their emails and phone numbers. Shopmonkey: POST /v3/customer/search. |
shopmonkey_find_customers_by_phone | read | Find customers by phone number Find the customers that own any of the given phone numbers — the usual way to identify a caller. Shopmonkey: POST /v3/customer/phone_number/search. |
shopmonkey_find_customers_by_email | read | Find customers by email Find the customers that own any of the given email addresses. Shopmonkey: POST /v3/customer/email/search. |
shopmonkey_get_customer | read | Get one customer Fetch a single customer by id — contact details, emails, phone numbers, counts of vehicles/orders/appointments. Shopmonkey: GET /v3/customer/:id. |
shopmonkey_list_customer_vehicles | read | List a customer's vehicles List the vehicles owned by a customer (year/make/model, VIN, plate, mileage). Shopmonkey: GET /v3/customer/:id/vehicle. |
shopmonkey_list_customer_orders | read | List a customer's orders List a customer's work orders (estimates, repair orders, invoices) — their service history. Shopmonkey: GET /v3/customer/:id/order. |
shopmonkey_get_vehicle | read | Get one vehicle Fetch a single vehicle by id, including its mileage and tire-pressure logs. Shopmonkey: GET /v3/vehicle/:id. |
shopmonkey_list_orders | read | List orders List work orders for the shop, paged. Each order carries its number, status flags (authorized, invoiced, paid), totals in cents, workflow status and assigned technicians. For one customer's orders use shopmonkey_list_customer_orders. Shopmonkey: GET /v3/order. |
shopmonkey_get_order | read | Get one order Fetch a single work order by id — customer, vehicle, complaint, totals (parts/labor/tax in cents), payment state and profitability. Shopmonkey: GET /v3/order/:id. |
shopmonkey_list_order_services | read | List an order's services List the services (jobs) on a work order with their line items — labor, parts, tires, fees, subcontracts — authorization status and totals. Shopmonkey: GET /v3/order/:orderId/service. |
shopmonkey_search_appointments | read | Search appointments Search the appointment calendar by date range, customer, order or technician. Returns appointments with their customer. Shopmonkey: POST /v3/appointment/search. |
shopmonkey_search_inventory_parts | read | Search inventory parts Search the parts inventory — name, part number, SKU, quantity on hand/available/reserved, retail and wholesale cost in cents, bin location, brand and vendor. Filter e.g. {"sku": "ABC-123"}. Shopmonkey: POST /v3/inventory_part/search. |
shopmonkey_list_canned_services | read | List canned services List the shop's canned services (reusable job templates like 'Oil change') with their labor, parts and fees and total in cents. Shopmonkey: GET /v3/canned_service. |
shopmonkey_list_workflow_statuses | read | List workflow statuses List the workflow statuses (the columns of the shop's work-order board) with their position. Use the id to move an order with shopmonkey_update_order. Shopmonkey: GET /v3/workflow_status. |
shopmonkey_list_users | read | List users List the shop's users (service writers, technicians, admins) — the ids to use for technicians and service writers. Shopmonkey: GET /v3/user. |
shopmonkey_create_customer | write | Create a customer Create a customer (a person) or a fleet account. Add an email afterwards with shopmonkey_add_customer_email. Shopmonkey: POST /v3/customer. |
shopmonkey_update_customer | write | Update a customer Update a customer's name, address, note or preferences. Only the fields you pass are sent. Shopmonkey: PUT /v3/customer/:id. |
shopmonkey_add_customer_email | write | Add an email to a customer Add an email address to an existing customer, optionally as their primary address. Shopmonkey: POST /v3/customer/:id/email. |
shopmonkey_create_vehicle | write | Create a vehicle Create a vehicle, optionally attached to a customer. Shopmonkey: POST /v3/vehicle. |
shopmonkey_create_order | write | Create an order Open a new work order (it starts as an estimate) for a customer and vehicle. Add services in the Shopmonkey UI. Shopmonkey: POST /v3/order. |
shopmonkey_update_order | write | Update an order Update a work order — move it to another workflow status, change its status (Estimate, RepairOrder, Invoice), edit complaint/recommendation, due date, service writer, or archive it. Only the fields you pass are sent. Shopmonkey: PUT /v3/order/:id. |
shopmonkey_create_appointment | write | Book an appointment Book an appointment on the shop calendar, optionally for a customer, vehicle and order and assigned to technicians. Confirmation/reminder messages are only sent if you ask. Shopmonkey: POST /v3/appointment. |
shopmonkey_usage_status | Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter. | |
shopmonkey_upgrade | Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED Shopmonkey tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter. |
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 100 tool calls / month |
| Proper user | $9/mo · $90/yr | Unlimited |
This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.