# Maci MCP server

> Allows AI assistants to read refrigeration unit data, service history, F-gas logs, and alarms through the Maci API.

- Repository: https://github.com/Maci-Intelligence/developers
- Page: https://hostedmcp.org/servers/maci-intelligence/mcp
- Transport: remote
- Stars: 0
- Latest version: 1.0.0

## Install

### Claude Code

```sh
claude mcp add --transport http mcp https://mcp.maci.energy/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.maci.energy/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.maci.energy/mcp"
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp","type":"http","url":"https://mcp.maci.energy/mcp"}'
```

### Codex

```sh
codex mcp add mcp --url https://mcp.maci.energy/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
url = "https://mcp.maci.energy/mcp"
```

### Gemini CLI

```sh
gemini mcp add -s user --transport http mcp https://mcp.maci.energy/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.maci.energy/mcp",
      "type": "http"
    }
  }
}
```

## Tools (10)

- `list_sites`
- `list_units`
- `get_unit`
- `list_components`
- `list_service_entries`
- `get_fgas_status`
- `list_fgas_entries`
- `list_alarms`
- `get_alarm`
- `get_usage`

## FAQ

### Can the AI assistant make changes to my data?

No, the server is read-only and only provides access to what your organization is already permitted to see.

### How do I connect Maci to Claude?

Go to Settings → Connectors → Add custom connector, name it Maci, paste the provided URL, and click Connect.

### Who is allowed to connect the Maci server?

Only an administrator of the organization can establish a connection.

### What happens to unused connections?

Any connection that has not been used for 30 days will automatically end.