## SDK Installation

The SDK can be installed with either [npm](https://www.npmjs.com/), [pnpm](https://pnpm.io/), [bun](https://bun.sh/) or [yarn](https://classic.yarnpkg.com/en/) package managers.

### NPM

```bash
npm add @moovio/sdk
```

### PNPM

```bash
pnpm add @moovio/sdk
```

### Bun

```bash
bun add @moovio/sdk
```

### Yarn

```bash
yarn add @moovio/sdk
```

### Model Context Protocol (MCP) Server

This SDK is also an installable MCP server where the various SDK methods are exposed as tools that can be invoked by AI applications.

> Node.js v20 or greater is required to run the MCP server from npm.

Claude installation steps

Add the following server definition to your `claude_desktop_config.json` file:

```json
{
  "mcpServers": {
    "Moov": {
      "command": "npx",
      "args": [
        "-y", "--package", "@moovio/sdk",
        "--",
        "mcp", "start",
        "--username", "...",
        "--password", "...",
        "--access-token", "..."
      ]
    }
  }
}
```

Cursor installation steps

Create a `.cursor/mcp.json` file in your project root with the following content:

You can also run MCP servers as a standalone binary with no additional dependencies. You must pull these binaries from available Github releases:

```bash
curl -L -o mcp-server \
    https://github.com/{org}/{repo}/releases/download/{tag}/mcp-server-bun-darwin-arm64 && \
chmod +x mcp-server
```

If the repo is a private repo you must add your Github PAT to download a release `-H "Authorization: Bearer {GITHUB_PAT}"`.

```json
{
  "mcpServers": {
    "Todos": {
      "command": "./DOWNLOAD/PATH/mcp-server",
      "args": [
        "start"
      ]
    }
  }
}
```

For a full list of server arguments, run:

```sh
npx -y --package @moovio/sdk -- mcp start --help
```
