{
  "markdown": "# LTD MCP\n\nProject management MCP for AI agents.\n\nLTD MCP lets AI agents connect to an LTD workspace over MCP and safely operate project work: inspect project health, search tasks, create tasks, update tasks, assign owners, and add comments using scoped API tokens and preview-confirm writes.\n\n> Status: early public preview. Read tools are available. Write tools use a two-step preview-confirm safety flow.\n\n## Why this exists\n\nMost project management tools were built for humans clicking dashboards. AI agents need safe, structured tools.\n\nLTD MCP is the agent-native interface for LTD, an anti-Jira-style project workspace for teams that want humans and AI agents operating together.\n\n## MCP endpoint\n\n```txt\nhttps://api.eshway.com/mcp/\n```\n\nTransport: Streamable HTTP / HTTP MCP\n\nAuthentication: Bearer token\n\n```txt\nAuthorization: Bearer <LTD_API_TOKEN>\n```\n\n## Capabilities\n\n### Read tools\n\n- `ltd_list_projects` - list projects the token can access\n- `ltd_describe_project` - describe statuses, custom fields, and members\n- `ltd_search_tasks` - search/filter tasks\n- `ltd_get_task` - fetch full task detail\n- `ltd_my_tasks` - list token owner's open tasks\n- `ltd_get_comments` - read task comments\n- `ltd_project_pulse` - project health rollups\n- `ltd_analytics_query` - analytics aggregations\n- `ltd_drilldown_tasks` - drill into analytics datapoints\n\n### Write tools\n\n- `ltd_create_task` - create a task\n- `ltd_update_task` - update fields on a task\n- `ltd_add_comment` - add a comment\n\nWrite tools are intentionally two-step:\n\n1. `mode=\"preview\"` returns the exact proposed change and a short-lived confirm token. Nothing is written.\n2. `mode=\"confirm\"` with the same arguments plus `confirm_token` performs the write.\n\n## Token scopes\n\nCreate an LTD API token from LTD Settings → API tokens.\n\nRecommended scopes:\n\n- `mcp:read` for read-only project visibility\n- `mcp:write` for task creation, updates, assignment, and comments\n\nKeep tokens secret. Revoke and rotate them from LTD settings when needed.\n\n## Quickstart\n\n### Generic MCP HTTP config\n\n```json\n{\n  \"mcpServers\": {\n    \"ltd\": {\n      \"transport\": \"http\",\n      \"url\": \"https://api.eshway.com/mcp/\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${LTD_API_TOKEN}\"\n      }\n    }\n  }\n}\n```\n\n### Hermes\n\n```bash\nmcp add ltd --transport http \\\n  --url https://api.eshway.com/mcp/ \\\n  --header \"Authorization: Bearer $LTD_API_TOKEN\"\n```\n\n### Smithery\n\n```bash\nsmithery mcp add https://api.eshway.com/mcp/ --id ltd\n```\n\n## Example prompts\n\n```txt\nShow me all LTD projects I can access.\n```\n\n```txt\nGive me a project pulse for PS - Mini and list the top risks.\n```\n\n```txt\nCreate a low-priority test task in PS - Mini assigned to Eshu, but show me the preview before confirming.\n```\n\n```txt\nFind stale tasks assigned to me, group them by status, and suggest next actions.\n```\n\n## Safety model\n\nLTD MCP is designed for human-controlled agent operations:\n\n- Scoped PATs limit access.\n- Read and write scopes are separate.\n- Write actions use preview-confirm.\n- Preview explicitly returns `nothing_changed_yet: true`.\n- Confirm tokens are short-lived and single-use.\n- Invalid assignees/statuses are rejected before write.\n\n## Example write flow\n\nPreview:\n\n```json\n{\n  \"project_id\": 168,\n  \"title\": \"Test task created by ZERO\",\n  \"description\": \"Verify LTD MCP task creation.\",\n  \"status\": \"To Do\",\n  \"assignees\": [\"Eshu\"],\n  \"priority\": \"Low\",\n  \"mode\": \"preview\"\n}\n```\n\nConfirm:\n\n```json\n{\n  \"project_id\": 168,\n  \"title\": \"Test task created by ZERO\",\n  \"description\": \"Verify LTD MCP task creation.\",\n  \"status\": \"To Do\",\n  \"assignees\": [\"Eshu\"],\n  \"priority\": \"Low\",\n  \"mode\": \"confirm\",\n  \"confirm_token\": \"<token from preview>\"\n}\n```\n\n## Supported clients\n\nAny MCP client that supports remote HTTP / Streamable HTTP MCP servers should work.\n\nPlanned docs:\n\n- Claude Desktop\n- Cursor\n- Cline\n- Windsurf\n- Hermes / ZERO\n- Smithery\n\n## Links\n\n- MCP endpoint: https://api.eshway.com/mcp/\n- Website: https://ltd.eshway.com/\n- Product: LTD by Eshway\n\n## Roadmap\n\n- Public hosted docs\n- Demo workspace\n- Client-specific setup guides\n- Official MCP Registry listing\n- Smithery listing\n- MCP.so listing\n- Audit log docs\n- OAuth support\n\n## License\n\nMIT for documentation and examples in this repository. LTD server implementation and hosted service are owned by Eshway.\n",
  "bytes": 4332,
  "sha": "a075d7137fb68e1844e0bdafe647cf63136d12da064fea74eb532f12dc701475",
  "repo_slug": "eshway/ltd-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_eshller_ltd_mcp_9a5522cf/readme"
}