Admin documentation
Estrado MCP connector
Mexican court dockets, court documents, official-gazette notices, SAT blacklists and sanctions lists for legal research and due diligence, over the Model Context Protocol. This page is for administrators connecting Estrado to an MCP client such as Harvey.
Connection
- MCP server URL
https://estrado.com.mx/mcp(Streamable HTTP, JSON responses, stateless)- Authentication
- OAuth 2.1 authorization code with PKCE (S256). Each user signs in to Estrado and approves the client.
- Discovery
https://estrado.com.mx/.well-known/oauth-protected-resource/mcp(RFC 9728) andhttps://estrado.com.mx/.well-known/oauth-authorization-server(RFC 8414). Unauthenticated requests get401with aWWW-Authenticateheader pointing to the resource metadata.- Client registration
- Dynamic client registration (RFC 7591) at
https://estrado.com.mx/register, or ask us for a pre-registered client. - Scope
estrado: use of the tools below on the user's own Estrado account.- Tokens
- Access tokens last 1 hour; refresh tokens 30 days and rotate on every use. Revocation endpoint:
https://estrado.com.mx/revoke. Users can also revoke a client from their dashboard (Aplicaciones conectadas); disconnecting the server in the client does not revoke tokens by itself. - Alternative
- Server-to-server integrations may use a Estrado API key as a bearer token instead of OAuth.
Tools
Read-only tools never change anything. The three tools marked writes only change the user's own case watchlist inside Estrado (no external effect); get_updates marks returned updates as seen.
| Tool | What it does | Access | Credits |
|---|---|---|---|
search_parties | Find court cases where a party's name matches. Returns one row per (case, matching party). | read-only | 2 |
find_case | Look up cases by expediente number (the same number exists in many courts; narrow with state/court). | read-only | 1 |
get_case | Full case record: court, parties and the timeline of published acuerdos (newest first). | read-only | 1 |
refresh_case | Fetch this case's latest history live from the court website (where the court supports it). | writes | 2 |
list_courts | List indexed courts (court_id, name, materia). Free. | read-only | 0 |
court_day | Everything one court published on one day (its lista de acuerdos). | read-only | 1 |
sat_check | Check SAT blacklists: Art. 69-B (EFOS, invoice mills) and Art. 69 (firmes, exigibles, no localizados…). | read-only | 1 |
sanctions_check | KYC screening in one call: OFAC SDN, SFP sanctioned/barred government suppliers, CNBV sanctions on | read-only | 1 |
dof_search | Search Diario Oficial de la Federación judicial notices (edictos, avisos judiciales). | read-only | 1 |
search_documents | Search court documents with case specifics: published rulings (versiones públicas), edictos (often state | read-only | 1 |
company_profile | One-call company due diligence: court cases grouped by role, most frequent counterparties, SAT list status | read-only | 3 |
related_entities | Entities that share court cases with this one, split into opponents and co-parties (same side). | read-only | 2 |
market_stats | Market intelligence: the most active litigants (e.g. which creditors sue most in CDMX mercantil). | read-only | 2 |
watch_case | Start tracking a case (or change its alert settings). New acuerdos show up in get_updates and get_alerts. Free. | writes | 0 |
unwatch_case | Stop tracking a case. Free. | writes | 0 |
list_watches | Cases you are tracking, with how many unseen acuerdos each has. Free. | read-only | 0 |
get_updates | New acuerdos on your watched cases since you last checked. | writes | 1 |
watch_name | Alert when this name appears as a party in a newly indexed case, or in a new edicto, remate or DOF | writes | 0 |
unwatch_name | Stop watching a name. Free. | writes | 0 |
list_name_watches | Names you are watching. Free. | read-only | 0 |
get_alerts | New alerts on watched cases and names: acuerdos tagged by event (with hearing dates and stated deadlines), | writes | 1 |
upcoming_hearings | Hearings, diligencias and auctions announced in acuerdos of your watched cases, soonest first. | read-only | 1 |
coverage | Which sources/states are indexed, their date ranges and health. Free. | read-only | 0 |
account | Your credit balance and per-tool prices. Free. | read-only | 0 |
Billing
Calls are metered in prepaid credits on the user's Estrado account. Credits are reserved before a call runs and refunded if it fails or the input is invalid. Each response includes credits_remaining.
Data and privacy
- Sources are official, public publications: state court bulletins and lists, the federal administrative and agrarian courts, the Diario Oficial de la Federación, SAT lists and sanctions lists (OFAC, SFP, CNBV). See coverage.
- Criminal matters are indexed (materia "penal"; a listing is not a conviction). Juvenile-justice and addiction-court matters are not indexed. Court redactions are respected. Emails and phone numbers that appear in publications are masked in every response.
- A name match is not proof of identity; results include a confidence score and homonym risk. No result does not prove absence of records.
- We log each call (tool, cost, time and query parameters) on the user's account for billing and abuse prevention. See the privacy notice.
Support
contacto@estrado.com.mx · Powered by Mossom Systems.