newdb
Official# NewDB MCP Server
[](https://smithery.ai/server/@newdb-api/newdb-mcp-server)
[](https://www.npmjs.com/package/@newdb/mcp-server)
[](https://opensource.org/licenses/MIT)
Official [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for [NewDB REST API](https://newdb.net) — connecting LLM agents (Claude Desktop, Cursor, Antigravity, ChatGPT) with Russian and CIS legal entity verification, individuals KYC, passport validation, FSSP debts, tax liens, bankruptcy, and court registries.
---
## Tools Exposed to LLM
* `newdb_check_passport_mvd` — Check Russian internal passport validity via official MVD database.
* `newdb_check_fssp` — Check debts, enforcement proceedings, and bailiff cases for physical persons.
* `newdb_check_egrul` — Get official company registry data, founders, director, authorized capital, status (FNS).
* `newdb_check_fns_block` — Check bank account suspension decisions by Russian Tax Service (BIKP).
* `newdb_check_bankrot` — Check bankruptcy records for physical persons or legal entities (Fedresurs).
* `newdb_complex_check_person` — Complete citizen background check by passport (FNS, MVD, FSSP, Fedresurs, Courts, Pledge).
* `newdb_complex_check_company` — Complete company background check by INN (EGRUL, FNS, Arbitration, Bankruptcy, FSSP).
* `newdb_get_balance` — Check remaining request balance on your NewDB token.
---
## Installation & Quickstart
### 1. Running with Smithery (Recommended)
To automatically install for Claude Desktop or Cursor using [Smithery](https://smithery.ai/server/@newdb-api/newdb-mcp-server):
```bash
npx -y @smithery/cli install @newdb-api/newdb-mcp-server --client claude
```
---
### 2. Configuration for Claude Desktop
Add this to your `claude_desktop_config.json`:
**MacOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"newdb": {
"command": "npx",
"args": ["-y", "@newdb/mcp-server"],
"env": {
"NEWDB_API_KEY": "YOUR_NEWDB_API_KEY"
}
}
}
}
```
---
### 3. Configuration for Cursor IDE
In Cursor Settings ➔ Features ➔ **MCP Servers** ➔ **Add New MCP Server**:
* **Name:** `newdb`
* **Type:** `command`
* **Command:** `npx -y @newdb/mcp-server`
* **Environment Variable:** `NEWDB_API_KEY=YOUR_NEWDB_API_KEY`
---
## Environment Variables
| Variable | Required | Description |
| :--- | :--- | :--- |
| `NEWDB_API_KEY` | **Yes** | Your API token from [NewDB](https://newdb.net). Request from access@newdb.net |
| `NEWDB_API_BASE_URL` | No | Default: `https://api.newdb.net/v2` |
---
## License
MIT © [NewDB Team](https://newdb.net)
TDQS
Scored across 8 tools
Most tools target distinct registries: bankruptcy, passport, FSSP, EGRUL, and FNS block checking are clearly scoped. The two complex_check tools intentionally overlap these simple checks, but their names and descriptions make the aggregation purpose obvious, so an agent should rarely select the wrong one.
All tools follow a consistent `newdb_<verb>_<target>` pattern, using `check_` for registry lookups and `get_` only for the plainly different balance operation. Prefixes and underscore separators are uniform, making the tool names predictable and easy to navigate.
Eight tools is a well-scoped set for a registry-checking server: enough specific checks to cover major resources without overwhelming an agent. Each tool earns its place, especially the two aggregate checks that reduce the need to invoke many simple checks manually.
The set covers the core domain well: person checks, legal entity checks, debt/bankruptcy/account-block checks, and an aggregate version for each side. It is missing some standalone variants such as a direct court-case-only check or simple INN lookup, but those are bundled into the complex checks, so the main workflows are still supported.