# RealAgent MCP server

> Provides AI agents with SM2 cryptographic identity, real-name verification via QR codes, and SD-JWT verifiable credential generation.

- Repository: https://github.com/RedDateTech/RealAgentMCP
- Page: https://hostedmcp.org/servers/reddatetech/realagentmcp
- Transport: stdio
- Stars: 1
- Latest version: 0.4.0

## Install

### Claude Code

```sh
claude mcp add realagentmcp -- npx -y realagent-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "realagentmcp": {
      "command": "npx",
      "args": [
        "-y",
        "realagent-mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "realagentmcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "realagent-mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"realagentmcp","type":"stdio","command":"npx","args":["-y","realagent-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "realagentmcp": {
      "command": "npx",
      "args": [
        "-y",
        "realagent-mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add realagentmcp -- npx -y realagent-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.realagentmcp]
command = "npx"
args = ["-y", "realagent-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user realagentmcp npx -- -y realagent-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "realagentmcp": {
      "command": "npx",
      "args": [
        "-y",
        "realagent-mcp"
      ]
    }
  }
}
```

## Tools (14)

- `identity_link`
- `identity_status`
- `identity_revoke`
- `identity_vp`
- `identity_verify_vp`
- `vp_parse`
- `vc_info`
- `vc_raw`
- `key_info`
- `crypto_sign`
- `crypto_verify`
- `crypto_encrypt`
- `crypto_decrypt`
- `system_update`

## FAQ

### What are the main capabilities of RealAgent?

It provides SM2 keypair generation, QR-based real-name identity linking, SD-JWT verifiable presentation (VP) generation and verification, and SM4 encrypted storage.

### How do I configure the server for my agent?

You must provide a unique --agent-id for each agent in the MCP configuration to ensure each agent has its own unique SM2 identity.

### What are the system requirements for installation?

The server requires Node.js version 18.13 or higher.

### How is my private key and credential data secured?

Private keys and Verifiable Credentials (VC) are stored locally using SM4-CTR and SM3-HMAC encryption.
