{
  "markdown": "# dart-query\n\nMCP server for [Dart AI](https://dartai.com) task management, optimized for batch operations and minimal context usage.\n\nInstead of looping through tasks one-by-one (filling your context window with intermediate JSON), dart-query uses DartQL selectors and server-side batch operations to update hundreds of tasks in a single call. A 50-task update that would normally consume ~30K tokens takes ~200 tokens with zero context rot.\n\n## Quick Start\n\n### 1. Get Your Dart AI Token\n\nVisit https://app.dartai.com/?settings=account and copy your token (starts with `dsa_`).\n\n### 2. Configure MCP\n\n**npx (recommended)**\n\n```json\n{\n  \"mcpServers\": {\n    \"dart-query\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@standardbeagle/dart-query\"],\n      \"env\": {\n        \"DART_TOKEN\": \"dsa_your_token_here\"\n      }\n    }\n  }\n}\n```\n\n**SLOP-MCP (v0.10.0+)**\n\n```bash\nslop register dart-query \\\n  --command npx \\\n  --args \"-y\" \"@standardbeagle/dart-query\" \\\n  --env DART_TOKEN=dsa_your_token_here \\\n  --scope user\n```\n\n### 3. Verify\n\n```\ninfo({ level: \"overview\" })\n```\n\n### 4. Example: Batch Update\n\n```typescript\n// Preview first\nbatch_update_tasks({\n  selector: \"dartboard = 'Engineering' AND priority = 'high'\",\n  updates: { status: \"Doing\" },\n  dry_run: true\n})\n\n// Execute\nbatch_update_tasks({\n  selector: \"dartboard = 'Engineering' AND priority = 'high'\",\n  updates: { status: \"Doing\" },\n  dry_run: false\n})\n```\n\n## Tools\n\n| Group | Tools | Purpose |\n|-------|-------|---------|\n| Discovery | `info`, `get_config` | Explore capabilities, workspace config |\n| Task CRUD | `create_task`, `get_task`, `update_task`, `delete_task`, `add_task_comment` | Single task operations |\n| Query | `list_tasks`, `search_tasks` | Find tasks with filters or full-text search |\n| Batch | `batch_update_tasks`, `batch_delete_tasks`, `get_batch_status` | Bulk operations with DartQL selectors |\n| Import | `import_tasks_csv` | Bulk create from CSV with validation |\n| Docs | `list_docs`, `create_doc`, `get_doc`, `update_doc`, `delete_doc` | Document management |\n\nSee **[TOOLS.md](./TOOLS.md)** for full parameter references, DartQL syntax, and CSV import format.\n\n## DartQL Selectors\n\nSQL-92 WHERE clause syntax for targeting tasks in batch operations:\n\n```sql\ndartboard = 'Engineering' AND priority = 'high' AND tags CONTAINS 'bug'\ndue_at < '2026-01-18' AND status <> 'Done'\ntitle LIKE 'Task%'                          -- starts with\ntitle LIKE '%auth%'                         -- contains substring\n```\n\n**Operators:** `=`, `!=`, `<>`, `>`, `>=`, `<`, `<=`, `LIKE`, `IN`, `NOT IN`, `BETWEEN`, `IS NULL`, `IS NOT NULL`, `CONTAINS`\n**Aliases:** `INCLUDES`/`HAS` → `CONTAINS` · `<>` → `!=`\n**LIKE wildcards:** `%` = any characters, `_` = single character (case-insensitive)\n\n## Safety\n\nAll Dart AI operations are production (no sandbox). dart-query provides:\n\n- **Dry-run mode** on all batch operations — preview before executing\n- **Validation phase** for CSV imports — catch errors before creating anything\n- **Confirmation flag** (`confirm: true`) required for batch deletes\n- **Recoverable deletes** — tasks move to trash, not permanent deletion\n\n## License\n\nMIT\n",
  "bytes": 3155,
  "sha": "a0c1e32e969c61034114cf68acfe376b25003d63fc05015a0b71093876339481",
  "repo_slug": "standardbeagle/dart-query",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_standardbeagle_dart_query_880f925a/readme"
}