# Zils

> Zils is a freemium MCP server for ai models and llm tooling. Train a small custom decision model on your examples and call it through an API. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API, Web
- **Website:** https://zils.ai
- **MCP Registry name:** ai.zils/zils
- **Categories:** AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

Zils turns a set of checked examples into a small model for one repeatable decision, such as which team should handle a message, whether something needs review, or how well a product fits a request. It also ranks 2 to 10 options against a criterion and returns an ordered list with relative scores, which the site says are not confidence percentages.

You supply examples in a spreadsheet; Zils trains, evaluates on held-out examples, shows the mistakes and hosts accepted models behind an API. The site reports one research experiment: on 500 test conversations from the public ABCD dataset its model chose the recorded next action 79.2% of the time versus 70.6% for another decision model, and it notes this is not a guarantee for your task.

A data caution applies. On the free open tier, Zils network miners receive the training examples and are asked to delete them within 7 days, which Zils cannot verify; private runs use only Zils workers. The registry entry lists a stdio npm package, @zils/cli. Beta pricing is planned at $0.20 per million training tokens and $0.06 per million input tokens, with checkout not yet open.

## Features

- **Decision models:** Trains a model for sorting, flagging or scoring from your examples.
- **Option ranking:** Orders 2 to 10 options against a criterion, with optional grouped ranking.
- **Held-out evaluation:** Shows performance on examples kept out of training, including mistakes.
- **Hosted API:** Hosts accepted models and returns answers through an API call.
- **Open or private runs:** Lets you choose whether network miners or only Zils workers train the model.
- **CLI package:** Ships as the @zils/cli npm package over stdio.

## Good for

- Route support messages to the right team
- Flag items that need human review
- Score how well a result fits a query
- Rank candidate actions for a customer issue

## Install

### Claude Code (Terminal)

```sh
claude mcp add zils -- npx -y @zils/cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "zils": {
      "command": "npx",
      "args": [
        "-y",
        "@zils/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "zils": {
      "command": "npx",
      "args": [
        "-y",
        "@zils/cli"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "zils": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@zils/cli"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "zils": {
      "command": "npx",
      "args": [
        "-y",
        "@zils/cli"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "zils": {
      "command": "npx",
      "args": [
        "-y",
        "@zils/cli"
      ]
    }
  }
}
```

## FAQ

### What data does it need?

Examples of decisions you already know how to make, paired with the right answers.

### Who sees my training data?

On the open tier network miners receive it; private runs are trained only by Zils workers.

### How much does it cost?

Planned beta rates are $0.20 per million training tokens and $0.06 per million input tokens; open-tier training is free, up to 3 runs a day.

### Can I pay now?

Not yet; the pricing page says checkout and usage billing are not open.

### Does a trained model always pass?

No. Training does not guarantee a model that meets your quality requirements.

### Is Zils free?

Zils has a free plan, with paid plans for more usage or features.

### How do I add Zils to Claude Code?

Run this command in your terminal: claude mcp add zils -- npx -y @zils/cli

### What are the best alternatives to Zils?

The closest alternatives to Zils are Claude Code Ultimate Guide, signafAIde, Toolkien, Lugh and HypePaper.

## Alternatives

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.
- [Toolkien](https://ai-powered.com/mcp/toolkien): Toolkien is an open-source MCP server for ai models and llm tooling.
- [Lugh](https://ai-powered.com/mcp/lugh): Lugh is an open-source MCP server for ai models and llm tooling.
- [HypePaper](https://ai-powered.com/mcp/hypepaper): HypePaper is a freemium MCP server for ai models and llm tooling.
- [Agent Data Tools: Compact (find, describe, run)](https://ai-powered.com/mcp/agent-data-tools-compact-find-describe-run): Agent Data Tools: Compact (find, describe, run) is a freemium MCP server for developer tools.
- [Angel Agent Guard: pre-purchase check + prompt-injection scan](https://ai-powered.com/mcp/angel-agent-guard-pre-purchase-check-prompt-injection-scan): Angel Agent Guard: pre-purchase check + prompt-injection scan is a freemium MCP server for ai models and llm tooling.
- [Mizan Calibration](https://ai-powered.com/mcp/mizan-calibration): Mizan Calibration is a free MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/zils
