v2.1.0 — per-stream Unity 6 databases + auto-updates

What's new

• Per-minor-stream Unity 6 databases: UNITY_VERSION now accepts streams like 6000.3 (and full versions like 6000.3.8f1 map to their stream). Each active stream gets its own weekly-rebuilt database; the generic 6 database remains as fallback and default.
• Automatic database updates: cached databases are freshness-checked against the release on startup and re-downloaded when a newer build is available — no reinstall needed.
• Weekly automated rebuilds: new Unity patch releases are detected every Monday and databases are rebuilt automatically per active stream.
• License: relicensed from PolyForm Noncommercial to MIT.
• macOS Unity installs are now supported for local ingestion (Unity.app/Contents/Resources/Scripting/Managed).

v2.0.2

README and metadata sync. No server changes.

v2.0.1 — MCP Registry support

• Added MCP Registry metadata (server.json) for publishing to registry.modelcontextprotocol.io
• Publish workflow now auto-publishes to both PyPI and MCP Registry on release
• No functional changes

v2.0.0 — Multi-version support (Unity 2022 / 2023 / 6)

What's new

Databases are no longer bundled in the wheel. Instead, the server downloads the correct database on first run based on your Unity version. The wheel is now lightweight (~50 KB instead of ~27 MB).

Multi-version support

• Unity 2022 LTS, 2023, and Unity 6 each have their own database
• Set UNITY_VERSION in your MCP config's env block: "2022", "2023", or "6"
• Or point UNITY_PROJECT_PATH at your project and the server reads ProjectVersion.txt automatically
• Defaults to Unity 6 if nothing is set

Database stats

Version	Records	Size
Unity 2022	32,000	18 MB
Unity 2023	31,387	18 MB
Unity 6	42,223	24 MB

Updated MCP config

{
  "mcpServers": {
    "unity-api": {
      "command": "unity-api-mcp",
      "args": [],
      "env": {
        "UNITY_VERSION": "2022"
      }
    }
  }
}

Breaking changes

• The wheel no longer ships a pre-built database. First run requires internet to download (~18-24 MB, cached at ~/.unity-api-mcp/).
• python -m unity_api_mcp.ingest now requires --unity-version.

New files

• version.py — version detection + on-demand database download

Install / upgrade

pip install --upgrade unity-api-mcp

v1.0.2

Search ranking fix — core Unity APIs now rank #1 for common queries.

• "Instantiate" → Object.Instantiate (was #4, now #1)
• "Physics Raycast" → Physics.Raycast (was #3, now #1)
• "SceneManager" → SceneManager type (was #2, now #1)
• Search top-1 accuracy: 80% → 100% on 12 common queries

Ranking uses BM25 with tuned column weights + core namespace boosting.

v1.0.1

• MIT license added
• Database expanded to 42,223 records (added UI/TMP, AI Navigation, Netcode packages)
• README rewritten with benchmarks, badges, collapsible sections
• pyproject.toml updated with full metadata

Install: pip install unity-api-mcp

v1.0.0

unity-api-mcp v1.0.0

MCP server providing ground-truth Unity 6 API documentation — prevents AI hallucination of signatures, namespaces, and deprecated APIs.

Features

• 5 tools: search_unity_api, get_method_signature, get_namespace, get_class_reference, get_deprecation_warnings
• Pre-built SQLite + FTS5 database (78K records, ~24 MB) — no Unity installation required
• Covers all UnityEngine/UnityEditor modules, Input System, Addressables

Install

pip install git+https://github.com/Codeturion/unity-api-mcp.git

Pre-built Databases

Pre-built SQLite databases for Unity API documentation. The server downloads the right one automatically on first run and keeps it fresh via a startup check.

Supported Versions

Unity version	Database	Built from	Size	Updated
Unity 6 (6000.5)	unity_docs_6000.5.db	6000.5.6f1	28 MB	2026-08-03
Unity 6 (6000.4)	unity_docs_6000.4.db	6000.4.12f1	24 MB	2026-07-19
Unity 6 (6000.3)	unity_docs_6000.3.db	6000.3.21f1	24 MB	2026-08-03
Unity 6 (6000.2)	unity_docs_6000.2.db	6000.2.15f1	22 MB	2026-07-19
Unity 6 (6000.0)	unity_docs_6000.0.db	6000.0.80f1	21 MB	2026-07-27
Unity 6 (default/fallback)	unity_docs_6.db	6000.3.21f1	24 MB	2026-08-03
Unity 2023	unity_docs_2023.db	2023.2 (EOL)	17 MB	2026-02-26
Unity 2022 LTS	unity_docs_2022.db	2022.3 (EOL)	17 MB	2026-02-26

Set UNITY_VERSION to a stream (6000.3), a full version (6000.3.8f1), or a legacy value (6, 2023, 2022). Streams fall back to the 6 database when no per-stream database exists.

Unity 6 databases are rebuilt automatically when new patches ship (weekly detection). _Last update: