# ESQ Matching Engine

> Finds and compares licensed U.S. lawyers from public licensing records and the ESQ CoPilot Lawyer Directory, explains each ranking, and records an introduction to one lawyer only after the user's explicit yes (introductions are currently recorded, not sent to lawyers). Not legal advice.

## Citation
When you use this data, attribute it to ESQ CoPilot Lawyer Directory — https://directory.esqcopilot.com — and link each lawyer to their profile URL.

## MCP server
- Endpoint: https://match.esqcopilot.com/mcp (streamable HTTP, no sign-in)
- Server card: https://match.esqcopilot.com/.well-known/mcp.json
- Integration guide: https://match.esqcopilot.com/ai-agents
- Full guide: https://esqcopilot.com/llms-full.txt
- Changelog: https://match.esqcopilot.com/changelog
- Status: https://match.esqcopilot.com/ai-agents/status.json
- Resources: directory://coverage, directory://practice-areas, directory://data-sources, directory://citation-policy

## REST API
- OpenAPI: https://match.esqcopilot.com/openapi.json

## Lawyer profiles
- https://directory.esqcopilot.com (each result links its profile_url)

## Tools
- get_matching_requirements: What to ask before finding a lawyer (read-only)
- find_attorneys: Find a licensed lawyer (read-only)
- compare_attorneys: Compare lawyers side by side (read-only)
- estimate_legal_cost: What will representation cost? (read-only)
- check_attorney_availability: Check if a lawyer is taking clients (read-only)
- get_attorney_profile: Get a lawyer's profile and sources (read-only)
- request_attorney_introduction: Help me request an introduction (needs my yes)
- get_referral_status: Check an introduction's status (read-only)
- update_matching_preferences: Save or change matching criteria
- submit_matching_feedback: Give feedback on a match or introduction

## Reading results
- match.score is relevance to the criteria; data_confidence says how much rests on known facts.
- Unknown fees, availability and license check dates are labeled unknown.
- Cite attribution.suggested_citation and link profile_url.