# andish-mcp

MCP server for the [Andish](https://andish.ru) Knowledge Graph API.

Works with any MCP-compatible client: Cursor, Cline, Continue, and others.

Full docs: https://andish.ru/docs

> Registry ownership verification:
> mcp-name: ru.andish/andish-mcp

## Install

```bash
uvx andish-mcp@latest
```

Or with pip:

```bash
pip install andish-mcp
```

## Configure

```jsonc
// example MCP client config (the exact file path depends on your client)
{
  "mcpServers": {
    "andish": {
      "command": "uvx",
      "args": ["andish-mcp@latest"],
      "env": {
        "ANDISH_API_KEY": "adsh_live_xxxxxxxxxxxx"
      }
    }
  }
}
```

## Available Tools

Nine tools are registered by the server.

| Tool | What it does |
|---|---|
| `andish_query` | Search the workspace knowledge graph and synthesise an answer. |
| `andish_context` | Fetch raw context from the knowledge graph and write the answer yourself. |
| `andish_list_documents` | List documents uploaded to the workspace. |
| `andish_get_document` | Fetch metadata and a content excerpt for one document. |
| `andish_upload_document` | Upload a local file to the workspace for indexing. |
| `andish_search_entities` | Search entities (people, organizations, concepts) by label substring. |
| `andish_get_neighbors` | Return entities connected to an entity, directly (hop=1) or transitively (hop=2). |
| `andish_workspace_usage` | Show current workspace usage: documents, cost, daily queries. |
| `andish_health` | Check server health and API connectivity. |

## Environment Variables

| Variable | Required | Default | Description |
|---|---|---|---|
| `ANDISH_API_KEY` | Yes | — | API key from https://andish.ru/dashboard |
| `ANDISH_BASE_URL` | No | `https://api.andish.ru/v1` | Override for self-hosted or staging |
| `ANDISH_TIMEOUT` | No | `30.0` | Per-request timeout in seconds |