# Hevo MCP Server

An MCP (Model Context Protocol) server that exposes Hevo Data's pipeline API as tools for Claude Code and other MCP clients.

## What it does

Manage Hevo Data pipelines directly from Claude Code:

- `list_pipelines` — list all pipelines in your Hevo account
- `get_pipeline` — get details of a specific pipeline
- `create_pipeline` — create a new pipeline
- `enable_pipeline` — enable a pipeline
- `disable_pipeline` — disable a pipeline (optionally cancel active jobs)
- `resync_pipeline` — trigger a resync (optionally drop and reload)
- `update_pipeline_config` — update a pipeline's configuration
- `update_source_config` — update a pipeline's source configuration

## Status

`enable_pipeline`, `disable_pipeline`, and `resync_pipeline` are verified against Hevo's live API docs. `update_pipeline_config` and `update_source_config` have not yet been verified against live docs and may need adjustment. Test carefully before relying on these two in production.

## Setup

### 1. Get your Hevo API credentials

You'll need an API key and secret from your Hevo account, plus your region (`us`, `eu`, `in`, or `asia`).

### 2. Install and build

```bash
git clone https://github.com/felixjoy89hevo/hevo-mcp.git
cd hevo-mcp
npm install
npm run build
```

### 3. Register with Claude Code

```bash
claude mcp add hevo --scope user -- node /absolute/path/to/hevo-mcp/dist/index.js
```

Then set your credentials as environment variables in Claude Code's MCP config (see `.env.example` for the required variables):

- `HEVO_API_KEY`
- `HEVO_API_SECRET`
- `HEVO_REGION`

### 4. Restart Claude Code

After any config or code change, restart your Claude Code session fully. Reconnecting isn't enough.

## Requirements

- Node.js >= 18

## API Reference

Built against [Hevo's live API docs](https://edge-api-docs.hevodata.com/reference/get_api-v1-pipelines).

## License

MIT