Describe the bug
The MCP cognify_status tool is non-functional in API mode (cognee-mcp launched with --api-url, i.e. the MCP container/process talks to a remote cognee FastAPI server rather than a co-located local install).
- On
main it returns ❌ Pipeline status is not available in API mode.
- On the released
cognee-mcp 0.5.4 it crashes outright with sqlite3.OperationalError: unable to open database file.
Either way, there is no way to check cognify pipeline status when the MCP runs against a remote server — which is the standard Docker-Compose / separate-backend deployment.
Root cause
cognify_status depends on a local cognee install even in API mode:
-
cognee-mcp/src/server.py → cognify_status() resolves the dataset via get_default_user() / get_unique_dataset_id(), which read the local relational DB (SQLite). In API mode that DB does not exist in the MCP process → sqlite3.OperationalError (0.5.4), and on main the function simply short-circuits with "not available in API mode".
-
cognee-mcp/src/cognee_client.py → get_pipeline_status() still hard-stops in API mode:
if self.use_api:
# Note: This would need a custom endpoint on the API side
raise NotImplementedError("Pipeline status is not available via API")
The "custom endpoint" the comment asks for already exists: GET /api/v1/datasets/status?dataset=<dataset_id> returns {dataset_id: PipelineRunStatus} (verified live against a 1.x server, e.g. {"9e74...": "DATASET_PROCESSING_STARTED"}).
This was already fixed once — the fix was dropped
Net result: the dedicated fix never landed, and main still has raise NotImplementedError(...) today.
To reproduce
- Run a cognee FastAPI server (e.g. via Docker) reachable at
http://<host>:8000.
- Launch the MCP in API mode:
cognee-mcp --transport stdio --api-url http://<host>:8000.
- Call the
cognify_status tool (any dataset_name).
Expected: the current cognify pipeline status for the dataset.
Actual: ❌ Pipeline status is not available in API mode (main) / sqlite3.OperationalError: unable to open database file (0.5.4).
Environment
cognee-mcp 0.5.4 (and main as of 2026-06-14)
- API mode (
--api-url) against a remote cognee 1.x server
Proposed fix
In API mode, resolve the dataset id via cognee_client.list_datasets() (HTTP) and have get_pipeline_status() call GET /api/v1/datasets/status. PR follows.
Describe the bug
The MCP
cognify_statustool is non-functional in API mode (cognee-mcplaunched with--api-url, i.e. the MCP container/process talks to a remote cognee FastAPI server rather than a co-located local install).mainit returns❌ Pipeline status is not available in API mode.cognee-mcp0.5.4 it crashes outright withsqlite3.OperationalError: unable to open database file.Either way, there is no way to check cognify pipeline status when the MCP runs against a remote server — which is the standard Docker-Compose / separate-backend deployment.
Root cause
cognify_statusdepends on a local cognee install even in API mode:cognee-mcp/src/server.py→cognify_status()resolves the dataset viaget_default_user()/get_unique_dataset_id(), which read the local relational DB (SQLite). In API mode that DB does not exist in the MCP process →sqlite3.OperationalError(0.5.4), and onmainthe function simply short-circuits with "not available in API mode".cognee-mcp/src/cognee_client.py→get_pipeline_status()still hard-stops in API mode:The "custom endpoint" the comment asks for already exists:
GET /api/v1/datasets/status?dataset=<dataset_id>returns{dataset_id: PipelineRunStatus}(verified live against a 1.x server, e.g.{"9e74...": "DATASET_PROCESSING_STARTED"}).This was already fixed once — the fix was dropped
fix(mcp): cognify_status works in API mode via REST endpoint) implemented exactly this fix (resolve id vialist_datasets()over HTTP, then callGET /api/v1/datasets/status). It was closed unmerged (2026-04-05), ~2 minutes after feat(mcp): add dataset support to cognify, search, and status tools #2459 merged.feat(mcp): add dataset support to cognify, search, and status tools) added thedataset_name/pipelinesparameters but did not carry the API-mode REST fix.Net result: the dedicated fix never landed, and
mainstill hasraise NotImplementedError(...)today.To reproduce
http://<host>:8000.cognee-mcp --transport stdio --api-url http://<host>:8000.cognify_statustool (anydataset_name).Expected: the current cognify pipeline status for the dataset.
Actual:
❌ Pipeline status is not available in API mode(main) /sqlite3.OperationalError: unable to open database file(0.5.4).Environment
cognee-mcp0.5.4 (andmainas of 2026-06-14)--api-url) against a remote cognee 1.x serverProposed fix
In API mode, resolve the dataset id via
cognee_client.list_datasets()(HTTP) and haveget_pipeline_status()callGET /api/v1/datasets/status. PR follows.