# Aito

This MCP server connects Aito to AI assistants and coding agents for predictions, recommendations, search, and queries over your own data.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: AitoDotAI
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AitoDotAI/aito-python-tools/tree/HEAD/packaging/aito-mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/aito

## What it does

Aito exposes tools for `predict`, `recommend`, `relate`, `match`, `search`, `query`, `evaluate`, `get_schema`, `put_schema`, and `upload_rows`. Responses include `$p`, a probability that can be thresholded, and `$why`, which shows the supporting evidence. Tool descriptions also indicate when Aito fits and when a language model, trained model, or search engine is a better option.

The server runs with `uvx aito-mcp`. It locates an Aito instance through `AITO_URL` and `AITO_API_KEY`, or through the profile created by local `aito start`. It is read-only unless started with `AITO_MCP_ALLOW_WRITES=1`. Without `AITO_API_KEY`, it cannot connect to the Aito instance.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `AITO_URL`, `AITO_API_KEY`, `AITO_MCP_ALLOW_WRITES` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env AITO_URL=<AITO_URL> --env AITO_API_KEY=<AITO_API_KEY> --env AITO_MCP_ALLOW_WRITES=<AITO_MCP_ALLOW_WRITES> --transport stdio aito-mcp -- uvx aito-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from aito-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add aito-mcp --env AITO_URL=<AITO_URL> --env AITO_API_KEY=<AITO_API_KEY> --env AITO_MCP_ALLOW_WRITES=<AITO_MCP_ALLOW_WRITES> -- uvx aito-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from aito-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "aito-mcp": {
            "command": "uvx",
            "args": [
                "aito-mcp"
            ],
            "env": {
                "AITO_URL": "<AITO_URL>",
                "AITO_API_KEY": "<AITO_API_KEY>",
                "AITO_MCP_ALLOW_WRITES": "<AITO_MCP_ALLOW_WRITES>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from aito-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "aito-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "aito-mcp"
            ],
            "env": {
                "AITO_URL": "<AITO_URL>",
                "AITO_API_KEY": "<AITO_API_KEY>",
                "AITO_MCP_ALLOW_WRITES": "<AITO_MCP_ALLOW_WRITES>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from aito-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e AITO_URL=<AITO_URL> -e AITO_API_KEY=<AITO_API_KEY> -e AITO_MCP_ALLOW_WRITES=<AITO_MCP_ALLOW_WRITES> aito-mcp uvx aito-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from aito-mcp <command>

## When to use it
- generate predictions from Aito data
- recommend records or items
- find related and matching objects
- search and query stored data
- inspect schemas and upload rows

## Example prompts
- Use Aito to predict the outcome for this record, then show `$p` and `$why`.
- Create recommendations from the Aito data and explain the evidence behind each result.
- Inspect the Aito schema, then upload the rows from `data.csv`.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md