# For AI agents

SafeDeal checks counterparties in Kazakhstan by BIN, IIN or name. Connect the MCP server and an AI agent finds the company, checks it and explains what matters before a deal.

## What an agent can do

One check_company call verifies a counterparty before a deal: profile, risks with severity, taxes, arrests and courts, founders, public procurement. The other tools read any report block in full, check lists of BINs, put companies on monitoring and show the balance.

## Cost and access

Opening a new company spends one check, and reopening it within a month is free. Search, balance, history and monitoring events are free. Adding a company to monitoring opens it too if it is not open yet. A batch check spends one check per BIN and needs a Premium plan or an Enterprise volume, so the agent asks for confirmation first. Full data needs a paid plan, without one answers are limited.

## Sign-in

Claude, ChatGPT, Claude Code, Cursor, VS Code and Claude Desktop sign in through your SafeDeal account: press Allow, no key needed. For Claude Code, add the server without the --header flag and run /mcp. Alternatively pass the API key from your profile in the X-API-Key or Authorization: Bearer header.

## Connect

### claude.ai and ChatGPT

In Claude, open Settings, then Connectors, and add a custom connector with the server address. No key is needed: Claude opens SafeDeal, you sign in and press Allow.

In ChatGPT, turn on developer mode in the apps and connectors settings, create a connector with the server address and choose OAuth authentication. Then sign in to SafeDeal and press Allow.

Server address:

```
https://api.safedeal.kz/mcp
```

### Claude Code

Sign in with your account: add the server without a key, then run /mcp in Claude Code and sign in.

```
claude mcp add --transport http safedeal https://api.safedeal.kz/mcp
```

Or with an API key:

```
claude mcp add --transport http safedeal https://api.safedeal.kz/mcp \
  --header "X-API-Key: $SAFEDEAL_API_KEY"
```

### Cursor

Add to ~/.cursor/mcp.json:

```
{
  "mcpServers": {
    "safedeal": {
      "url": "https://api.safedeal.kz/mcp",
      "headers": {
        "X-API-Key": "your API key"
      }
    }
  }
}
```

Without the headers block Cursor opens the SafeDeal account sign-in.

### Claude Desktop

Add to claude_desktop_config.json:

```
{
  "mcpServers": {
    "safedeal": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.safedeal.kz/mcp",
        "--header",
        "X-API-Key:${SAFEDEAL_API_KEY}"
      ],
      "env": {
        "SAFEDEAL_API_KEY": "your API key"
      }
    }
  }
}
```

In Claude Desktop you can add the server as a custom connector in Settings, as in claude.ai. If you need a config file, remote servers connect through mcp-remote, which needs Node.js.

## Tools

### Search and check

Find a company by name or BIN and get a summary for the deal decision: risks, debts and arrests, taxes, court cases, state procurement.

- `search_companies`
- `check_company`

### Report sections

Every block of the company page, under the same names. The agent picks a block with the section parameter.

- `get_company_profile`: Summary · Leadership · Activities · Contacts · Branches · Employees · Change history · Media mentions
- `get_company_risks`: Risks
- `get_company_connections`: Founders · Affiliated companies · Company networks · Director's involvement in other legal entities · Similar companies
- `get_company_finances`: Tax payments · Financial statements · Bank accounts · Assets
- `get_company_legal`: Court cases · Enforcement proceedings · Arrests & encumbrances
- `get_company_permits`: Licenses and permits · Certificates · Accreditations
- `get_company_procurement`: Public contracts · Tender bids · What it sells and where · Procurement signals · Procurement as a customer · Samruk-Kazyna procurement

### Batch checks

Check a whole list of BINs, for example every counterparty of a client.

- `check_companies_batch`
- `get_batch_results`
- `list_batches`

### Monitoring

Put a company on monitoring and read what changed in it.

- `get_watchlist`
- `add_to_watchlist`
- `remove_from_watchlist`
- `get_watchlist_events`

### Account

Plan, checks left and companies already opened.

- `get_account`
- `get_opened_companies`

### Feedback

The agent tells us about wrong data or an awkward tool, and sends your own feedback when you ask. We reply to the account email.

- `send_feedback`

Ready-made MCP prompts: check_counterparty for a deal decision, due_diligence for a full report, feedback to write to us.

## A ready prompt

After the server is connected, ask the agent:

```
Use the SafeDeal MCP server (instructions: https://safedeal.kz/en/agents.txt). Check the company with BIN [paste the BIN] using check_company and briefly describe its risks, debts, arrests, court cases and public procurement. Before a batch check, tell me the cost and wait for my approval.
```

An agent acts for the owner of the account or key. The data may not be embedded in third-party products without an agreement with us: [Terms of Service](https://safedeal.kz/en/terms)

- This page as plain text: https://safedeal.kz/en/agents.txt
- Reference with the arguments of every tool: https://safedeal.kz/llms-full.txt