Meta Agent Tools
PT

Back to the catalog

LTD MCP

Project management MCP for AI agents with safe task reads and writes.

Open source Repository Open in the app JSON README (API)

About

Project management MCP for AI agents with safe task reads and writes.

Details

Kind
MCP servers
Topic
Productivity
Publisher
eshller
Origin
official
Category
ferramentas
Transport
http
Version
0.1.0
Stars
2
Last push
2026-08-12T17:06:50Z
Repository state
ativo
License
MIT
Added
2026-08-29 03:01:50
Updated
2026-08-29 03:01:50
Origin id
io.github.Eshller/ltd-mcp

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

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

Transport: Streamable HTTP / HTTP MCP

Authentication: Bearer token

```txt
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:

1. `mode="preview"` returns the exact proposed change and a short-lived confirm token. Nothing is written.
2. `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

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

### Hermes

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

### Smithery

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

## Example prompts

```txt
Show me all LTD projects I can access.
```

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

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

```txt
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:

```json
{
  "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:

```json
{
  "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>"
}
```

## Supported clients

Any MCP client that supports remote HTTP / Streamable HTTP MCP servers should work.

Planned docs:

- Claude Desktop
- Cursor
- Cline
- Windsurf
- Hermes / ZERO
- Smithery

## Links

- MCP endpoint: https://api.eshway.com/mcp/
- Website: https://ltd.eshway.com/
- Product: LTD by Eshway

## Roadmap

- Public hosted docs
- Demo workspace
- Client-specific setup guides
- Official MCP Registry listing
- Smithery listing
- MCP.so listing
- Audit log docs
- OAuth support

## License

MIT for documentation and examples in this repository. LTD server implementation and hosted service are owned by Eshway.

More