# @doti-protocol/mcp

Official **Model Context Protocol (MCP)** Server for **DotI (.i)** Web3 Identity & Multichain Domain Resolution.

Connect your AI assistants (**Claude Desktop**, **Cursor**, **Windsurf**, **Cline**, **Zed**) directly to the DotI on-chain protocol on Arbitrum One and multichain ecosystem.

[![npm version](https://img.shields.io/npm/v/@doti-protocol/mcp.svg?color=blue)](https://www.npmjs.com/package/@doti-protocol/mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)

---

## ⚡ Quickstart

You can run the DotI MCP server instantly without manual installation:

```bash
npx -y @doti-protocol/mcp
```

---

## 🤖 Configuration for AI Tools

### 1. 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": {
    "doti": {
      "command": "npx",
      "args": ["-y", "@doti-protocol/mcp"]
    }
  }
}
```

### 2. Cursor IDE
1. Go to **Cursor Settings** -> **Features** -> **MCP**.
2. Click **+ Add New MCP Server**.
3. Set:
   - **Name:** `doti`
   - **Type:** `command`
   - **Command:** `npx -y @doti-protocol/mcp`

---

## 🛠️ Available AI Tools

| Tool | Description |
| :--- | :--- |
| `resolve_doti_name` | Resolves a `.i` domain name (e.g. `alex.i`) to its EVM wallet address and metadata. |
| `lookup_doti_address` | Reverse lookup: Finds the primary `.i` domain attached to any `0x...` wallet address. |
| `get_doti_records` | Fetches decentralized profile records (`avatar`, `twitter`, `github`, `email`, `bio`). |
| `check_doti_availability` | Checks whether a `.i` domain is available to register. |
| `get_doti_multicoin_address` | Retrieves chain-specific addresses (`Arbitrum`, `Optimism`, `Ethereum`, `Robinhood`). |

---

## 💬 Example AI Prompts

Once configured, you can ask Claude or Cursor natural questions:
- *"Who owns `alex.i` and what is their Ethereum and Arbitrum address?"*
- *"Check if `satoshina.i` is available to register on DotI."*
- *"What is the Twitter and Avatar of `solpadart.i`?"*
- *"What is the primary Web3 username for address `0xf853F8243F10a57CF5e43A49F156F132c05C21a6`?"*

---

## 📜 License
MIT © [DotI Protocol](https://doti.my)