# HireLocksmiths — Locksmith Finder

> Find a vetted U.S. locksmith, request a quote or booking; products for locksmith businesses.

- name: com.hirelocksmiths/locksmith-finder
- version: 1.6.1
- connection class: R0 (autonomous)
- trust: 83/100 flags: no-repository
- quality: 86/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.hirelocksmiths%2Flocksmith-finder
- tools: https://api.protogrid.dev/v1/servers/com.hirelocksmiths%2Flocksmith-finder/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "locksmith-finder": {
      "type": "http",
      "url": "https://hirelocksmiths-mcp.onrender.com/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% +updated-12d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 86/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 7 of 7 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 1,752 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 75 (weight 15)

- warn `stability.changes`: 7 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 7, about 1,752 tokens to load them all
- tool set hash: 57ae92c6f0d93d6e48c82da0b0202401
- tools last changed: 2026-10-08T20:08:15.976Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.hirelocksmiths/locksmith-finder.svg)](https://protogrid.dev/servers/com.hirelocksmiths/locksmith-finder)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-08 `list_membership_products` added
  - For LOCKSMITH BUSINESSES (or a tool acting for one): what HireLocksmiths sells and how to buy it. Use when a locksmith asks about getting listed, the verified badge, missed-call textback, the AI text/voice receptionist, review automation, a microsite, or "Own Your City" exclusive leads. NOT for consumers looking for a locksmith - use search_locksmiths for them. Returns the live catalog (name, price, billing: year/month/one_time, description, requires, checkout_url) plus signup_url. Prices are read from the live pricing page. There is no agent-side checkout: give the business the checkout_url. With a city slug (e.g. "phoenix") also returns that city's listing count and whether the exclusive Own-Your-City slot is currently open. Args: city: Optional city slug from the directory (lower-case, hyphenated, e.g. "san-antonio").
- 2026-10-08 `get_eta` changed (annotations)
- 2026-10-08 `check_availability` changed (annotations)
- 2026-10-08 `book_job` changed (annotations)
- 2026-10-08 `request_quote` changed (annotations)
- 2026-10-08 `get_locksmith` changed (annotations)
- 2026-10-08 `search_locksmiths` changed (annotations)

Full history: https://api.protogrid.dev/v1/servers/com.hirelocksmiths%2Flocksmith-finder/changes

## Remotes

- https://hirelocksmiths-mcp.onrender.com/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (7)

- `book_job`: Create a booking request with a specific locksmith (firmer than request_quote).

    ONLY call when the user wants to book a job — it sends a real request. Provide a
    phone (preferred) or email. `preferred_time` is the requested window, e.g.
    "today 3-5pm". This is a booking REQUEST, not a guaranteed appointment; the
    locksmith confirms the time, price, and ETA. Returns a reference id (HL-####).
    
- `check_availability`: Check coverage for one provider (locksmith_id) or an area (location: ZIP or city).

    Returns whether the area is served, how many vetted providers cover it, and how many
    offer 24/7 emergency service. Live availability is confirmed at request_quote — this
    does not return a real-time "available now" status, so don't imply one.
    
- `get_eta`: Get an ETA proxy for a location (ZIP or city).

    eta_minutes is null — HireLocksmiths does not pre-list ETAs. The tool returns the
    number of vetted providers nearby and whether 24/7 emergency coverage exists (usually
    fastest). For a real ETA, call request_quote and the locksmith confirms it directly.
    Never invent a number of minutes.
    
- `get_locksmith`: Get the full profile for one locksmith by id (from search_locksmiths).

    Returns name, city/state, services, service-area ZIPs, rating, review count,
    verification note, phone, and profile URL.
    
- `list_membership_products`: For LOCKSMITH BUSINESSES (or a tool acting for one): what HireLocksmiths sells and how to buy it.

    Use when a locksmith asks about getting listed, the verified badge, missed-call textback,
    the AI text/voice receptionist, review automation, a microsite, or "Own Your City"
    exclusive leads. NOT for consumers looking for a locksmith - use search_locksmiths for them.

    Returns the live catalog (name, price, billing: year/month/one_time, description,
    requires, checkout_url) plus signup_url. Prices are read from the live pricing page.
    There is no agent-side checkout: give the business the checkout_url. With a city slug
    (e.g. "phoenix") also returns that city's listing count and whether the exclusive
    Own-Your-City slot is currently open.

    Args:
        city: Optional city slug from the directory (lower-case, hyphenated, e.g. "san-antonio").
    
- `request_quote`: Create a lead: ask a specific locksmith for a quote.

    ONLY call this when the user has chosen a provider and wants to be contacted —
    it sends a real request to the locksmith. Provide a phone (preferred) or email
    so the locksmith can reach the customer. Returns a reference id (HL-####); the
    locksmith confirms availability, price, and ETA directly.

    Args:
        locksmith_id: id from search_locksmiths / get_locksmith.
        name:         Customer name.
        phone:        Customer phone (preferred). Phone OR email is required.
        email:        Customer email (alternative to phone).
        zip:          5-digit ZIP of the job (improves routing/records).
        service:      Job type, e.g. "lockout", "automotive".
        details:      Free-text description of the job.
        urgency:      e.g. "emergency", "today".
    
- `search_locksmiths`: Find vetted, licensed locksmiths near a location.

    Use this first when a user needs a locksmith. Returns a ranked list of
    human-vetted providers (featured first) with id, name, city, services,
    rating, verified/featured flags, phone, and a profile URL.

    Args:
        location: A 5-digit US ZIP code (preferred) or a US city name.
        service:  Optional job type, e.g. "lockout", "automotive", "residential",
                  "commercial", "rekey", "install", "safe".
        urgency:  Optional, e.g. "emergency", "today", "scheduled".
        budget:   Optional free-text budget hint.
        limit:    Max results to return (1-20, default 5).

    Note: price and ETA are NOT pre-listed — they are confirmed by the locksmith
    after you call request_quote. Do not invent prices or ETAs.
    
