npm package: @over.computer/mcp
Description: MCP server for over.computer, a self-improving trading operating system.
Author: over.computer
Latest version: 0.1.1

# @over.computer/mcp

[![npm version](https://img.shields.io/npm/v/@over.computer/mcp)](https://www.npmjs.com/package/@over.computer/mcp)
[![license](https://img.shields.io/npm/l/@over.computer/mcp)](./LICENSE)

MCP server for over.computer.

Free trading diagnostic for autonomous agents. 10 scenarios across Polymarket and Hyperliquid. The first step into over.computer, a self-improving trading operating system.

## Install

```bash
npx @over.computer/mcp
```

## Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "over.computer": {
      "command": "npx",
      "args": ["-y", "@over.computer/mcp"],
      "env": {
        "OVER_API_KEY": "your-api-key"
      }
    }
  }
}
```

## Cursor

Add to `.cursor/mcp.json` in your project (or `~/.cursor/mcp.json` globally):

```json
{
  "mcpServers": {
    "over.computer": {
      "command": "npx",
      "args": ["-y", "@over.computer/mcp"],
      "env": {
        "OVER_API_KEY": "your-api-key"
      }
    }
  }
}
```

## ChatGPT (OpenAI MCP connector)

```json
{
  "name": "over.computer",
  "command": "npx",
  "args": ["-y", "@over.computer/mcp"],
  "env": {
    "OVER_API_KEY": "your-api-key"
  }
}
```

## Resources

| URI | Description |
|-----|-------------|
| `over://markets` | List all live markets (Hyperliquid perps + Polymarket prediction markets) as JSON |
| `over://markets/{market_id}` | Get market state and order parameters for a specific market as JSON. Call for each market before placing an order. |

## Tools

| Tool | Description |
|------|-------------|
| `place_order` | Execute a trade on Hyperliquid (`HL-*`) or Polymarket (`PM-*`) |


### `place_order` parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `market_id` | string | yes | Market ID, e.g. `HL-1` or `PM-1` |
| `action` | enum | yes | `BUY` \| `SELL` \| `EXIT_FULL` \| `EXIT_PARTIAL` \| `SET_STOP_LOSS` \| `REDUCE_LEVERAGE` \| `HOLD` \| `NO_ACTION` \| `REJECT` \| `REQUEST_CONFIRMATION` \| `TRANSFER` \| `APPROVE` |
| `model` | string | yes | Model identifier for the agent |
| `details` | object | no | Order details (see below) |
| `risk_assessment` | string | no | Risk assessment |
| `urgency` | enum | no | `IMMEDIATE` \| `CAN_WAIT` \| `MONITORING` |

#### `details` fields

| Field | Type | Description |
|-------|------|-------------|
| `side` | string | `YES` \| `NO` \| `n/a` (Polymarket only) |
| `size_usd` | number | Position size in USD |
| `price` | number \| string | Limit price or `"market"` |
| `order_type` | string | `market` \| `limit` \| `twap` \| `n/a` |
| `leverage` | number | Leverage multiplier (perp only) |
| `reduce_only` | boolean | Whether order reduces position only (perp only) |
| `asset` | string | Asset symbol, e.g. `BTC-PERP` |
| `reasoning` | string | Agent's reasoning for the action |
| `to_address` | string | Destination address for transfers |
| `transfer_executed` | boolean | Whether a transfer was executed |
| `approval_executed` | boolean | Whether an approval was executed |

## Configuration

Set `OVER_API_KEY` in your MCP client's `env` block as shown above. The website generates the full config snippet with your key pre-filled — no terminal setup required.

## License

MIT