
devnorsai/devnors-data-mcp
Developer toolsUse Devnors Data in MCP clients such as Codex, Claude Desktop, Cursor, WorkBuddy, and other AI assistant tools.
Обзор
Use Devnors Data in MCP clients such as Codex, Claude Desktop, Cursor, WorkBuddy, and other AI assistant tools.
README
Devnors Data MCP Server
简体中文 | English
Use Devnors Data in MCP clients such as Codex, Claude Desktop, Cursor, WorkBuddy, and other AI assistant tools.
Devnors Data MCP helps your assistant discover available capabilities, inspect required parameters, and call legal / enterprise / content / research / express APIs with your Devnors Data API Key.
Supported Clients
You can use Devnors Data MCP with any MCP-compatible client that supports remote HTTP or local stdio servers, including:
- Codex
- Claude Desktop
- Cursor
- WorkBuddy
- Other MCP-compatible AI assistants
For Codex, add Devnors Data as a remote MCP server and use the Remote HTTP URL and Authorization header below.
Quick Start
Remote HTTP
Remote HTTP is the recommended way to use Devnors Data MCP. No local Python install is required.
{
"mcpServers": {
"devnors-data": {
"url": "https://data.devnors.com/mcp",
"headers": {
"Authorization": "Bearer devnors_sk_live_xxx"
}
}
}
}
Create an API Key in the developer console.
Local stdio
You can also run the MCP server locally after pip install devnors-mcp.
{
"mcpServers": {
"devnors-data": {
"command": "python",
"args": ["-m", "devnors_mcp.server"],
"env": {
"DEVNORS_API_KEY": "devnors_sk_live_xxx"
}
}
}
}
On Windows, client PATH often cannot find devnors-mcp. Prefer the python -m
form above, or set command to an absolute Python path.
Token
Use your Devnors Data API Key in one of these ways:
Authorization: Bearer devnors_sk_live_xxx
or, for local stdio:
DEVNORS_API_KEY=devnors_sk_live_xxx
Bearer … is the recommended Authorization format.
Optional private / self-hosted base URL for local stdio:
DEVNORS_DATA_BASE_URL=https://data.devnors.com
Things You Can Ask
Ask your MCP client naturally:
List available Devnors Data capabilities and required filters.
More examples:
Search Chinese legal judgment documents for private lending interest disputes.
Look up current PRC law articles about contract termination.
Get company registration details for this credit code.
Check whether this company is on the dishonest judgment debtor list.
Show today's Douyin hot rank.
Track this express parcel with company code and tracking number.
Search academic papers titled Attention Is All You Need.
Find scholars named Andrew Ng and open the top profile detail.
The API returned insufficient_balance. What should I do next?
The API returned rate_limited. Help me retry safely.
The assistant can call list_capabilities first, explain required parameters,
invoke the selected tool after you provide values, and help interpret common
error codes.
Tools
| Tool | Description |
|---|---|
list_capabilities |
Discover live domain/type, filters, fields, examples, errors |
legal_case_search |
Legal judgment documents |
legal_law_search |
Current law articles |
content_keyword_index |
Keyword traffic index (incl. SEM) |
content_suggest_list |
Suggest / autocomplete keywords (multi-platform) |
content_keyword_word |
Long-tail keyword mining |
content_wechat_index_v2 |
WeChat Index v2 (time series; billed per keyword) |
content_hot_rank |
Weibo / Douyin hot rank |
enterprise_company_detail_v2 |
Company registration details |
enterprise_annual_report_list |
Annual report list |
enterprise_annual_report_detail |
Annual report detail |
enterprise_account_open |
Bank account opening info |
enterprise_company_tag |
Company tags |
enterprise_same_legal_company |
Companies with the same legal representative |
enterprise_key_person |
Key persons |
enterprise_shareholder |
Shareholders |
enterprise_branch_org |
Branch organizations |
enterprise_industrial_commercial_change |
Industrial & commercial changes |
enterprise_taxpayer_basic |
Taxpayer basic info |
enterprise_tax_credit_level |
Tax credit level |
enterprise_tax_illegal |
Tax illegal records |
enterprise_tax_illegal_major |
Major tax illegal list |
enterprise_tax_illegal_major_detail |
Major tax illegal detail |
enterprise_operation_except |
Operation exception records |
enterprise_admin_punishment |
Administrative punishments |
enterprise_judgment_list |
Judgment document list |
enterprise_court_notice_list |
Court notice list |
enterprise_court_trial_list |
Court trial notice list |
enterprise_cases_info_list |
Case filing info list |
enterprise_termination_case_list |
Termination case list |
enterprise_serious_illegal |
Serious illegal records |
enterprise_exec_person |
Enforcement debtor |
enterprise_breach_of_trust |
Dishonest judgment debtor |
enterprise_listed_company |
Listed company info |
enterprise_listed_company_neeq |
Listed company info (NEEQ) |
cloud_express |
Express tracking |
cloud_express_com |
Express company code table |
cloud_web_search |
Web search |
cloud_invoice_ocr |
Invoice OCR |
research_paper_search |
Academic paper search |
research_patent_search |
Patent search |
research_journal_search |
Journal / conference search |
research_paper_detail |
Paper detail |
research_patent_detail |
Patent detail |
research_journal_detail |
Journal / conference detail |
research_scholar_search |
Scholar search |
research_scholar_detail |
Scholar detail |
data_query |
Unified entry for any domain + type |
Billing and Errors
Successful calls return units and request_id. Failures return structured
fields so the agent can self-correct:
code |
Meaning | retryable |
|---|---|---|
unauthorized |
Missing / invalid key | no |
insufficient_balance |
Need top-up | no |
rate_limited |
Rate limited | yes |
invalid_capability |
Bad domain/type | no |
not_implemented |
Planned capability | no |
unavailable / upstream_error |
Temporary failure | yes |
Retryable 429 / 5xx errors are retried by the underlying Python SDK with
bounded backoff. The MCP layer does not stack extra retries.
Related
- Python SDK: devnors-data-python
- Docs: https://data.devnors.com/docs
- Product site: https://data.devnors.com
License
MIT
Установка
This server does not publish a one-line install command.
Open the repository installation guideКонфигурация
{
"mcpServers": {
"devnors-data": {
"url": "https://data.devnors.com/mcp",
"headers": {
"Authorization": "Bearer devnors_sk_live_xxx"
}
}
}
}