Data Product
Chinese Legal Data
Court judgments, laws, citations, penalties, and semantic search across Chinese legal sources. 87M cases, 42K laws, 479M citations, 29.5M penalties.
MCP
Connect from any MCP-compatible agent (Claude Desktop, UcoWorker, Cursor, etc.). Create a UC Token, then add this config.
{
"mcpServers": {
"uc-cn-legal": {
"type": "streamable-http",
"url": "https://api.ucoworker.com/v1/data/cn-legal/mcp",
"headers": {
"Authorization": "Bearer ${UC_TOKEN}"
}
}
}
}MCP Tools
Case Search
semantic_search_cases
Natural language case search by meaning. Best for concept queries like contract breach, tort liability.
text_search_cases
Keyword (BM25) case search. Defaults to title; expand via fields parameter to reasoning, facts, verdict, or full_text.
browse
Explore cases by province, court, and year. Good for regional comparisons.
find_cases_by_law
Find all cases citing a specific law or article.
Case Reading
get_toc
Get the structure (table of contents) of a specific case.
read_section
Read a case section by section_id. Key sections: 0001 (metadata), 0002 (parties), 0003 (facts), 0004 (reasoning), 0005 (verdict), 0006 (appendix).
get_citations
Get all law citations referenced in a case.
resolve_citation
Resolve a citation string to structured law/article references.
co_citations
Find laws frequently co-cited with a given law article.
Law Search
text_search_laws
Keyword search across the law corpus.
semantic_search_laws
Semantic search for laws by meaning.
filter_laws
Filter laws by category, status, or issuing body.
get_law_toc
Get the table of contents of a specific law.
read_article
Read a specific article from a law.
text_search_articles
Keyword search within law articles.
semantic_search_articles
Semantic search within law articles.
law_at_date
Get the version of a law effective at a specific date.
get_law_versions
List all historical versions of a law.
Penalties
get_penalty
Get penalty guidelines for a specific offense.
semantic_search_penalties
Semantic search across penalty records.
text_search_penalties
Keyword search across penalty records.
Metadata
statistics
Aggregate statistics: case counts by year, court, region.
list_enums
List valid enum values for filters (case types, court levels, etc.).
Authentication
Two ways to authenticate: use your UC access_token (JWT from login), or create a dedicated UC Token in your dashboard for scripts and CI pipelines.
Bearer Token (JWT or UC Token)
# Using JWT (from login) Authorization: Bearer <your_access_token> # Using UC Token (from dashboard) Authorization: Bearer uc_sk_...
Rate Limits
Per-user sliding window rate limits protect availability. Each data product has independent counters. Limits reset every hour.
| Plan | Requests / Hour |
|---|---|
| Free | 100 |
| Pro | 10,000 |
| Higher limits | By request |
Response Headers
X-RateLimit-Limit: 10000 # Current hourly limit X-RateLimit-Remaining: 9542 # Requests left in current window X-RateLimit-Reset: 2847 # Seconds until window resets Retry-After: 2847 # Only on 429 responses
Check Your Usage
curl -H "Authorization: Bearer $UC_TOKEN" \ https://api.ucoworker.com/v1/data/cn-legal/rate-limit
Pricing
1 credit per call (MCP or REST)
Same credits you use for Cloud Agent
Free tier: 200 credits
This data product is in beta -- we'd love your feedback
Report data quality issues, request new endpoints, or share what works well. Submit up to 50 feedback items per day via the API.
curl -X POST https://api.ucoworker.com/v1/feedback/cn-legal \
-H "Authorization: Bearer $UC_TOKEN" \
-H "Content-Type: application/json" \
-d '{"content":"Describe the issue or suggestion","category":"data-quality"}'Categories: data-quality, missing-data, feature-request, general. Max 2,000 chars per submission.