qodflow-mcp 0.1.1 → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +12 -10
- package/dist/index.js +10 -6
- package/package.json +22 -3
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 QodFlow
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,16 +1,18 @@
|
|
|
1
|
-
#
|
|
1
|
+
# qodflow-mcp
|
|
2
2
|
|
|
3
|
-
Model Context Protocol (MCP) server for QodFlow.
|
|
3
|
+
Model Context Protocol (MCP) server for [QodFlow](https://www.qodflow.com), a kanban board with SLA tracking that people and AI agents share. Lets Claude Code, Claude Desktop, Cursor and other MCP clients create, move, assign and report on jobs through a scoped, revocable Personal Access Token.
|
|
4
4
|
|
|
5
5
|
## Install
|
|
6
6
|
|
|
7
7
|
```bash
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
8
|
+
# Claude Code
|
|
9
|
+
claude mcp add qodflow -- npx qodflow-mcp
|
|
10
|
+
export QODFLOW_API_TOKEN=qf_live_…
|
|
11
11
|
```
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
Any other MCP client: run `npx qodflow-mcp` as the server command with `QODFLOW_API_TOKEN` in its environment (see below). Full guide: https://www.qodflow.com/docs/mcp
|
|
14
|
+
|
|
15
|
+
To build from source instead, run `npm install` then `npm run build` inside `mcp-server/`; the binary is `qodflow-mcp`.
|
|
14
16
|
|
|
15
17
|
## Configure your agent
|
|
16
18
|
|
|
@@ -20,8 +22,8 @@ The binary is exposed as `qodflow-mcp`.
|
|
|
20
22
|
{
|
|
21
23
|
"mcpServers": {
|
|
22
24
|
"qodflow": {
|
|
23
|
-
"command": "
|
|
24
|
-
"args": ["
|
|
25
|
+
"command": "npx",
|
|
26
|
+
"args": ["qodflow-mcp"],
|
|
25
27
|
"env": {
|
|
26
28
|
"QODFLOW_API_TOKEN": "qf_live_xxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxx"
|
|
27
29
|
}
|
|
@@ -54,7 +56,7 @@ For integration testing, toggle **Test mode** at token creation; the prefix beco
|
|
|
54
56
|
| `create_job` | `jobs:write` | any\* | Create a job in the first (or given) stage. |
|
|
55
57
|
| `update_job` | `jobs:write` | any\* | Update title, description, priority, PO number. |
|
|
56
58
|
| `move_job` | `jobs:write` | any | Move a job to another stage. |
|
|
57
|
-
| `assign_job` | `mcp:assign` |
|
|
59
|
+
| `assign_job` | `mcp:assign` | any | Assign a job to a member (or `null` to unassign). |
|
|
58
60
|
| `create_tag` | `tags:write` | PREMIUM+ | Create a tag. |
|
|
59
61
|
| `update_stage` | `stages:write` | any\* | Rename a stage, change SLA/color. |
|
|
60
62
|
| `claim_job` / `release_job` | `mcp:claim` | any | Atomically claim/release a job (lease-based). |
|
|
@@ -64,7 +66,7 @@ For integration testing, toggle **Test mode** at token creation; the prefix beco
|
|
|
64
66
|
| `attach_evidence` | `mcp:evidence` | any | Attach a note (+ optional URL) as evidence. |
|
|
65
67
|
| `get_timeline` / `list_decisions` / `list_evidence` | `jobs:read` | any | Read a job's timeline / decisions / evidence. |
|
|
66
68
|
|
|
67
|
-
\* Subject to plan limits (active-job cap,
|
|
69
|
+
\* Subject to plan limits (active-job cap, tags gating). When a call
|
|
68
70
|
exceeds a plan gate or quota the tool returns an error whose text includes an
|
|
69
71
|
`Upgrade: <url>` hint you can relay to the user.
|
|
70
72
|
|
package/dist/index.js
CHANGED
|
@@ -46,7 +46,7 @@ async function api(path, init) {
|
|
|
46
46
|
headers: {
|
|
47
47
|
Authorization: `Bearer ${TOKEN}`,
|
|
48
48
|
"Content-Type": "application/json",
|
|
49
|
-
"User-Agent": "qodflow-mcp/0.1.
|
|
49
|
+
"User-Agent": "qodflow-mcp/0.1.3",
|
|
50
50
|
...(init?.headers ?? {}),
|
|
51
51
|
},
|
|
52
52
|
});
|
|
@@ -144,7 +144,7 @@ const ResolveDecisionArgs = z.object({
|
|
|
144
144
|
humanResponseExcerpt: z.string().min(1).max(280),
|
|
145
145
|
});
|
|
146
146
|
// Server setup
|
|
147
|
-
const server = new Server({ name: "qodflow", version: "0.1.
|
|
147
|
+
const server = new Server({ name: "qodflow", version: "0.1.3" }, { capabilities: { tools: {} } });
|
|
148
148
|
// Tool annotations per MCP spec (2025-06-18) — clients use these to decide
|
|
149
149
|
// whether to prompt the user before calling. We pin them static here so a
|
|
150
150
|
// hijacked server cannot rug-pull descriptions (Invariant Labs Apr 2025).
|
|
@@ -192,7 +192,7 @@ const TOOLS = [
|
|
|
192
192
|
},
|
|
193
193
|
{
|
|
194
194
|
name: "update_job",
|
|
195
|
-
description: "Update a job's title, description, priority, or PO number. To move a job between stages use move_job; to assign it use assign_job. Requires jobs:write.",
|
|
195
|
+
description: "Update a job's title, description, priority, or PO number. To move a job between stages use move_job; to assign it use assign_job. Completed jobs are read-only: move_job it to an earlier stage first (the server returns 409 JOB_COMPLETED otherwise). Requires jobs:write.",
|
|
196
196
|
annotations: WRITE_IDEMPOTENT, inputSchema: {
|
|
197
197
|
type: "object",
|
|
198
198
|
required: ["id"],
|
|
@@ -215,13 +215,17 @@ const TOOLS = [
|
|
|
215
215
|
properties: {
|
|
216
216
|
jobId: { type: "string" },
|
|
217
217
|
stageId: { type: "string" },
|
|
218
|
-
reason: {
|
|
218
|
+
reason: {
|
|
219
|
+
type: "string",
|
|
220
|
+
maxLength: 200,
|
|
221
|
+
description: "Optional short note on why the job moved; kept on the team's activity record.",
|
|
222
|
+
},
|
|
219
223
|
},
|
|
220
224
|
},
|
|
221
225
|
},
|
|
222
226
|
{
|
|
223
227
|
name: "assign_job",
|
|
224
|
-
description: "Assign a job to a team member, or pass assignedToId:null to unassign. Use list_members to get member IDs. Requires the mcp:assign scope
|
|
228
|
+
description: "Assign a job to a team member, or pass assignedToId:null to unassign. Use list_members to get member IDs. Completed jobs are read-only: move_job it to an earlier stage first (the server returns 409 JOB_COMPLETED otherwise). Requires the mcp:assign scope. Available on every plan.",
|
|
225
229
|
annotations: WRITE_IDEMPOTENT,
|
|
226
230
|
inputSchema: {
|
|
227
231
|
type: "object",
|
|
@@ -359,7 +363,7 @@ const TOOLS = [
|
|
|
359
363
|
},
|
|
360
364
|
{
|
|
361
365
|
name: "list_evidence",
|
|
362
|
-
description: "List evidence attached to a job. Requires jobs:read.",
|
|
366
|
+
description: "List evidence attached to a job. PREMIUM-plan only. Requires jobs:read.",
|
|
363
367
|
annotations: READ_ONLY, inputSchema: { type: "object", required: ["jobId"], properties: { jobId: { type: "string" } } },
|
|
364
368
|
},
|
|
365
369
|
{
|
package/package.json
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "qodflow-mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.3",
|
|
4
|
+
"mcpName": "com.qodflow/qodflow-mcp",
|
|
4
5
|
"description": "Model Context Protocol server for QodFlow. Lets AI agents (Claude Desktop, Cursor, ChatGPT Desktop) drive a QodFlow workspace through Personal Access Tokens.",
|
|
5
6
|
"type": "module",
|
|
6
7
|
"bin": {
|
|
7
|
-
"qodflow-mcp": "
|
|
8
|
+
"qodflow-mcp": "dist/index.js"
|
|
8
9
|
},
|
|
9
10
|
"files": [
|
|
10
11
|
"dist",
|
|
@@ -21,7 +22,7 @@
|
|
|
21
22
|
},
|
|
22
23
|
"//security": "E48 supply-chain hardening: deps pinned to exact versions (no caret). No postinstall script. CI must run `npm ci --ignore-scripts`. Update by editing manually + reviewing the diff in PR — never `npm update` or `dependabot auto-merge`.",
|
|
23
24
|
"dependencies": {
|
|
24
|
-
"@modelcontextprotocol/sdk": "1.
|
|
25
|
+
"@modelcontextprotocol/sdk": "1.32.1",
|
|
25
26
|
"zod": "3.23.8"
|
|
26
27
|
},
|
|
27
28
|
"devDependencies": {
|
|
@@ -29,5 +30,23 @@
|
|
|
29
30
|
"tsx": "4.23.15",
|
|
30
31
|
"typescript": "5.7.2"
|
|
31
32
|
},
|
|
33
|
+
"homepage": "https://www.qodflow.com/docs/mcp",
|
|
34
|
+
"repository": {
|
|
35
|
+
"type": "git",
|
|
36
|
+
"url": "git+https://github.com/qodflow/qodflow-mcp.git"
|
|
37
|
+
},
|
|
38
|
+
"bugs": {
|
|
39
|
+
"url": "https://github.com/qodflow/qodflow-mcp/issues"
|
|
40
|
+
},
|
|
41
|
+
"keywords": [
|
|
42
|
+
"mcp",
|
|
43
|
+
"model-context-protocol",
|
|
44
|
+
"kanban",
|
|
45
|
+
"ai-agents",
|
|
46
|
+
"claude-code",
|
|
47
|
+
"cursor",
|
|
48
|
+
"job-tracking",
|
|
49
|
+
"sla"
|
|
50
|
+
],
|
|
32
51
|
"license": "MIT"
|
|
33
52
|
}
|