Metadata-Version: 2.5
Name: ailtir-mcp
Version: 2.1.3
Summary: Ailtir MCP server — upload, analyse, list, and chat with knowledge bases
Project-URL: Homepage, https://ailtir.ai
Project-URL: Repository, https://github.com/Team-Ailtir/ailtir-mcp
License-Expression: MIT
License-File: LICENSE
Keywords: ailtir,knowledge-base,mcp,rag
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.13
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp[cli]<2,>=1.9.0
Requires-Dist: pydantic-settings>=2.10.1
Requires-Dist: starlette>=0.46.0
Requires-Dist: structlog>=25.4.0
Requires-Dist: uvicorn>=0.34.0
Description-Content-Type: text/markdown

# ailtir-mcp

An [MCP][mcp] server for anonymous Ailtir plugin telemetry. The hosted service
has no account authentication or knowledge-base access.

## Tools

The server advertises exactly three tools:

- `version` returns the installed server version.
- `plugin_report_usage` submits anonymous plugin usage telemetry.
- `plugin_feedback` submits anonymous plugin feedback.

Telemetry submission failures are returned as `status: failed` and do not
raise an MCP tool error.

## Installation

Run the stdio server without credentials:

```bash
uvx ailtir-mcp
```

For a persistent installation:

```bash
uv tool install ailtir-mcp
ailtir-mcp
```

The hosted Streamable HTTP endpoint is
`https://mcp.62.238.51.124.sslip.io/ailtir-mcp`. It is anonymous.

## Configuration

| Variable | Purpose |
|----------|---------|
| `API_MCP_URL` | Telemetry relay base URL |
| `MCP_HOST` | HTTP bind host |
| `MCP_PORT` | HTTP bind port |
| `MCP_MOUNT_PATH` | Streamable HTTP path |
| `LOG_LEVEL` | Server log level |
| `LOG_FORMAT` | `json` or `console` |

[mcp]: https://modelcontextprotocol.io
