@0xmonaco/mcp-server 0.0.0-develop-20260210160743 → 0.0.0-develop-20260220160207

package/README.md

@@ -0,0 +1,154 @@
+# @0xmonaco/mcp-server
+
+MCP server for the Monaco SDK — gives AI assistants full access to the Monaco protocol on Sei.
+
+## Configuration
+
+| Variable             | Required | Description                                |
+|----------------------|----------|--------------------------------------------|
+| `MONACO_PRIVATE_KEY` | Yes      | Wallet private key (`0x...`)               |
+| `MONACO_CLIENT_ID`   | Yes      | Monaco application client ID               |
+| `MONACO_NETWORK`     | No       | Network to connect to (default: `mainnet`) |
+| `MONACO_RPC_URL`     | Yes      | Sei RPC URL for blockchain interactions    |
+
+### Networks
+
+Set `MONACO_NETWORK` to one of the following:
+
+| Network             | API URL                         |
+|---------------------|---------------------------------|
+| `mainnet` (default) | `https://api.monaco.xyz`        |
+| `development`       | `https://develop.apimonaco.xyz` |
+| `staging`           | `https://staging.apimonaco.xyz` |
+| `local`             | `http://localhost:8080`         |
+
+## Installation
+
+### Cursor
+
+Add to your `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "monaco": {
+      "command": "npx",
+      "args": ["-y", "@0xmonaco/mcp-server"],
+      "env": {
+        "MONACO_PRIVATE_KEY": "0x...",
+        "MONACO_CLIENT_ID": "your-client-id",
+        "MONACO_RPC_URL": "https://evm-rpc.sei-apis.com"
+      }
+    }
+  }
+}
+```
+
+### Windsurf
+
+Add to your `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "monaco": {
+      "command": "npx",
+      "args": ["-y", "@0xmonaco/mcp-server"],
+      "env": {
+        "MONACO_PRIVATE_KEY": "0x...",
+        "MONACO_CLIENT_ID": "your-client-id",
+        "MONACO_RPC_URL": "https://evm-rpc.sei-apis.com"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "monaco": {
+      "command": "npx",
+      "args": ["-y", "@0xmonaco/mcp-server"],
+      "env": {
+        "MONACO_PRIVATE_KEY": "0x...",
+        "MONACO_CLIENT_ID": "your-client-id",
+        "MONACO_RPC_URL": "https://evm-rpc.sei-apis.com"
+      }
+    }
+  }
+}
+```
+
+To connect to a non-mainnet network, add `MONACO_NETWORK` to the `env` block with options: `mainnet`, `development`, `staging`, `local`. Use `https://evm-rpc-testnet.sei-apis.com` as the RPC URL for testnet networks.
+
+## Tools
+
+### Search (public)
+
+| Tool          | Description                     |
+|---------------|---------------------------------|
+| `search_docs` | Search the Monaco documentation |
+
+### Market (public)
+
+| Tool                         | Description                                |
+|------------------------------|--------------------------------------------|
+| `get_trading_pairs`          | List trading pairs with optional filters   |
+| `get_trading_pair_by_symbol` | Look up a pair by symbol (e.g. `BTC/USDC`) |
+| `get_candlesticks`           | OHLCV candlestick data                     |
+| `get_market_metadata`        | Tick size, min order size, trading rules   |
+
+### Orderbook (public)
+
+| Tool            | Description                               |
+|-----------------|-------------------------------------------|
+| `get_orderbook` | Current orderbook snapshot with bids/asks |
+
+### Trades (public)
+
+| Tool         | Description                  |
+|--------------|------------------------------|
+| `get_trades` | Historical trades for a pair |
+
+### Trading (authenticated)
+
+| Tool                      | Description              |
+|---------------------------|--------------------------|
+| `place_limit_order`       | Place a limit order      |
+| `place_market_order`      | Place a market order     |
+| `cancel_order`            | Cancel an order by ID    |
+| `batch_cancel_orders`     | Cancel multiple orders   |
+| `batch_cancel_all_orders` | Cancel all open orders   |
+| `replace_order`           | Modify an existing order |
+| `get_orders`              | List orders with filters |
+| `get_order`               | Get order details by ID  |
+
+### Profile (authenticated)
+
+| Tool                   | Description                             |
+|------------------------|-----------------------------------------|
+| `get_profile`          | User profile, balances, recent activity |
+| `get_balances`         | Token balances with pagination          |
+| `get_balance_by_asset` | Balance for a specific asset            |
+| `get_movements`        | Transaction history                     |
+
+### Fees (authenticated)
+
+| Tool            | Description                           |
+|-----------------|---------------------------------------|
+| `simulate_fees` | Simulate fees before placing an order |
+
+### Vault (authenticated + on-chain)
+
+| Tool                   | Description                    |
+|------------------------|--------------------------------|
+| `vault_approve`        | Approve vault to spend tokens  |
+| `vault_deposit`        | Deposit tokens into the vault  |
+| `vault_withdraw`       | Withdraw tokens from the vault |
+| `vault_get_allowance`  | Check current token allowance  |
+| `vault_needs_approval` | Check if approval is needed    |