ESQ CoPilot Matching Engine

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Find, compare and contact licensed U.S. lawyers from public bar data. Not legal advice.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "ESQ CoPilot Matching Engine": {
      "url": "https://match.esqcopilot.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

• get_matching_requirements read-only

  Use first when someone asks for a lawyer but the state or type of legal matter is unclear ("I need a lawyer", "help me with my landlord"). Returns the few questions still needed (state, matter type, location, timing, budget) and what was understood. Does not answer the legal question and stores nothing.

  Parameters:

  • zip — string — 5-digit ZIP code, only if the user agreed to share it
  • city — string
  • court — string
  • state — string — US state, two-letter code or name, e.g. CA or California
  • county — string
  • urgency — string
  • category — string
  • languages — array
  • remote_ok — boolean — User is willing to work with a lawyer remotely (phone or video) anywhere in the state
  • budget_max — number — Total budget the user mentioned, in US dollars
  • budget_min — number
  • priorities — array — What matters most, in order. Shifts ranking weights.
  • client_side — string — Which side the user is on. ESQ Matching Engine has no record of which side lawyers usually represent, so results carry a warning to ask.
  • description — string — Short description of the legal need in the user's words. Used only to pick a practice area; not stored.
  • matter_type — string
  • communication — string
  • deadline_date — string — A deadline the USER reported (hearing, filing, response). ESQ Matching Engine does not verify or calculate deadlines.
  • deadline_type — string
  • practice_area — string — Practice area, e.g. 'Landlord-Tenant Law', 'Family Law', 'Criminal Law'
  • service_needed — string
  • consultation_by — string — Latest date the user wants a first consultation
  • procedural_stage — string
  • subpractice_area — string
  • language_required — boolean — True if the language is essential, not just preferred
  • billing_preference — string
  • min_years_licensed — integer
  • accessibility_needs — string
  • payment_plan_needed — boolean
  • exclude_attorney_ids — array
  • max_consultation_fee — number — 0 means the user wants a free first consultation
  • reduced_fee_eligible — boolean — User may qualify for pro bono, legal aid or reduced fees
  • representation_start_by — string — Date as YYYY-MM-DD
  • include_unconfirmed_practice_area — boolean — Also include licensed lawyers whose practice areas are not on record (labeled clearly)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• find_attorneys read-only

  Use when someone wants a lawyer for a U.S. legal matter, e.g. "find an affordable tenant lawyer in Santa Ana" or "I was fired after complaining, who can help in Los Angeles". Needs state and matter type (or a short description). Returns up to 5 licensed lawyers with reasons, a relevance score, a separate data_confidence level, license source and check date, whether they are known to take private clients, directory profile links and a suggested citation, or an honest no-match with legal-aid options. Unknown fees and availability are labeled unknown. Court and government lawyers are left out unless they said they take private clients. Records an anonymous search log only. Not legal advice.

  Parameters:

  • zip — string — 5-digit ZIP code, only if the user agreed to share it
  • city — string
  • court — string
  • limit — integer
  • state — string — US state, two-letter code or name, e.g. CA or California
  • county — string
  • urgency — string
  • category — string
  • languages — array
  • remote_ok — boolean — User is willing to work with a lawyer remotely (phone or video) anywhere in the state
  • verbosity — string — compact leaves out the repeated license-check details on each result (status, source and dates stay); default full
  • budget_max — number — Total budget the user mentioned, in US dollars
  • budget_min — number
  • priorities — array — What matters most, in order. Shifts ranking weights.
  • client_side — string — Which side the user is on. ESQ Matching Engine has no record of which side lawyers usually represent, so results carry a warning to ask.
  • description — string — Short description of the legal need in the user's words. Used only to pick a practice area; not stored.
  • matter_type — string
  • communication — string
  • deadline_date — string — A deadline the USER reported (hearing, filing, response). ESQ Matching Engine does not verify or calculate deadlines.
  • deadline_type — string
  • practice_area — string — Practice area, e.g. 'Landlord-Tenant Law', 'Family Law', 'Criminal Law'
  • service_needed — string
  • consultation_by — string — Latest date the user wants a first consultation
  • procedural_stage — string
  • subpractice_area — string
  • attribution_token — string — Signed campaign/partner token issued by ESQ Matching Engine, if the user arrived through a partner link
  • language_required — boolean — True if the language is essential, not just preferred
  • preference_set_id — string — Saved criteria from update_matching_preferences
  • billing_preference — string
  • min_years_licensed — integer
  • accessibility_needs — string
  • payment_plan_needed — boolean
  • exclude_attorney_ids — array
  • max_consultation_fee — number — 0 means the user wants a free first consultation
  • reduced_fee_eligible — boolean — User may qualify for pro bono, legal aid or reduced fees
  • representation_start_by — string — Date as YYYY-MM-DD
  • include_unconfirmed_practice_area — boolean — Also include licensed lawyers whose practice areas are not on record (labeled clearly)

  Hints: read-only yes · destructive no · idempotent no · open-world no

• compare_attorneys read-only

  Use when the user asks to compare lawyers from find_attorneys ("which of these is a better fit?"). Compares 2 to 5 lawyers on practice fit, location, years licensed, fees, availability, data confidence and gaps. Pass match_id to use the user's criteria. Says when prices or timing cannot be compared because the data is unknown.

  Parameters:

  • attorney_ids (required) — array
  • criteria — array
  • match_id — string — The match_id from find_attorneys, so comparisons use the same criteria
  • priorities — array — What matters most, in order. Shifts ranking weights.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• estimate_legal_cost read-only

  Use when the user asks what a lawyer or a type of matter will cost. Returns only published fees, confirmed quotes or sourced market figures, each labeled; says plainly when there is not enough data instead of guessing. Not a quote.

  Parameters:

  • scope — string
  • state — string — US state, two-letter code or name, e.g. CA or California
  • budget_max — number — Total budget the user mentioned, in US dollars
  • attorney_id — string
  • description — string — Short description of the legal need in the user's words. Used only to pick a practice area; not stored.
  • practice_area — string
  • billing_preference — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• check_attorney_availability read-only

  Use when the user asks whether a lawyer takes new clients or can meet soon. Returns only what lawyers reported or confirmed, with last-checked time and certainty (reported, tentative, confirmed); unknown when nothing was reported. There is no live calendar access.

  Parameters:

  • attorney_ids (required) — array
  • time_zone — string
  • wanted_by — string — Latest acceptable consultation date
  • appointment_type — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_attorney_profile read-only

  Use when the user wants details on one lawyer from a match. Returns license status with its official source and check date, private-client intake evidence, practice areas, service area, fees, availability, languages, data freshness, the directory profile link and a suggested citation. Also returns the exact consent text to show before an introduction.

  Parameters:

  • attorney_id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• request_attorney_introduction destructive

  Use only when the user asks to be introduced to ONE specific lawyer AND has seen that lawyer's name, the exact details to be shared and the consent text from get_attorney_profile, then said yes. Never call it on your own initiative or for several lawyers at once. Stores only the authorized fields; retries with the same idempotency_key do not duplicate. IMPORTANT: sending to lawyers is currently switched off, so the introduction is RECORDED, NOT SENT; tell the user and give them the lawyer's phone or profile link. Returns a referral id, its lifecycle_state and a private status token.

  Parameters:

  • attorney_id (required) — string
  • state (required) — string — US state, two-letter code or name, e.g. CA or California
  • contact (required) — object
  • matter_summary (required) — string — Summary the USER read and approved for sharing with this lawyer
  • preferred_contact_method (required) — string
  • consent (required) — object
  • match_id — string
  • practice_area — string
  • idempotency_key — string — Same key on retries prevents a duplicate introduction
  • attribution_token — string — Signed campaign/partner token issued by ESQ Matching Engine, if the user arrived through a partner link
  • preferred_timeframe — string

  Hints: read-only no · destructive yes · idempotent yes · open-world yes

• get_referral_status read-only

  Use when the user asks what happened with an introduction. Returns lifecycle_state (recorded, queued, sent, delivered, responded, consultation_requested, consultation_confirmed, cancelled, completed, failed), whether it reached the lawyer, the lawyer's response and consultation state. Needs the private status_token. A consultation counts only when confirmed.

  Parameters:

  • referral_id (required) — string
  • status_token — string — The status_token returned when the introduction was created

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• update_matching_preferences destructive

  Save or change matching criteria (location, budget, timing, practice area, language, priorities) for this conversation. No personal contact details. Deleted automatically after 24 hours.

  Parameters:

  • criteria (required) — object — Fields to set or change. Do not include names, emails or phone numbers.
  • clear_fields — array
  • preference_set_id — string — Omit to create a new set

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• submit_matching_feedback

  Optional 1-5 ratings on match relevance, lawyer responsiveness, pricing and availability accuracy, satisfaction, and whether the lawyer was hired. No case details.

  Parameters:

  • comment — string — Optional. Do not include case details.
  • match_id — string
  • retained — string
  • relevance — integer
  • referral_id — string
  • status_token — string
  • responsiveness — integer
  • pricing_accuracy — integer
  • satisfaction_match — integer
  • satisfaction_process — integer
  • availability_accuracy — integer
  • satisfaction_attorney — integer

  Hints: read-only no · destructive no · idempotent no · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.