ailtir-mcp 1.5.0

Ailtir MCP server — upload, analyse, list, and chat with knowledge bases

ailtir-mcp

An MCP server that gives Claude direct access to Ailtir's Knowledge Base platform. Upload documents, build a Bedrock-powered knowledge base, and run RAG chat — all from within your AI assistant.

Prerequisites

• Python 3.13+ (or uv — no separate Python install needed with uvx)
• An Ailtir account
• An AILTIR_MCP_API_TOKEN — copy your MCP Key from the Ailtir app (see Getting your secret)

Installation

uvx runs the server in an isolated environment with no install step — it is the recommended approach. You need uv installed (curl -LsSf https://astral.sh/uv/install.sh | sh).

Claude Code

claude mcp add ailtir uvx ailtir-mcp \
  -e AILTIR_MCP_API_TOKEN=your-secret-here

Or add manually to .claude/settings.json:

{
  "mcpServers": {
    "ailtir": {
      "command": "uvx",
      "args": ["ailtir-mcp"],
      "env": {
        "AILTIR_MCP_API_TOKEN": "your-secret-here"
      }
    }
  }
}

Claude Desktop

Add the following to your claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

{
  "mcpServers": {
    "ailtir": {
      "command": "uvx",
      "args": ["ailtir-mcp"],
      "env": {
        "AILTIR_MCP_API_TOKEN": "your-secret-here"
      }
    }
  }
}

Replace your-secret-here with the secret you copied in Step 1, then restart Claude Desktop.

Persistent install (optional)

If you prefer ailtir-mcp installed as a persistent global tool:

uv tool install ailtir-mcp

Then use ailtir-mcp as the command instead of uvx ailtir-mcp. pip install is not recommended — it installs into the active Python environment and can cause dependency conflicts.

Tools

Once connected, your AI assistant has access to the following four tools.

upload

Uploads a ZIP archive of documents to Ailtir storage and returns a kb_id.

upload(file_path: string) → kb_id: string

Parameter	Description
file_path	Absolute path to the ZIP file on your local machine, e.g. /Users/alice/docs/tender.zip

Returns a kb_id that you pass to analyse, list, and chat.

---

analyse

Unzips the uploaded archive and builds an AWS Bedrock Knowledge Base from its contents. Triggers the full ingestion pipeline — this typically takes a few minutes.

analyse(kb_id: string) → status: string

Parameter	Description
kb_id	The ID returned by upload

---

list

Lists all knowledge bases associated with your Ailtir account.

list() → string

Returns a formatted list of knowledge bases, each showing name, kb_id, and status (e.g. ready, analysing, failed).

---

chat

Asks a question answered using documents in a given knowledge base (retrieval-augmented generation via AWS Bedrock).

chat(kb_id: string, question: string) → answer: string

Parameter	Description
kb_id	The knowledge base to query
question	Your natural-language question

Getting your secret

1. Sign in to the Ailtir app
2. Click your avatar or name to open the Account page
3. Find the Secrets cell and click Reveal
4. Copy the MCP Key — it starts with amcp_
5. Paste it as AILTIR_MCP_API_TOKEN in your client config (see Installation)

Links

• Ailtir
• MCP specification
• uv
• Claude Desktop
• mcp-api service (the backend this server talks to)