INDIVIDUAL MCP TOOL

shopmonkey_search_appointments

Search the appointment calendar by date range, customer, order or technician.

usefulapi.ionone authenticationAvailability not checked

LIVE ENDPOINT

https://shopmonkey.usefulapi.io/mcp

No auth detected

Connect to this endpoint to inspect the live schema for shopmonkey_search_appointments and invoke it with your own arguments.

{}

Inferred read-only · medium confidence · heuristic, not a guarantee.

No write-capable action terms were found; this is not proof that invocation has no side effects.

CONNECT WITH APPROVAL

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.shopmonkey-mcp]
url = "https://shopmonkey.usefulapi.io/mcp"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "shopmonkey-mcp": {
      "type": "http",
      "url": "https://shopmonkey.usefulapi.io/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: shopmonkey-mcp
Remote MCP URL: https://shopmonkey.usefulapi.io/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

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

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

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

Generic MCP

Client-specific MCP configuration

{
  "name": "shopmonkey-mcp",
  "transport": "streamable-http",
  "url": "https://shopmonkey.usefulapi.io/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

shopmonkey_get_current_user — Fetch the user this API key acts as — id, name, company, default location and permissions.
shopmonkey_search_customers — Search customers with a server-side filter, sort and paging.
shopmonkey_find_customers_by_phone — Find the customers that own any of the given phone numbers — the usual way to identify a caller.
shopmonkey_find_customers_by_email — Find the customers that own any of the given email addresses.
shopmonkey_get_customer — Fetch a single customer by id — contact details, emails, phone numbers, counts of vehicles/orders/appointments.
shopmonkey_list_customer_vehicles — List the vehicles owned by a customer (year/make/model, VIN, plate, mileage).
shopmonkey_list_customer_orders — List a customer's work orders (estimates, repair orders, invoices) — their service history.
shopmonkey_get_vehicle — Fetch a single vehicle by id, including its mileage and tire-pressure logs.