MCP 服务器

LTD MCP

MCP server that lets AI agents connect to LTD project workspaces to inspect project health, search and manage tasks, assign owners, and add comments, with scoped tokens and preview-confirm safety for writes.

README

LTD MCP

Project management MCP for AI agents.

LTD 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.

Status: early public preview. Read tools are available. Write tools use a two-step preview-confirm safety flow.

Why this exists

Most project management tools were built for humans clicking dashboards. AI agents need safe, structured tools.

LTD MCP is the agent-native interface for LTD, an anti-Jira-style project workspace for teams that want humans and AI agents operating together.

MCP endpoint

https://api.eshway.com/mcp/

Transport: Streamable HTTP / HTTP MCP

Authentication: Bearer token

Authorization: Bearer <LTD_API_TOKEN>

Capabilities

Read tools

ltd_list_projects - list projects the token can access
ltd_describe_project - describe statuses, custom fields, and members
ltd_search_tasks - search/filter tasks
ltd_get_task - fetch full task detail
ltd_my_tasks - list token owner's open tasks
ltd_get_comments - read task comments
ltd_project_pulse - project health rollups
ltd_analytics_query - analytics aggregations
ltd_drilldown_tasks - drill into analytics datapoints

Write tools

ltd_create_task - create a task
ltd_update_task - update fields on a task
ltd_add_comment - add a comment

Write tools are intentionally two-step:

mode="preview" returns the exact proposed change and a short-lived confirm token. Nothing is written.
mode="confirm" with the same arguments plus confirm_token performs the write.

Token scopes

Create an LTD API token from LTD Settings → API tokens.

Recommended scopes:

mcp:read for read-only project visibility
mcp:write for task creation, updates, assignment, and comments

Keep tokens secret. Revoke and rotate them from LTD settings when needed.

Quickstart

Generic MCP HTTP config

{
  "mcpServers": {
    "ltd": {
      "transport": "http",
      "url": "https://api.eshway.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${LTD_API_TOKEN}"
      }
    }
  }
}

Hermes

mcp add ltd --transport http \
  --url https://api.eshway.com/mcp/ \
  --header "Authorization: Bearer $LTD_API_TOKEN"

Smithery

smithery mcp add https://api.eshway.com/mcp/ --id ltd

Example prompts

Show me all LTD projects I can access.

Give me a project pulse for PS - Mini and list the top risks.

Create a low-priority test task in PS - Mini assigned to Eshu, but show me the preview before confirming.

Find stale tasks assigned to me, group them by status, and suggest next actions.

Safety model

LTD MCP is designed for human-controlled agent operations:

Scoped PATs limit access.
Read and write scopes are separate.
Write actions use preview-confirm.
Preview explicitly returns nothing_changed_yet: true.
Confirm tokens are short-lived and single-use.
Invalid assignees/statuses are rejected before write.

Example write flow

Preview:

{
  "project_id": 168,
  "title": "Test task created by ZERO",
  "description": "Verify LTD MCP task creation.",
  "status": "To Do",
  "assignees": ["Eshu"],
  "priority": "Low",
  "mode": "preview"
}

Confirm:

{
  "project_id": 168,
  "title": "Test task created by ZERO",
  "description": "Verify LTD MCP task creation.",
  "status": "To Do",
  "assignees": ["Eshu"],
  "priority": "Low",
  "mode": "confirm",
  "confirm_token": "<token from preview>"
}