# Lenx MCP Server

MCP server bridging AI agents to the [Lenx.ai](https://lenx.ai) social media monitoring API.

## Installation

Run directly via npx (no local installation required):

```bash
npx @fastaai/lenx-mcp
```

Or install globally:

```bash
npm install -g @fastaai/lenx-mcp
lenx-mcp
```

## Configuration

The server requires two environment variables:

| Variable | Required | Description |
|----------|----------|-------------|
| `LENX_API_KEY` | Yes | Your Lenx API key |
| `LENX_USER_ID` | Yes | Your Lenx user ID |
| `LENX_BASE_URL` | No | API base URL (default: `https://open.lenx.ai`) |

### Claude Code

Add to your Claude Code MCP configuration:

```json
{
  "mcpServers": {
    "lenx": {
      "command": "npx",
      "args": ["-y", "@fastaai/lenx-mcp"],
      "env": {
        "LENX_API_KEY": "your-api-key",
        "LENX_USER_ID": "your-user-id",
        "LENX_BASE_URL": "https://open.lenx.ai"
      }
    }
  }
}
```

### OpenCode

Add to your `~/.config/opencode/opencode.json`:

```json
{
  "mcpServers": {
    "lenx": {
      "command": "npx",
      "args": ["-y", "@fastaai/lenx-mcp"],
      "env": {
        "LENX_API_KEY": "your-api-key",
        "LENX_USER_ID": "your-user-id"
      }
    }
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `lenx_list_tasks` | List monitoring tasks with pagination |
| `lenx_get_task` | Get task details by ID |
| `lenx_create_task` | Create a live or adhoc task via a guided confirmation wizard (requires elicitation) |
| `lenx_update_task` | Update a task's name, search query, or prompts via a guided confirmation wizard (requires elicitation) |
| `lenx_delete_task` | Delete a task after explicit confirmation (requires elicitation) |
| `lenx_get_task_data` | Get paginated post data for a task |
| `lenx_export_task_data` | Request CSV/XLSX export via email |
| `lenx_trigger_task_fetch` | Trigger an async data fetch for a task |

> **Note:** `lenx_create_task`, `lenx_update_task`, and `lenx_delete_task` are interactive wizards that collect their input through MCP elicitation forms and require explicit confirmation before applying changes. The client must support elicitation; these tools will not work otherwise.

## Development

```bash
# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Watch mode
npm run watch
```

## License

MIT